Selamat datang di Pusat Developer Google Home, tempat baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.

Halaman ini diterjemahkan oleh Cloud Translation API.

Paket Pengujian Google Home

Google Home Test Suite adalah aplikasi web yang memungkinkan Anda untuk menguji mandiri Action smart home Anda. Test Suite otomatis membuat dan menjalankan kasus pengujian berdasarkan perangkat dan karakteristik yang terkait dengan akun Anda. Setelah menyelesaikan pengujian, Anda dapat melihat pengujian hasil pengujian atau isi formulir pengiriman untuk mengirimkan hasil pengujian ke Google.

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

Memeriksa apakah Report State dan Permintaan Sinkronisasi diterapkan untuk perangkat dan karakteristik.
Memverifikasi bahwa intent QUERY diterapkan untuk perangkat Anda dan hasilnya cocok dengan hasil Status Laporan.

Anda dapat meluncurkan alat Test Suite dengan mengklik tombol tersebut 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 kirimkan perintah langsung ke Google Assistant.

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

Di browser web, buka Test Suite
Login ke Google menggunakan tombol di pojok kanan atas.

Penting: Pastikan Anda login dengan akun yang terkait dengan project Action smart home yang ingin Anda uji.
Konfigurasikan Project Details:
1. Di kolom Project ID, masukkan ID project untuk Action smart home.
2. Klik Berikutnya.
Konfigurasikan Setelan Pengujian:
1. Jika Anda menyertifikasi Action smart home, biarkan default Nilai Report State/Request Sync Timeout tidak berubah. Namun, untuk pengujian, Anda dapat mengubah nilai waktu tunggu jika agen Anda membutuhkan status laporan ke Home Graph.
2. Jika Anda mendapatkan sertifikasi untuk Action smart home, pastikan Permintaan Pengujian Sinkronisasi diaktifkan—selama pengujian, Anda akan diminta untuk menambahkan, memperbarui, atau menghapus perangkat dan memeriksa apakah daftar perangkat telah berubah di Home Graph. Tindakan perubahan terjadi melalui integrasi Anda pengujian. Integrasi yang sedang diuji harus selalu memiliki setidaknya satu perangkat yang dilampirkan ke pengguna agen.
  
  Peringatan: Saat menghapus perangkat, pastikan Anda melakukannya dari aplikasi pihak ketiga (bukan dari Google Home app (GHA)). Jangan hapus jika hanya ada satu perangkat di aplikasi Anda yang tertaut dengan akun, karena hal ini akan menyebabkan error sinkronisasi.
3. Jika Anda menggunakan trait Scene, pilih Menguji karakteristik Scene.
  
  Catatan: Jika Anda ingin menguji ciri dengan verifikasi pengguna sekunder, pilih opsi Aktifkan Verifikasi Pengguna Sekunder di menu Pengujian Setelan. Jika setelan ini diaktifkan, aplikasi pengujian akan meminta Anda jika perangkat merespons dengan tantangan selama pengujian. Opsi ini hanya untuk membantu Anda menyelesaikan ujian mandiri. Perangkat yang menggunakan Pengguna Sekunder Verifikasi tetap harus dikirim ke Google untuk verifikasi manual.
4. Jika Anda menjalankan rangkaian 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.
Lakukan Test Run dan lihat hasilnya:
1. Klik Berikutnya untuk mulai menjalankan pengujian. Antarmuka menunjukkan perangkat dan sifat yang sedang diuji.
Lihat Hasil & Halaman pengiriman:
1. Setelah pengujian selesai, klik Berikutnya untuk melihat hasilnya.

Hasil tes mencakup jumlah tes yang lulus dan gagal, dan skor yang menunjukkan persentase penerusan.

Pengujian validasi penautan akun

Penautan akun memainkan peran penting dalam ekosistem smart home Google. Penautan akun pengujian validasi di Test Suite akan memeriksa layanan OAuth Anda 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 pertukaran token diuji untuk memastikan memiliki format yang valid dan menampilkan 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 dengan benar menukarnya dengan token akses baru.

