Tingkatkan pengalaman pengguna secara keseluruhan dengan mengikuti panduan desain add-on ini.
Praktik terbaik umum
Sebaiknya ikuti 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 yang harus memiliki project, dan akun yang bertindak sebagai penayangnya. Tentukan juga akun yang akan bertindak sebagai collaborator, dan pastikan akun tersebut memiliki akses ke project skrip dan project platform Cloud terkait.
Memperluas Google Workspace, bukan mereplikasinya
add-on dimaksudkan untuk memberikan kemampuan baru ke aplikasi Google Workspace yang diperluas, atau mengotomatiskan tugas yang kompleks. Add-on yang hanya mereplikasi fungsi yang sudah ada dalam aplikasi atau yang tidak membuat peningkatan signifikan pada alur kerja kemungkinan tidak akan lulus peninjauan add-on untuk publikasi.
Membatasi cakupan
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.
Menghindari terlalu mengandalkan library
Menggunakan library Apps Script dapat menyebabkan add-on 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 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. Akan lebih mudah untuk mengelola add-on yang kompleks jika Anda menempatkan HTML dan JavaScript yang menentukan sidebar dan dialog add-on dalam file skrip yang didedikasikan untuknya.
Menguji secara menyeluruh dalam berbagai mode otorisasi
Saat menguji add-on, pastikan untuk mencoba konfigurasi yang memiliki file dan status otorisasi yang berbeda.