Sebelum merilis Action kepada pengguna, Anda harus mengujinya secara menyeluruh, menentukan platform, lokasi, dan perangkat target, serta memverifikasi bahwa Action tersebut mematuhi kebijakan Google untuk Actions. Halaman ini menyediakan ringkasan tugas yang harus Anda lakukan saat bersiap mengirimkan Action untuk ditinjau, guna mendapatkan persetujuan untuk merilisnya ke saluran Beta atau Produksi.
Memeriksa pelanggaran kebijakan
Verifikasi bahwa Action Anda mengikuti kebijakan untuk Actions on Google. Secara umum, ikuti pedoman ini untuk konten Anda:
- Harus spesifik: Pengguna harus dapat memanggil Action Anda secara khusus. Jangan terlalu luas atau umum saat memilih nama tampilan atau pengucapan. Misalnya, gunakan "Bicara dengan WeatherApp untuk memeriksa cuaca di [city]", bukan "Check the weather for [city]" sebagai frasa Tindakan. Ikuti panduan untuk memberikan frasa Action yang baik.
- Menghindari konten terlarang: Kecuali jika memiliki tujuan ilmiah, artistik, dokumenter, atau pendidikan, Action dengan konten seksual, kekerasan, ilegal, atau yang menyebarkan kebencian secara eksplisit melanggar kebijakan untuk Actions on Google. Tindakan yang mendorong penindasan atau pelecehan juga akan ditolak atau dihapus.
- Hormati hak cipta dan kekayaan intelektual: Pastikan Anda memiliki hak yang memadai untuk menggunakan konten yang ditawarkan oleh Action Anda.
- Bersikaplah jujur: Jangan menyesatkan atau menipu pengguna dengan klaim palsu.
- Melindungi privasi dan keamanan pengguna: Bersikaplah transparan dalam cara Anda menangani data pengguna, transmisikan data pengguna dengan aman, dan berikan kebijakan privasi.
- Jangan memproses permintaan pengguna: Pengguna harus memahami saat Action Anda menunggu input mereka. Membiarkan mikrofon terbuka tanpa memberi tahu pengguna adalah kesalahan umum yang dijelaskan dalam kebijakan kami. Pastikan Action Anda memberi tahu pengguna saat menunggu perintah untuk mengurangi risiko Action Anda ditolak.
- Tinjau nama tampilan dan pemanggilan Anda: Pastikan nama panggilan Anda konsisten dengan nama tampilan, yang muncul di halaman direktori Asisten. Pastikan kedua nama cukup spesifik sehingga pengguna dapat dengan mudah memanggil Action Anda. Nama panggilan dan tampilan Anda juga harus mengikuti kebijakan untuk Actions on Google.
Periksa daftar lengkap kebijakan dan pastikan Anda mematuhinya untuk mempercepat peninjauan dan persetujuan Action.
Menetapkan nama tampilan
Nama tampilan menentukan cara pengguna memanggil Action secara eksplisit. Nama ini juga digunakan di direktori Asisten.
Untuk menetapkan nama tampilan, ikuti langkah-langkah ini:
- Buka Develop > Invocation > Settings.
- Masukkan nama tampilan untuk Action Anda.
- Klik ikon Play play_circle_filled untuk mendengarkan cara nama diucapkan.
Mengubah nama tampilan
Anda dapat mengubah nama tampilan untuk Action kapan saja; namun, Action Anda akan melalui proses peninjauan lengkap lainnya sebelum pengguna dapat memanggil Action menggunakan nama baru.
Opsional: Menetapkan penargetan lokasi
Secara default, Action Anda tersedia di semua wilayah selama lokalitas perangkat pengguna ditetapkan ke varian "Inggris" (misalnya, bahasa Inggris Amerika atau Inggris - Inggris).
Setelan Penargetan lokasi mengontrol ketersediaan regional untuk Tindakan.
Baca publikasi yang dilokalkan lebih lanjut.
Opsional: Menetapkan kemampuan platform
Action Anda dapat muncul di berbagai platform yang didukung Asisten, seperti ponsel (Android dan iOS) dan layar smart.
Kemampuan platform memungkinkan Anda mengontrol apakah pengguna dapat memanggil Tindakan berdasarkan permukaan yang mereka gunakan atau tidak. Jika pengguna mencoba memanggil Action Anda di platform yang tidak didukung, mereka akan menerima pesan error yang memberitahukan bahwa perangkat mereka tidak didukung.
Baca selengkapnya tentang kemampuan platform.
Opsional: Menetapkan opsi Canvas Interaktif
Jika Action menggunakan Interactive Canvas, Anda harus mengaktifkan dan menetapkan beberapa opsi di bagian Develop > Interactive Canvas di navigasi sebelah kiri.
- Mengaktifkan opsi untuk menggunakan Canvas Interaktif dengan Action Anda.
- Masukkan URL untuk aplikasi web yang menghosting visual untuk Action Anda.
Menguji dengan simulator
Sebelum merilis Action, gunakan simulator untuk menguji pengalaman pengguna Action Anda dan pastikan semuanya berfungsi.
Periksa error dan pelanggaran umum berikut:
- Transportasi webhook harus aman: Pastikan Anda menggunakan enkripsi HTTPS (TLS) pada transportasi untuk webhook Anda.
- Verifikasi permintaan webhook: Pastikan Anda menandatangani permintaan webhook menggunakan Actions SDK dan memverifikasinya di webhook.
- Uji nama Action Anda: Pastikan nama Action yang telah Anda tetapkan secara konsisten memicu Action Anda. Gunakan perangkat hardware atau simulator web dan ucapkan nama panggilan Anda berulang kali, dalam berbagai skenario di dunia nyata (yaitu, dengan suara bising di latar belakang, atau pada jarak yang berbeda dari perangkat). Jika memungkinkan, minta orang-orang dari gender yang berbeda atau dengan aksen yang berbeda untuk memanggil Action Anda. Jika nama pemanggilan tidak dikenali secara konsisten, Anda mungkin ingin mengubahnya.
- Menguji di perangkat fisik: Meskipun simulator web sangat bagus untuk menguji Action dengan cepat saat dikembangkan, Anda harus selalu menguji pemanggilan dan dialog di perangkat sungguhan. Ini adalah cara terbaik untuk memahami cara kerja Action dalam kehidupan nyata dan membantu Anda meningkatkan pengalaman pengguna.
Untuk menguji draf project Action Anda saat ini, buka Test di navigasi utama. Hal ini memastikan versi Action Anda saat ini digunakan di simulator, konsol, dan perangkat yang dilengkapi dengan Asisten.
Baca selengkapnya tentang Simulator tindakan.
Merilis project
Setelah menguji draf project dan puas dengan hasilnya, Anda dapat men-deploy-nya di saluran Alfa atau Beta untuk pengujian tambahan. Atau, Anda dapat mengirimkannya untuk ditinjau dan dirilis ke pengguna Asisten.
Di bagian Deploy > Release di konsol, Anda akan menemukan opsi berikut untuk rilis:
- Alfa: Paling baik digunakan untuk iterasi pengujian cepat. Action Anda didistribusikan ke sekelompok kecil pengguna yang Anda tentukan tanpa melalui ulasan lengkap di Google.
- Beta: Paling baik digunakan untuk mendistribusikan Action ke sekelompok pengguna terbatas setelah peninjauan Google lengkap. Karena Tindakan telah melewati peninjauan lengkap, Anda dapat memilih untuk memublikasikannya kapan saja.
- Produksi: Mengirimkan Action Anda untuk peninjauan Google lengkap. Setelah disetujui, Action Anda akan tersedia untuk pengguna Asisten.
Baca selengkapnya tentang rilis.
Status deployment
Tabel berikut menjelaskan berbagai status deployment project dan langkah-langkah tambahan yang mungkin perlu Anda lakukan:
Status deployment | Deskripsi |
---|---|
Dalam Peninjauan |
Saat Anda mengirimkan deployment baru, deployment tersebut akan melalui proses persetujuan. Peninjau menguji Action Anda dan memverifikasi bahwa Anda tidak melanggar kebijakan apa pun. Anda akan menerima email setelah peninjauan selesai yang memberitahukan apakah deployment Anda disetujui atau tidak. |
Ditolak | Status ditolak berarti deployment Anda tidak disetujui. Anda akan menerima email yang menjelaskan alasan deployment Anda ditolak. Anda juga dapat mengklik Mengapa? di samping status Ditolak di konsol untuk melihat alasan penolakan. |
Di-deploy | Tindakan yang disetujui yang aktif dan ditayangkan kepada pengguna. Anda dapat "menghapus" versi yang di-deploy kapan saja dari konsol. |
Disetujui | Tindakan yang telah lulus peninjauan dan saat ini tidak ditayangkan kepada pengguna. Setelah berhasil melewati tindakan, Action dapat dirilis kapan saja dari konsol, tanpa melalui peninjauan tambahan. |
Tidak sehat | Google secara rutin mengirimkan permintaan ke endpoint Action Anda dan memeriksa apakah kami mendapatkan respons yang sesuai. Jika kami mendeteksi bahwa endpoint Anda tidak aktif atau tidak responsif, kami akan menghentikan penayangan Action Anda kepada pengguna untuk sementara. Dalam hal ini, Anda akan menerima email yang memberi tahu bahwa endpoint Anda tidak responsif, dan Action Anda telah beralih ke status Tidak responsif. Segera setelah kami mendeteksi bahwa endpoint Anda responsif lagi, kami akan melanjutkan penayangan Action Anda kepada pengguna. Anda akan menerima email jika hal ini terjadi, dan status deployment Anda akan kembali ke Di-deploy. |
Dihapus | Google dapat menghapus Action Anda jika kami mendeteksi pelanggaran kebijakan setelah deployment. Jika hal ini terjadi, Anda akan menerima email dan melihat banner di konsol developer yang memberitahukan bahwa Action Anda telah dihapus. Anda dapat mengklik Mengapa? untuk melihat alasan, dan melihat opsi Anda untuk memperbaiki pelanggaran kebijakan atau mengajukan banding atas keputusan tersebut. |
Menetapkan versi project Anda
Seiring waktu, Anda mungkin ingin memperbarui informasi tentang Action Anda. Beberapa perubahan pada Action akan menghasilkan versi baru project Anda. Setiap versi baru harus dikirim ulang dan melalui proses peninjauan lengkap sebelum Action yang diupdate dirilis dan ditayangkan kepada publik.
Melakukan salah satu perubahan berikut mengharuskan Anda mengirim ulang Action untuk ditinjau:
- Perubahan dilakukan di konsol untuk mengubah deskripsi, ikon, atau metadata lainnya dari project tersebut.
- Anda telah melakukan perubahan pada project Actions menggunakan Action Builder atau Actions SDK.
- Anda telah membuat perubahan pada paket Action menggunakan SDK SDK lama.
- Dengan Dialogflow, Anda membuat perubahan pada agen Dialogflow Anda.
Anda tidak perlu mengirim ulang project untuk skenario berikut:
- Anda hanya melakukan perubahan pada kode di webhook yang dihosting secara eksternal, editor webhook inline di Actions Builder, atau di editor langsung Dialogflow.
- Anda menggunakan Template dan memperbarui data template dengan mengupload konten ke Google Spreadsheet.
Untuk mengirim Action yang diperbarui untuk ditinjau, buka Deploy > Release, lalu klik Buat rilis. Jika disetujui, versi sebelumnya akan tidak di-deploy dan versi terbaru Action Anda akan tersedia untuk pengguna Asisten.
Melacak dan mengubah versi
Untuk melacak dan mendapatkan informasi tentang versi Anda, buka Deploy > Release, lalu klik versi yang ingin Anda ketahui.
Tabel menampilkan tanggal terakhir diubah dan status versi saat ini. Anda dapat membuat perubahan khusus pada status, bergantung pada status versi saat ini.
- Jika versi dalam peninjauan, Anda dapat memilih untuk membatalkan versi dari peninjauan.
- Jika versi di-deploy, Anda dapat memilih Undeploy dari produksi untuk menghapus Action Anda.
- Saat versi sebelumnya tidak di-deploy, Anda dapat memilih Deploy to production untuk kembali ke versi tersebut.