Praktik terbaik

Tingkatkan pengalaman pengguna secara keseluruhan dengan mengikuti panduan ini untuk desain add-on Google Meet.

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 sudah login ke Google sebelum bergabung ke rapat. Oleh karena itu, ketersediaan Login Sekali Ketuk Google 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 ya, gunakan jendela dialog, bukan membuka halaman login di tab baru. Dengan begitu, pengguna tetap 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 Anda memanggil Google API, Anda harus memberikan daftar lengkap cakupan OAuth yang diperlukan oleh add-on Anda. Hal ini dilakukan di halaman Konfigurasi Aplikasi Google Workspace Marketplace. Setelah menambahkan cakupan ini, pengguna akan melihat perintah saat menginstal add-on Meet Anda yang memberi tahu pengguna jenis data yang mereka izinkan untuk diakses aplikasi Anda.

Sebelum memublikasikan add-on, Anda juga harus menyiapkan layar izin OAuth. Hal ini mengharuskan penambahan cakupan otorisasi yang persis sama 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 dikirimkan untuk verifikasi.

Saat menulis kode untuk memanggil Google Workspace API, mengikuti Mulai Cepat JavaScript adalah cara termudah untuk memulai. Pendekatan ini mematuhi praktik terbaik untuk menggunakan Login dengan Google dan jendela dialog. Perhatikan bahwa menginisialisasi klien token di JavaScript memerlukan permintaan terpisah untuk cakupan yang sebenarnya digunakan aplikasi saat runtime. Untuk mendapatkan 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 saat pengguna telah mencabut cakupan.

Praktik terbaik pemeliharaan

Praktik terbaik berikut adalah untuk menulis aplikasi web yang mudah dikelola, tetapi sangat penting saat menulis add-on Meet.

Menggunakan Google Meet add-on SDK versi terbaru

SDK add-on Meet diperbarui secara berkala. SDK mematuhi pembuatan versi semantik. Untuk menemukan versi terbaru:

  • Saat menggunakan gstatic: Versi SDK terbaru ada dalam URL gstatic yang ditemukan di petunjuk penggunaan 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 penyiapan

Setelah add-on Google Meet Anda dipublikasikan di Google Workspace Marketplace, semua deployment baru add-on Google Meet Anda akan langsung tersedia bagi pengguna Meet. Pengguna akan melihat update ini segera setelah mereka mengosongkan cache atau cache berakhir. Oleh karena itu, sebaiknya jangan mendorong perubahan ke situs produksi Anda hingga perubahan diuji secara menyeluruh.

Agar tidak men-deploy langsung ke produksi, sebaiknya buat project Google Cloud terpisah yang dipublikasikan secara pribadi ke organisasi Anda. Project Cloud ini akan menghosting lingkungan penyiapan dan pengembangan untuk add-on Meet Anda. Akses untuk project Cloud ini harus dibatasi hanya untuk tim kecil yang langsung mengerjakan pengembangan add-on Anda.

Untuk membuat lingkungan alternatif ini bagi add-on Anda, Anda harus menghosting lingkungan alternatif aplikasi web yang berisi add-on Anda, di domain yang Anda miliki. Kemudian, Anda dapat membuat lingkungan alternatif untuk add-on Meet dengan menambahkan deployment tambahan ke project Google Cloud staging Anda. Deployment baru ini harus memiliki manifest yang mengarah ke lingkungan alternatif aplikasi web Anda. Kemudian, sebaiknya instal setiap lingkungan add-on sebagai berikut:

  • Staging: Publikasikan versi staging secara pribadi agar siapa pun 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 uji unit. Pengujian unit Anda harus mencakup:

  • Menyimulasikan SDK add-on Meet, lalu memverifikasi bahwa add-on Meet memanggil fungsi SDK seperti yang diharapkan.
  • Lakukan pengujian unit semua fungsi terkait non-SDK add-on Anda dengan framework pengujian web pilihan Anda.

Praktik terbaik pengalaman pengguna

Praktik terbaik berikut membantu membuat add-on Meet lebih intuitif dan canggih.

Mengelola semua status awal di panel samping

Sebaiknya siapkan add-on berdasarkan tindakan pengguna yang dilakukan di panel samping. Hal ini dilakukan dengan menetapkan status mulai aktivitas di JavaScript. Semua data yang masuk ke ActivityStartingState harus ditetapkan oleh pemrakarsa add-on (biasanya host rapat) dalam panel samping. Anda dapat menganggap tampilan pertama panel samping sebagai formulir yang mengontrol penyiapan add-on Anda.

Tutup panel samping saat tidak digunakan

Setelah memulai aktivitas dengan memanggil metode startActivity(), Anda hanya boleh membuka panel samping jika merupakan bagian penting dari pengalaman pengguna untuk add-on Google Meet Anda. Anda dapat menutup panel samping setelah tahap utama dibuka dengan memanggil metode unloadSidePanel().

Mempromosikan add-on Meet Anda 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 untuk menginstal atau menggunakan add-on Meet yang sesuai. Untuk mengetahui informasi selengkapnya, lihat mempromosikan add-on melalui berbagi layar.

Panduan desain logo

Ikuti panduan berikut saat mendesain logo khusus Meet agar terlihat terbaik sekarang dan pada 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.

Pastikan logo (dan aset visual lainnya) terlihat bagus dalam mode kontras tinggi dengan menggunakan pemeriksa kontras seperti Contrast Checker dari Web Accessibility In Mind (WebAIM).

Patuhi persyaratan grafis untuk integrasi aplikasi tertentu.

Jangan sertakan padding dalam gambar Anda. Perluas gambar ke batas file Anda.