Item Pengujian	Penjelasan
Token refresh dengan token refresh yang tidak valid, memeriksa respons partner.	Server Anda akan menampilkan {i>error<i} 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. Kunjungi tukar token refresh dengan token akses untuk mendapatkan informasi selengkapnya.
Uji apakah token akses telah diperbarui setelah token dimuat ulang.	Token akses baru harus ditampilkan sebagai respons terhadap token refresh permintaan. 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 pembaruan berubah, server Anda hanya boleh membatalkan validasi pembaruan 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 ini mencantumkan beberapa pesan {i>error<i} umum yang mungkin Anda temui dan cara yang disarankan untuk menyelesaikannya.

Pesan Error Cara Menyelesaikan

HomeGraph API belum digunakan dalam project <_id_> sebelum atau sudah nonaktif Pastikan Anda telah mengaktifkan HomeGraph API.

Entitas yang Diminta tidak ditemukan Pastikan agentUserId Anda valid dan ditautkan ke layanan.

Pesan Error	Cara Menyelesaikan
HomeGraph API belum digunakan dalam project <_id_> sebelum atau sudah nonaktif	Pastikan Anda telah mengaktifkan HomeGraph API.
Entitas yang Diminta tidak ditemukan	Pastikan `agentUserId` Anda valid dan ditautkan ke layanan.
Pastikan Anda memiliki izin `resourcemanager.projects.get` pada project `${your project id}` dan telah memberikan izin pada layar persetujuan. Terjadi error saat mengambil data modul: error getModuleData: Respons kegagalan HTTP untuk https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403	Ikuti petunjuk di Memecahkan masalah Izin IAM untuk memastikan akun Anda memiliki `resourcemanager.projects.get` untuk project. Buka halaman Aplikasi yang memiliki akses ke akun Anda untuk memeriksa izin berikut untuk "Rangkaian pengujian untuk smart home": Info akun dasar Melihat alamat email Akun Google utama Anda Melihat info pribadi Anda, termasuk info pribadi yang Anda miliki disediakan untuk publik Akses tambahan Gunakan Assistant Anda: akses luas ke akun Google Anda Memeriksa dan mengontrol perangkat smart home di Rumah Anda Grafik Jika Anda mengalami error izin, hapus akses terlebih dahulu dan berikan semua izin pada layar persetujuan saat Anda {i>login<i} lagi.

Pastikan Anda memiliki izin resourcemanager.projects.get pada project ${your project id} dan telah memberikan izin pada layar persetujuan.

Terjadi error saat mengambil data modul: error getModuleData: Respons kegagalan HTTP untuk https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403

Ikuti petunjuk di Memecahkan masalah Izin IAM untuk memastikan akun Anda memiliki resourcemanager.projects.get untuk project.
Buka halaman Aplikasi yang memiliki akses ke akun Anda untuk memeriksa izin berikut untuk "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 miliki disediakan untuk publik
- Akses tambahan
  1. Gunakan Assistant Anda: akses luas ke akun Google Anda
  2. Memeriksa dan mengontrol perangkat smart home di Rumah Anda Grafik
Jika Anda mengalami error izin, hapus akses terlebih dahulu dan berikan semua izin pada layar persetujuan saat Anda {i>login<i} lagi.

Mengirimkan hasil pengujian

Hasil Test Suite Anda harus lulus 100% pengujian sebelum dengan mengirimkan formulir sertifikasi. Jika Anda memiliki sifat 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 Action smart home, ikuti langkah-langkah berikut:

Setelah Anda menerima hasil pengujian dan Anda siap untuk menyertifikasi kecerdasan Anda Action home, klik Submit di alat Test Suite.
Klik tombol DOWNLOAD TEST RESULTS untuk mengambil hasil pengujian Anda.
Klik BUKA FORMULIR PENGIRIMAN untuk mengirimkan hasil pengujian ke Google.
Lengkapi semua kolom wajib diisi, lalu klik Kirim.

Catatan: Hasil pengujian yang Anda kirimkan harus menyertakan pengujian Meminta Sinkronisasi hasil pengujian tersebut. Setelah mengirimkan hasil pengujian ke Google, Anda harus mengirimkan Action smart home untuk peninjauan.