Praktik terbaik

Meningkatkan pengalaman pengguna secara keseluruhan dengan mengikuti panduan ini untuk Desain Add-on Google Meet.

Pratinjau Developer: Tersedia sebagai bagian dari Program Pratinjau Developer Google Workspace, yang memberikan akses awal ke fitur tertentu.

Praktik terbaik otorisasi

Sebaiknya Anda menggunakan praktik terbaik berikut untuk Add-on Google Meet yang memerlukan autentikasi atau otorisasi.

Menggunakan Login dengan Google

Banyak pengguna Add-on Google Workspace yang sudah login ke Google sebelumnya bergabung dalam rapat. Oleh karena itu, Login dengan Google yang tersedia sebagai opsi. Anda dapat menghemat beberapa klik bagi pengguna saat alur login.

Membuka halaman login pihak ketiga di jendela baru

Selain login dengan Google, aplikasi Anda mungkin menawarkan login tambahan mekanisme atensi. Jika demikian, gunakan jendela dialog, bukan membuka halaman login di tab baru. Dengan cara ini, pengguna masih dapat melihat dan kembali ke panggilan Meet, dan akan menerima lebih sedikit klik secara keseluruhan.

Catatan: Halaman login pihak ketiga untuk Add-on Google Meet tidak memiliki penerapan yang sama persyaratan sebagai Add-on Google Workspace. Anda dapat membuka jendela login langsung dari iframe aplikasi. Add-on Meet juga tidak mendukung Login Add-on Google Workspace kartu. Namun, Anda tetap perlu mengalihkan pengguna untuk menyelesaikan proses otentikasi dan otorisasi pada infrastruktur IT.

Meminta cakupan untuk Google API dengan benar

Jika Add-on Meet memanggil Google API, Anda harus memberikan daftar lengkap OAuth cakupan yang diperlukan oleh add-on Anda. Hal ini dilakukan di Halaman Konfigurasi Aplikasi Google Workspace Marketplace. Setelah menambahkan cakupan, pengguna Anda akan melihat dialog ketika mereka menginstal Add-on Meet yang memberi tahu pengguna jenis data yang mereka mengizinkan aplikasi Anda untuk mengakses.

Sebelum memublikasikan add-on, Anda juga harus menyiapkan izin OAuth layar. Hal ini memerlukan penambahan cakupan otorisasi yang sama persis dengan Konfigurasi Aplikasi Google Workspace Marketplace. Mengonfigurasi OAuth layar izin juga memerlukan penetapan informasi branding, kebijakan privasi, dan persyaratan layanan yang ditampilkan saat cakupan diminta. Untuk memublikasikan secara umum, semua informasi ini harus dikirimkan untuk verifikasi.

Catatan: Tidak seperti Add-on Google Workspace umum, add-on ini tidak diperlukan Add-on Meet untuk menyertakan oauthScopes di manifes.

Saat menulis kode untuk memanggil Google Workspace API, mengikuti JavaScript Panduan memulai adalah cara termudah untuk memulai. Pendekatan ini mematuhi praktik terbaik untuk menggunakan Login dengan Google dan jendela dialog. Perhatikan bahwa inisialisasi token klien di JavaScript memerlukan permintaan terpisah untuk cakupan yang digunakan pada runtime. Untuk pengalaman pengguna terbaik, cakupan yang diminta ini harus cocok dengan yang ada di Konfigurasi Aplikasi Google Workspace Marketplace kami. Redundansi ini memberikan penggantian untuk menangani kasus di mana pengguna telah mencabut cakupan kami.

Praktik terbaik pemeliharaan

Praktik terbaik berikut adalah untuk menulis yang dapat dipelihara aplikasi web, namun mereka sangat penting saat menulis Add-on Meet.

Gunakan SDK Add-on Google Meet versi terbaru

SDK Add-on Meet diupdate secara berkala. SDK mematuhi pembuatan versi semantik. Untuk menemukan versi terbaru:

• Saat menggunakan gstatic: Versi SDK terbaru berada dalam class gstatic URL yang ada di petunjuk untuk menggunakan SDK.
• Saat menggunakan npm: Jalankan npm update @googleworkspace/meet-add-ons dari dalam direktori yang berisi file package.json untuk situs yang menghosting Add-on Meet Anda.

Membuat project Google Cloud staging

