Praktik terbaik

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 Sekali Ketuk sebagai opsi dapat menghemat beberapa klik bagi 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 masih dapat melihat dan kembali ke panggilan Meet, dan akan melakukan lebih sedikit klik secara keseluruhan.

Meminta cakupan dengan benar untuk Google API

Jika add-on Meet memanggil Google API, Anda harus menyediakan 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. Tindakan 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 memberikan penggantian untuk menangani kasus saat 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 terdapat dalam URL gstatic yang ditemukan di petunjuk untuk menggunakan SDK.
  • Saat menggunakan npm: Jalankan npm update @googleworkspace/meet-add-ons dari dalam direktori yang berisi package.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 kirimkan perubahan ke situs produksi Anda hingga 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.
  • Pengujian unit semua fungsi terkait non-SDK dari add-on Anda 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 menetapkan 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 beragam 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 untuk 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 dalam gambar Anda. Perluas gambar ke batas file Anda.