Google Home Test Suite is a web application that allows you to self-test your smart home Action. The Test Suite automatically generates and runs test cases based on the devices and traits associated with your account. When you complete the tests, you can view the test results or fill in the submission form to submit the test results to Google.
Pengujian yang dijalankan oleh Test Suite mencakup, tetapi tidak terbatas pada, hal-hal berikut:
Memeriksa apakah Status Laporan dan Sinkronisasi Permintaan diimplementasikan untuk perangkat dan fitur Anda.
Memverifikasi bahwa intent QUERY diterapkan untuk perangkat Anda dan hasilnya cocok dengan hasil Status Laporan.
Anda dapat meluncurkan alat Test Suite dengan mengklik tombol di bawah ini:
Uji sendiri Action Anda
Bagian berikut menjelaskan cara menjalankan Test Suite di perangkat Anda dan project Action smart home. Test Suite mengharuskan Anda login agar dapat memeriksa perangkat di Google Home Graph and send commands directly to Google Assistant .
Untuk menguji Action Anda sendiri, ikuti langkah-langkah berikut:
- Di browser web, buka Test Suite.
Login ke Google menggunakan tombol pojok kanan atas.
Konfigurasikan Project Details:
- Di kolom Project ID, masukkan ID project untuk Action smart home Anda.
- Klik Next.
Konfigurasikan Setelan Pengujian:
- Jika mensertifikasi Action smart home, jangan ubah nilai Report State/Request Sync Timeout default. 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, pastikan opsi Test Request Sync diaktifkan—selama pengujian, Anda akan diminta untuk menambahkan, memperbarui, 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 melampirkan setidaknya satu perangkat ke pengguna agen.
Jika Anda menggunakan fitur Scene, pilih Test Scene trait.
Jika Anda menjalankan rangkaian pengujian untuk perangkat Local Home, pilih Support Local Home SDK.
- Pilih Fulfillment Lokal atau Penyiapan yang Mudah.
- Klik Support Local Query jika perangkat dapat menangani intent QUERY secara lokal.
Lakukan Test Run dan lihat hasilnya:
- Klik Berikutnya untuk mulai menjalankan pengujian. Antarmuka menunjukkan perangkat dan sifat 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 kelulusan.
Pengujian validasi penautan akun
Penautan akun berperan penting dalam ekosistem smart home Google. Pengujian validasi penautan akun di Test Suite memeriksa layanan OAuth Anda untuk menemukan potensi masalah.
Pengujian validasi penautan akun berisi pengujian untuk memvalidasi token akses dan token refresh:
Uji validasi token akses
Token akses yang ditampilkan dari endpoint bursa token Anda diuji untuk memastikan token tersebut memiliki format yang valid dan ditampilkan dengan token refresh yang valid.
Menguji 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.
|
Periksa apakah token akses yang dapat diperpanjang memiliki token refresh. | Token refresh harus diberikan saat masa berlaku token akses berakhir. Pengujian ini akan gagal jika token refresh tidak ditemukan. |
Pengujian validasi token refresh
Token refresh diuji untuk memastikan endpoint pertukaran token Anda menukarnya dengan benar dengan token akses baru.
Menguji Item | Penjelasan |
---|---|
Token refresh dengan token refresh tidak valid, memeriksa respons partner. | Server Anda harus menampilkan error Permintaan Buruk HTTP 400 dengan
{"error": "invalid_grant"} ke permintaan token refresh yang tidak valid.
Jika respons tidak cocok dengan "kode atau pesan error", kasus pengujian ini akan gagal. Kunjungi
token refresh bursa untuk token akses untuk mengetahui informasi lebih lanjut. |
Uji apakah token akses telah diperbarui setelah token diperbarui. | Token akses baru harus ditampilkan sebagai respons terhadap permintaan token refresh. Jika server Anda memberikan token akses yang sama, kasus pengujian akan gagal. |
Periksa apakah token akses yang masih berlaku masih valid. | Waktu berakhirnya token akses akan ditampilkan. |
Periksa apakah token refresh telah dirotasi selama refresh. | 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 mungkin merusak penautan akun pengguna. Pengujian akan gagal jika Anda membatalkan token refresh lama sebelum yang baru digunakan. |
Pesan error
Tabel berikut mencantumkan beberapa pesan error umum yang mungkin Anda alami dan cara yang disarankan untuk mengatasinya.
Pesan Error | Cara Menyelesaikan |
---|---|
HomeGraph API belum pernah digunakan dalam project <_id_> atau dinonaktifkan | Pastikan Anda telah mengaktifkan HomeGraph API. |
Entitas yang diminta tidak ditemukan | Pastikan agentUserId valid dan ditautkan ke layanan Anda. |
Pastikan Anda memiliki izin Error saat mendapatkan data modul: getModuleData error: Respons kegagalan Http untuk https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
Mengirim hasil pengujian
Hasil Test Suite Anda harus lulus 100% pengujian sebelum mengirimkan formulir sertifikasi Anda. Jika memiliki karakteristik yang memerlukan pengujian manual, Anda tetap harus menjalankan alat Test Suite dan melampirkan hasilnya meskipun belum lulus pada 100%.
Untuk mengirim hasil pengujian dan mensertifikasi Action smart home Anda, ikuti langkah-langkah berikut:
- Setelah Anda menerima hasil pengujian dan siap menyatakan Action smart home, klik Kirim di alat Test Suite.
- Klik tombol DOWNLOAD PENGUJIAN HASIL untuk mengambil hasil pengujian Anda.
- Klik BUKA FORMULIR PENGIRIMAN untuk mengirimkan hasil pengujian ke Google.
Isi semua kolom yang wajib diisi, lalu klik Kirim.