Tingkatkan pengalaman pengguna secara keseluruhan dengan mengikuti panduan desain add-on ini.
Praktik terbaik umum
Anda sebaiknya menggunakan praktik terbaik berikut untuk semua add-on yang Anda kembangkan.
Menentukan kepemilikan add-on sebelum memulai
Add-on ditentukan oleh project Apps Script, yang harus dimiliki oleh akun tertentu atau ditempatkan di drive bersama. Sebelum membuat kode add-on, tentukan akun mana yang harus memiliki project, dan akun mana yang bertindak sebagai penayang. Tentukan juga akun mana yang akan bertindak sebagai kolaborator, dan pastikan akun tersebut memiliki akses ke project skrip dan project Google Cloud terkait .
Perluas Google Workspace, jangan duplikat
Add-on dimaksudkan untuk memberikan kemampuan baru ke aplikasi Google Workspace yang diperluas, atau mengotomatiskan tugas yang kompleks. Add-on yang hanya menduplikasi fungsi yang sudah ada dalam aplikasi atau yang tidak memberikan peningkatan signifikan pada alur kerja kemungkinan tidak akan lulus peninjauan add-on untuk publikasi.
Pertahankan cakupan yang sempit
Saat menentukan cakupan
secara eksplisit, selalu pilih kumpulan cakupan yang
paling tidak permisif. Misalnya, jangan minta add-on Anda untuk meminta akses penuh ke Kalender pengguna dengan cakupan https://www.googleapis.com/auth/calendar jika hanya memerlukan akses baca. Untuk akses hanya baca, gunakan cakupan https://www.googleapis.com/auth/calendar.readonly.
Hindari terlalu bergantung pada library
Menggunakan library Apps Script dapat menyebabkan add-on Anda berjalan lebih lambat daripada jika semua kode Apps Script terdapat dalam satu project skrip. Meskipun library Apps Script berfungsi di add-on, Anda mungkin mengalami penurunan performa jika menggunakannya. Hindari menyertakan library yang tidak diperlukan dalam project Anda, dan pertimbangkan cara untuk mengurangi ketergantungan add-on Anda pada library tersebut.
Latensi yang dijelaskan di atas hanya berlaku untuk project Apps Script yang digunakan sebagai library sisi server. Anda dapat menggunakan library JavaScript sisi klien seperti jQuery secara bebas tanpa mengalami latensi ini.
Praktik terbaik add-on Editor
Praktik terbaik berikut hanya berlaku untuk add-on Editor.
Menempatkan HTML antarmuka dan JavaScript sisi klien dalam file skripnya sendiri
Anda dapat membuat beberapa file skrip dalam project Apps Script. Akan lebih mudah mengelola add-on yang kompleks jika Anda menempatkan HTML dan JavaScript yang menentukan sidebar dan dialog add-on dalam file skrip yang khusus untuknya.
Menguji secara menyeluruh dalam mode otorisasi yang berbeda
Saat menguji add-on, pastikan untuk mencoba konfigurasi yang memiliki file berbeda dan status otorisasiyang berbeda.