Setelah Add-on Google Meet Anda dipublikasikan di Google Workspace Marketplace, semua deployment baru Add-on Google Meet akan langsung diterapkan yang tersedia untuk pengguna Meet. Pengguna akan melihat pembaruan ini segera setelah mengosongkan cache atau kedaluwarsa. Oleh karena itu, sebaiknya jangan mendorong perubahan ke situs produksi hingga perubahan tersebut diuji secara menyeluruh.

Penting: Pengguna mungkin melihat keterlambatan dalam update pada Add-on Meet bergantung pada kebijakan cache aplikasi. Setel waktu habis masa berlaku cache ke nilai yang sesuai untuk aplikasi—idealnya tidak lebih dari 24 jam—untuk memastikan konsistensi {i>user experience<i}. Pengguna juga melihat versi baru jika mereka mengosongkan cache secara manual.

Untuk menghindari deployment langsung ke produksi, sebaiknya buat project Project Google Cloud yang dipublikasikan secara pribadi di organisasi Anda. Project Cloud ini akan menghosting staging serta lingkungan pengembangan untuk Add-on Meet Anda. Akses untuk proyek {i>Cloud<i} ini harus dibatasi pada tim yang lebih kecil yang secara langsung mengembangkan {i>add-on<i} Anda.

Guna membuat lingkungan alternatif ini untuk add-on Anda, Anda harus terlebih dahulu menjadi {i>host<i} lingkungan alternatif dari aplikasi web Anda yang berisi add-on Anda, pada domain yang Anda miliki. Lalu: Anda dapat membuat lingkungan alternatif untuk lingkungan Add-on Meet dengan menambahkan deployment ke project Google Cloud staging. Deployment baru ini harus memiliki manifes yang mengarah ke lingkungan alternatif aplikasi web Anda. Kemudian, sebaiknya instal setiap add-on lingkungan seperti berikut:

• Staging: Memublikasikan versi staging secara pribadi sehingga siapa pun di organisasi Anda dapat membantu pengujian.
• Pengembangan: Klik Instal di bawah kolom Tindakan untuk menginstal Meet versi pengembangan Add-on khusus untuk akun Anda.

Menulis pengujian

Sebelum men-deploy Add-on Meet ke pengembangan lingkungan, sebaiknya tulis pengujian unit. Pengujian unit Anda harus mencakup:

• Membuat tiruan SDK Add-on Meet, lalu memverifikasi bahwa Add-on Meet memanggil fungsi SDK seperti yang diharapkan.
• Melakukan pengujian unit pada semua fungsi yang tidak terkait dengan SDK dari dengan framework pengujian web pilihan Anda.

Praktik terbaik pengalaman pengguna

Praktik terbaik berikut membantu membuat Add-on Meet lebih intuitif dan disempurnakan.

Mengelola semua status awal di panel samping

Kami sangat menyarankan Anda untuk menyiapkan add-on berdasarkan tindakan pengguna yang dilakukan di panel samping. Hal ini dilakukan dengan menyetel kolaborasi yang dimulai status di pada JavaScript. Semua data yang masuk ke dalam CollaborationStartingState harus disetel oleh inisiator add-on (biasanya penyelenggara rapat) di dalam panel samping. Anda dapat memikirkan pandangan pertama dari panel samping sebagai formulir yang mengontrol penyiapan {i>add-on<i}.

Menutup panel samping saat tidak digunakan

Setelah memulai aktivitas dengan memanggil startCollaboration, Anda hanya boleh mempertahankan panel samping terbuka jika hal tersebut merupakan bagian penting dari pengalaman pengguna bagi Add-on Google Meet. Anda dapat menutup panel samping setelah utama tahap dibuka dengan memanggil unloadSidePanel

Mempromosikan Add-on Meet melalui berbagi layar

Add-on Meet menawarkan pengalaman yang lebih kaya daripada berbagi layar. Namun, banyak pengguna yang sudah terbiasa menggunakan fitur berbagi layar di Meet aplikasi baru. Jika pengguna membagikan tab yang menampilkan situs yang menghosting Add-on Meet, Meet dapat dikonfigurasi untuk menampilkan banner kepada semua peserta panggilan yang meminta mereka untuk menginstal atau menggunakan Add-on Meet yang sesuai. Untuk informasi selengkapnya, lihat mempromosikan add-on Anda melalui layar berbagi.

Topik terkait

• Memecahkan masalah dan memperbaiki error Add-on Meet