Tingkatkan pengalaman pengguna secara keseluruhan dengan mengikuti panduan ini untuk desain Add-on Google Meet.
Praktik terbaik otorisasi
Sebaiknya gunakan 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 sebelum bergabung ke rapat. Oleh karena itu, menyediakan Google One Tap sebagai opsi dapat menghemat beberapa klik pengguna saat melalui alur login. Untuk mengetahui informasi selengkapnya, lihat Mengelola metode login untuk add-on Anda.
Membuka halaman login pihak ketiga di jendela baru
Selain login dengan Google, aplikasi Anda dapat menawarkan mekanisme login tambahan. Jika demikian, gunakan jendela dialog, bukan membuka halaman login di tab baru. Dengan cara ini, pengguna tetap dapat melihat dan kembali ke panggilan Meet, dan akan menerima lebih sedikit klik secara keseluruhan.
Meminta cakupan dengan benar untuk Google API
Jika Add-on Meet memanggil Google API, Anda harus memberikan daftar lengkap cakupan OAuth yang diperlukan oleh add-on. Tindakan ini dilakukan di halaman Konfigurasi Aplikasi Google Workspace Marketplace. Setelah menambahkan cakupan ini, pengguna akan melihat perintah saat menginstal Add-on Meet yang memberi tahu pengguna jenis data yang diizinkan untuk diakses aplikasi Anda.
Sebelum memublikasikan add-on, Anda juga harus menyiapkan layar izin OAuth. Hal ini memerlukan penambahan cakupan otorisasi yang sama persis dari Konfigurasi Aplikasi Google Workspace Marketplace Anda. Mengonfigurasi layar izin OAuth juga memerlukan penetapan informasi branding, kebijakan privasi, dan persyaratan layanan yang ditampilkan saat cakupan diminta. Untuk memublikasikan secara publik, semua informasi ini harus dikirim untuk verifikasi.
Saat menulis kode untuk memanggil Google Workspace API, mengikuti Panduan Awal JavaScript adalah cara termudah untuk memulai. Pendekatan ini mematuhi praktik terbaik untuk menggunakan Login dengan Google dan jendela dialog. Perhatikan bahwa melakukan inisialisasi klien token dalam JavaScript memerlukan permintaan cakupan secara terpisah yang sebenarnya digunakan aplikasi saat runtime. Untuk pengalaman pengguna terbaik, cakupan yang diminta ini harus cocok dengan cakupan di halaman Konfigurasi Aplikasi Google Workspace Marketplace. Redundansi ini menyediakan penggantian untuk menangani kasus ketika pengguna telah mencabut cakupan.
Praktik terbaik pemeliharaan
Praktik terbaik berikut ditujukan untuk menulis aplikasi web yang dapat dikelola, tetapi sangat penting saat menulis Add-on Meet.
Menggunakan SDK Add-on Google Meet versi terbaru
SDK Add-on Meet diperbarui secara berkala. SDK mematuhi pembuatan versi semantik. Untuk menemukan versi terbaru:
- Saat menggunakan gstatic: Versi SDK terbaru dimuat dalam URL gstatic yang terdapat dalam petunjuk penggunaan SDK.
- Saat menggunakan npm: Jalankan
npm update @googleworkspace/meet-add-ons
dari dalam direktori yang berisipackage.json
untuk situs yang menghosting Add-on Meet Anda.
Membuat project Google Cloud staging
Setelah Add-on Google Meet dipublikasikan di Google Workspace Marketplace, setiap deployment baru Add-on Google Meet akan langsung tersedia untuk pengguna Meet. Pengguna akan melihat pembaruan ini segera setelah cache dikosongkan atau masa berlaku cache berakhir. Oleh karena itu, sebaiknya jangan menerapkan perubahan ke situs produksi sampai perubahan tersebut diuji secara menyeluruh.
Agar tidak langsung men-deploy ke produksi, sebaiknya buat project Google Cloud terpisah yang dipublikasikan secara pribadi ke organisasi Anda. Project Cloud ini akan menghosting lingkungan staging dan pengembangan untuk Add-on Meet Anda. Akses untuk project Cloud ini harus dibatasi untuk tim yang lebih kecil yang secara langsung mengerjakan pengembangan add-on Anda.
Untuk membuat lingkungan alternatif ini bagi add-on, Anda harus menghosting lingkungan alternatif aplikasi web yang berisi add-on, di domain yang Anda miliki terlebih dahulu. Kemudian, Anda dapat membuat lingkungan alternatif untuk Add-on Meet dengan menambahkan deployment tambahan ke project Google Cloud staging. Deployment baru ini harus memiliki manifes yang mengarah ke lingkungan alternatif aplikasi web Anda. Kemudian, sebaiknya instal setiap lingkungan add-on sebagai berikut:
- Staging: Memublikasikan versi staging secara pribadi sehingga siapa saja di organisasi Anda dapat membantu pengujian.
- Pengembangan: Klik Instal di kolom Tindakan untuk menginstal versi pengembangan Add-on Meet hanya ke akun Anda.
Menulis pengujian
Sebelum men-deploy Add-on Meet ke lingkungan pengembangan, 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 add-on yang tidak terkait dengan SDK dengan framework pengujian web pilihan Anda.
Praktik terbaik pengalaman pengguna
Praktik terbaik berikut membantu membuat Add-on Meet lebih intuitif dan lebih baik.
Mengelola semua status awal di panel samping
Sebaiknya siapkan add-on Anda berdasarkan
tindakan pengguna yang dilakukan di panel samping.
Hal ini dilakukan dengan menyetel status awal
aktivitas di
JavaScript. Semua data yang masuk ke
ActivityStartingState
harus ditetapkan oleh inisiator add-on (biasanya
penyelenggara rapat) dalam panel samping. Anda dapat menganggap tampilan pertama
panel samping sebagai formulir yang mengontrol penyiapan
add-on.
Menutup panel samping saat tidak digunakan
Setelah memulai aktivitas dengan memanggil metode
startActivity()
, Anda hanya boleh membiarkan panel samping terbuka jika merupakan bagian penting
dari pengalaman pengguna untuk Add-on Google Meet Anda. Anda dapat menutup
panel samping setelah tahap utama
terbuka dengan memanggil
metode
unloadSidePanel()
.
Mempromosikan Add-on Meet melalui berbagi layar
Add-on Meet menawarkan pengalaman yang lebih kaya daripada berbagi layar. Namun, banyak pengguna terbiasa menggunakan fitur berbagi layar Meet. Jika pengguna membagikan tab yang menampilkan situs yang menghosting Add-on Meet Anda, Meet dapat dikonfigurasi untuk menampilkan banner kepada semua peserta panggilan yang meminta mereka menginstal atau menggunakan Add-on Meet yang sesuai. Untuk informasi selengkapnya, lihat mempromosikan add-on melalui berbagi layar.
Panduan desain logo
Ikuti panduan ini saat mendesain logo khusus Meet agar tampilannya terlihat terbaik sekarang dan di masa mendatang:
Gunakan format file PNG, berukuran 256x256 piksel.
Gunakan transparansi.
Pastikan logo mode gelap Anda terlihat bagus dalam mode gelap menggunakan alat developer untuk Add-on Meet.
Patuhi persyaratan grafis untuk integrasi aplikasi tertentu.
Jangan sertakan padding di gambar. Perluas gambar ke batas file Anda.