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 karakteristik yang terkait dengan akun Anda. Setelah menyelesaikan pengujian, Anda dapat melihat hasil pengujian.
Untuk menggunakan Test Suite dan mengirimkan hasil pengujian Anda ke Google untuk mendapatkan sertifikasi, lihat halaman Menguji dan membagikan Action smart home untuk mengetahui informasinya. Versi Test Suite ini khusus untuk pengembangan dan jaminan kualitas.
Pengujian yang dijalankan oleh Test Suite mencakup, tetapi tidak terbatas pada, hal berikut:
Memeriksa apakah Status Laporan dan Sinkronisasi Permintaan diterapkan untuk perangkat dan karakteristik Anda.
Memverifikasi bahwa intent QUERY diimplementasikan untuk perangkat Anda dan hasilnya cocok dengan hasil Status Laporan.
Anda dapat meluncurkan alat Test Suite dengan mengklik tombol di bawah:
Menguji Action Anda sendiri
Bagian berikut menjelaskan cara menjalankan Test Suite di perangkat dan project Action smart home Anda. Test Suite memerlukan Anda untuk login agar dapat memeriksa perangkat di Google Home Graph dan mengirim perintah langsung ke Google Assistant.
Untuk menguji Action Anda sendiri, 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 rumah pintar Anda.
- Klik Berikutnya.
Konfigurasikan Setelan Pengujian:
- Jika mensertifikasi integrasi Cloud-to-cloud, 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 melakukan sertifikasi integrasi Cloud-to-cloud, 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 sedang Anda uji. Integrasi yang sedang diuji harus selalu memiliki setidaknya satu perangkat yang terpasang ke pengguna agen.
Jika Anda menggunakan karakteristik Scene, pilih Karakteristik Scene Pengujian.
Jika Anda menjalankan rangkaian pengujian untuk perangkat Local Home, pilih Mendukung Local Home SDK.
- Pilih Pengiriman Lokal atau Penyiapan Lancar.
- Klik Mendukung Kueri Lokal jika perangkat dapat menangani intent QUERY secara lokal.
Lakukan Pengujian Lari dan lihat hasilnya:
- Klik Berikutnya untuk mulai menjalankan pengujian. Antarmuka menampilkan perangkat dan karakteristik 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 memainkan peran 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:
Pengujian validasi token akses
Token akses yang ditampilkan dari endpoint pertukaran token Anda diuji untuk memastikan token tersebut memiliki format yang valid dan ditampilkan dengan token refresh yang valid.
Item Pengujian | Penjelasan |
---|---|
Memeriksa apakah token akses berformat JWT | Penautan akun Google tidak merekomendasikan token akses berformat 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 berakhir masa berlakunya memiliki token refresh. | Token refresh harus diberikan jika masa berlaku token akses habis. Pengujian ini akan gagal jika tidak ada token refresh yang ditemukan. |
Pengujian validasi token refresh
Token refresh diuji untuk memastikan endpoint pertukaran token Anda menukarnya dengan token akses baru dengan benar.
Item Pengujian | Penjelasan |
---|---|
Token refresh dengan token refresh yang 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. Buka
menukarkan token refresh dengan token akses untuk mengetahui informasi selengkapnya. |
Uji apakah token akses telah diperbarui setelah token dimuat ulang. | 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 belum habis masa berlakunya masih valid. | Waktu habis masa berlaku token akses akan ditampilkan. |
Periksa apakah token refresh telah dirotasi selama pemuatan 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 perlombaan yang dapat merusak penautan akun pengguna. Pengujian akan gagal jika Anda membatalkan token refresh lama sebelum token baru digunakan. |
Pesan error
Tabel berikut mencantumkan beberapa pesan error umum yang mungkin Anda temui dan cara yang disarankan untuk mengatasinya.
Pesan Error | Cara Menyelesaikan |
---|---|
HomeGraph API belum pernah digunakan di project <_id_> sebelumnya atau dinonaktifkan | Pastikan Anda telah mengaktifkan HomeGraph API. |
Entitas yang Diminta tidak ditemukan | Pastikan agentUserId Anda valid dan ditautkan ke
layanan Anda. |
Pastikan Anda memiliki izin Error saat mendapatkan data modul: error getModuleData: 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. 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 memberikan sertifikasi integrasi Cloud-to-cloud, ikuti langkah-langkah berikut:
- Setelah menerima hasil pengujian dan siap untuk memberikan sertifikasi pada integrasi Cloud-to-cloud, klik Kirim di alat Test Suite.
- Klik tombol DOWNLOAD TEST RESULTS untuk mengambil hasil pengujian Anda.
- Klik BUKTIKAN KE GOOGLE untuk mengirimkan hasil pengujian ke Google.
Isi semua kolom yang wajib diisi, lalu klik Kirim.