Google Home Test Suite adalah aplikasi web yang memungkinkan Anda menguji sendiri Action smart home. Test Suite otomatis membuat dan menjalankan kasus pengujian berdasarkan perangkat dan fitur yang terkait dengan akun Anda. Setelah menyelesaikan pengujian, Anda dapat melihat hasil pengujian atau mengisi formulir pengiriman untuk mengirimkan hasil pengujian ke Google.
Pengujian yang dijalankan oleh Test Suite mencakup, tetapi tidak terbatas pada, hal-hal berikut:
Memeriksa apakah Status Laporan dan Permintaan Sinkronisasi diterapkan untuk perangkat dan karakteristik Anda.
Memverifikasi bahwa intent QUERY telah diterapkan untuk perangkat Anda dan hasilnya sesuai dengan hasil Status Laporan.
Anda dapat meluncurkan alat Test Suite dengan mengklik tombol di bawah ini:
Menguji sendiri Action Anda
Bagian berikut menjelaskan cara menjalankan Test Suite di project Action smart home dan perangkat Anda. Test Suite mengharuskan Anda login agar dapat memeriksa perangkat di Google Home Graph dan mengirimkan perintah langsung ke Google Assistant.
Untuk menguji sendiri Action Anda, ikuti langkah-langkah berikut:
- Di browser web, buka Test Suite.
Login ke Google menggunakan tombol di pojok kanan atas.
Konfigurasikan Project Details:
- Di kolom Project ID, masukkan ID project untuk Action smart home Anda.
- Klik Next.
Konfigurasikan Setelan Pengujian:
- Jika menyertifikasi Action smart home Anda, biarkan nilai default Report State/Request Sync Timeout tidak berubah. Namun, untuk pengujian, Anda dapat mengubah nilai waktu tunggu jika agen memerlukan lebih banyak waktu untuk melaporkan status ke Home Graph.
Jika mensertifikasi Action smart home Anda, pastikan opsi Test Request Sync diaktifkan—selama pengujian, Anda akan diminta untuk menambahkan, mengupdate, atau menghapus perangkat dan memeriksa apakah daftar perangkat telah berubah di Home Graph. Tindakan perubahan dilakukan melalui integrasi yang Anda uji. Integrasi Anda yang sedang diuji harus selalu memiliki setidaknya satu perangkat yang terpasang pada pengguna agen.
Jika Anda menggunakan fitur Scene, pilih Test Scene trait.
Jalankan Test Run dan lihat hasilnya:
- Klik Berikutnya untuk mulai menjalankan pengujian. Antarmuka ini menunjukkan perangkat dan fitur yang sedang diuji.
Lihat halaman Hasil & Pengiriman:
- Setelah pengujian selesai, klik Berikutnya untuk melihat hasilnya.
Hasil pengujian mencakup jumlah pengujian yang lulus dan gagal, serta skor akhir yang menunjukkan persentase lulus.
Pengujian validasi penautan akun
Penautan akun berperan penting dalam ekosistem smart home Google. Pengujian validasi penautan akun di Test Suite akan memeriksa potensi masalah pada layanan OAuth Anda.
Pengujian validasi penautan akun berisi pengujian untuk memvalidasi token akses dan token refresh:
Uji validasi token akses
Token akses yang ditampilkan dari endpoint pertukaran token diuji untuk memastikan token tersebut memiliki format yang valid dan ditampilkan dengan token refresh yang valid.
Uji Item | Penjelasan |
---|---|
Memeriksa apakah token akses berformat JWT | Penautan akun Google tidak merekomendasikan token akses format JWT. Jika
format JWT ditemukan, peringatan berikut akan ditampilkan:
The access token seems to be JWT, this is not good. Because it
unnecessarily exposes information about partner implementation and we
recommend opaque symmetric encrypted access token.
|
Pastikan token akses yang telah habis masa berlakunya memiliki token refresh. | Token refresh harus diberikan saat token akses akan habis masa berlakunya. Pengujian ini akan gagal jika token refresh tidak ditemukan. |
Muat ulang uji validasi token
Token refresh diuji untuk memastikan endpoint bursa token menukarnya dengan benar dengan token akses baru.
Uji Item | Penjelasan |
---|---|
Token refresh dengan token refresh yang tidak valid, memeriksa respons partner. | Server Anda harus menampilkan error Permintaan HTTP 400 yang Buruk dengan
{"error": "invalid_grant"} ke permintaan token refresh yang tidak valid.
Jika respons tidak cocok dengan "kode error atau pesan", kasus pengujian
ini akan gagal. Buka
token refresh pertukaran untuk token akses untuk informasi selengkapnya. |
Uji apakah token akses telah diperbarui setelah token diperbarui. | Token akses baru harus ditampilkan sebagai respons terhadap permintaan token refresh. Jika server Anda menyediakan token akses yang sama, kasus pengujian akan gagal. |
Periksa apakah token akses yang masih berlaku masih valid. | Waktu habis masa berlaku token akses akan ditampilkan. |
Periksa apakah token refresh telah dirotasi selama dimuat ulang. | Kami memeriksa apakah token refresh diubah setelah permintaan token refresh. Jika token refresh berubah, server Anda hanya boleh membatalkan token refresh lama setelah token refresh baru digunakan, untuk mencegah kondisi race yang dapat merusak penautan akun pengguna. Pengujian akan gagal jika Anda membatalkan token refresh lama sebelum yang baru digunakan. |
Pesan error
Tabel berikut berisi beberapa pesan error umum yang mungkin Anda temukan dan cara yang disarankan untuk mengatasinya.
Pesan Error | Cara Menyelesaikan |
---|---|
HomeGraph API belum pernah digunakan dalam project <_id_> sebelum atau dinonaktifkan | Pastikan Anda telah mengaktifkan HomeGraph API. |
Entitas yang Diminta tidak ditemukan | Periksa apakah agentUserId Anda valid dan ditautkan ke layanan Anda. |
Pastikan Anda memiliki izin resourcemanager.projects.get
pada project ${your project id} dan telah memberikan semua
izin di layar izin. |
|
Mengirim hasil pengujian
Hasil Test Suite Anda harus lulus 100% pengujian sebelum mengirimkan formulir sertifikasi. Jika memiliki karakteristik yang memerlukan pengujian manual, Anda tetap harus menjalankan alat Test Suite dan melampirkan hasilnya meskipun belum lulus 100%.
Untuk mengirimkan hasil pengujian dan mensertifikasi Action smart home Anda, ikuti langkah-langkah berikut:
- Setelah menerima hasil pengujian dan Anda siap melakukan sertifikasi untuk Action smart home, klik Submit di alat Test Suite.
- Klik tombol DOWNLOAD HASIL UJI COBA untuk mengambil hasil pengujian Anda.
- Klik BUKA FORMULIR PENGIRIMAN untuk mengirimkan hasil pengujian ke Google.
Isi semua kolom yang wajib diisi, lalu klik Kirim.