Paket Pengujian Google Home

Cloud-to-cloud    Local Home SDK

Google Home Test Suite adalah aplikasi web yang memungkinkan Anda menguji sendiri Action smart home. Test Suite akan 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 tersebut ke Google.

Pengujian yang dijalankan oleh Test Suite mencakup, tetapi tidak terbatas pada, hal berikut:

  • Memastikan Report State dan Request Sync 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 ini:

Luncurkan Test Suite

Menguji Action Anda secara mandiri

Bagian berikut menjelaskan cara menjalankan Test Suite di perangkat dan project Action smart home. Test Suite mengharuskan Anda login agar dapat memeriksa perangkat di Google Home Graph dan mengirim perintah langsung ke Google Assistant.

Untuk menguji Action Anda secara mandiri, ikuti langkah-langkah berikut:

  1. Di browser web, buka Test Suite.

  2. Login ke Google menggunakan tombol di pojok kanan atas.

  3. Konfigurasikan Project Details:

    1. Di kolom Project ID, masukkan project ID untuk Action smart home Anda.
    2. Klik Next.

  4. Konfigurasikan Setelan Pengujian:

    1. Jika Anda menyertifikasi Action smart home, jangan ubah nilai default Report State/Request Sync Timeout. Namun, untuk pengujian, Anda dapat mengubah nilai waktu tunggu jika agen memerlukan lebih banyak waktu untuk melaporkan status ke Home Graph.

    2. Jika menyertifikasi Action smart home, pastikan opsi Sinkronisasi Permintaan Pengujian diaktifkan. Selama pengujian, Anda akan diminta untuk menambahkan, mengupdate, atau menghapus perangkat dan memeriksa apakah daftar perangkat telah berubah di Home Graph. Tindakan perubahan terjadi melalui integrasi yang Anda uji. Integrasi Anda yang sedang diuji harus selalu memiliki setidaknya satu perangkat yang terpasang ke pengguna agen.

    3. Jika Anda menggunakan fitur Scene, pilih Uji karakteristik Scene.

    4. Jika Anda menjalankan paket pengujian untuk perangkat Local Home, pilih Mendukung Local Home SDK.

      1. Pilih Local Fulfillment atau Penyiapan yang Mudah.
      2. Klik Mendukung Kueri Lokal jika perangkat dapat menangani intent QUERY secara lokal.

  5. Lakukan Test Run dan lihat hasilnya:

    1. Klik Berikutnya untuk mulai menjalankan pengujian. Antarmuka menunjukkan perangkat dan fitur yang sedang diuji.

  6. Lihat halaman Hasil & Pengiriman:

    1. 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 memainkan peran penting dalam ekosistem smart home Google. Pengujian validasi penautan akun di Test Suite memeriksa layanan OAuth Anda untuk menemukan kemungkinan masalah.

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 formatnya valid dan ditampilkan dengan token refresh yang valid.

Item Pengujian Penjelasan
Periksa apakah token akses memiliki format 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 dapat habis masa berlakunya memiliki token refresh. Token refresh harus diberikan jika token akses dapat habis masa berlakunya. Pengujian ini akan gagal jika token refresh tidak ditemukan.

Muat ulang uji validasi token

Token refresh diuji untuk memastikan endpoint pertukaran token Anda menukarnya dengan benar dengan token akses baru.

Item Pengujian Penjelasan
Token refresh dengan token refresh yang tidak valid, memeriksa respons partner. Server Anda harus menampilkan error HTTP 400 Bad Request 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 menukar 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 menyediakan 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 race 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 menyelesaikannya.

Pesan Error Cara Menyelesaikan
HomeGraph API belum pernah digunakan dalam project <_id_> sebelumnya 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 resourcemanager.projects.get di project ${your project id} dan telah memberikan semua izin di layar izin.

Terjadi error saat mendapatkan data modul: getModuleData error: Respons kegagalan HTTP untuk https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403
  1. Ikuti petunjuk di Memecahkan masalah izin IAM untuk memastikan akun Anda memiliki izin resourcemanager.projects.get untuk project tersebut.
  2. Buka halaman Aplikasi yang memiliki akses ke akun Anda untuk memeriksa izin berikut pada "Rangkaian pengujian untuk smart home":
    • Info akun dasar
      1. Melihat alamat email Akun Google utama Anda
      2. Melihat info pribadi Anda, termasuk info pribadi yang Anda atur agar tersedia untuk publik
    • Akses tambahan
      1. Menggunakan Assistant: akses luas ke Akun Google Anda
      2. Memeriksa dan mengontrol perangkat smart home di Home Graph Anda
    Jika terjadi error izin, hapus akses terlebih dahulu dan berikan semua izin di layar izin saat Anda login lagi.

Mengirimkan hasil pengujian

Hasil Test Suite Anda harus lulus 100% pengujian sebelum mengirimkan formulir sertifikasi. Jika memiliki ciri yang memerlukan pengujian manual, Anda tetap harus menjalankan alat Test Suite dan melampirkan hasilnya meskipun belum lulus 100%.

Untuk mengirimkan hasil pengujian dan mendapatkan sertifikasi untuk Action smart home, ikuti langkah-langkah berikut:

  1. Setelah menerima hasil pengujian dan siap untuk menyertifikasi Action smart home, klik Submit di alat Test Suite.
  2. Klik tombol DOWNLOAD TEST RESULTS untuk mengambil hasil pengujian Anda.
  3. Klik BUKA FORMULIR PENGIRIMAN untuk mengirimkan hasil pengujian ke Google.

  4. Lengkapi semua kolom wajib diisi, lalu klik Kirim.