Tingkatkan pengalaman pengguna secara keseluruhan dengan mengikuti panduan desain add-on ini.
Praktik terbaik umum
Sebaiknya gunakan praktik terbaik berikut untuk semua add-on yang Anda kembangkan.
Tentukan 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 penayangnya. 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 mereplikasinya
Add-on dimaksudkan untuk memberikan kemampuan baru pada aplikasi Google Workspace yang diperluasnya, atau mengotomatiskan tugas yang kompleks. Add-on yang hanya mereplikasi fungsi yang sudah ada dalam aplikasi atau yang tidak memberikan peningkatan signifikan pada alur kerja kemungkinan tidak akan lulus peninjauan add-on untuk dipublikasikan.
Jaga agar cakupan tetap sempit
Saat menentukan cakupan secara
eksplisit, selalu pilih
kumpulan cakupan yang paling tidak permisif. Misalnya, jangan minta akses penuh add-on Anda 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 banyak mengandalkan library
Penggunaan library Apps Script dapat menyebabkan add-on Anda berjalan lebih lambat daripada jika semua kode Apps Script berada dalam satu project skrip. Meskipun library Apps Script berfungsi di add-on, Anda mungkin mengalami penurunan performa jika menggunakannya. Hindari menyertakan library yang tidak perlu 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. Add-on yang kompleks akan lebih mudah dikelola jika Anda menempatkan HTML dan JavaScript yang menentukan sidebar dan dialog add-on dalam file skrip khusus.
Uji secara menyeluruh dalam berbagai mode otorisasi
Saat menguji add-on, pastikan untuk mencoba konfigurasi yang memiliki file berbeda dan status otorisasi yang berbeda.