Tingkatkan pengalaman pengguna Anda secara keseluruhan dengan mengikuti panduan desain add-on ini.
Praktik terbaik umum
Sebaiknya ikuti 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 yang ditempatkan di drive bersama. Sebelum melakukan coding add-on, tentukan akun yang harus memiliki project dan akun yang bertindak sebagai penayangnya. Tentukan juga akun yang akan bertindak sebagai kolaborator, dan pastikan akun tersebut memiliki akses ke project skrip dan project platform Cloud terkait.
Perluas cakupan Google Workspace, jangan direplikasi
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 add-on yang tidak mereplikasi peningkatan signifikan pada alur kerja mungkin tidak akan lulus peninjauan add-on untuk dipublikasikan.
Batasi cakupan
Saat menentukan cakupan secara eksplisit,
selalu pilih kumpulan cakupan yang paling tidak permisifnya. Misalnya, jangan
minta add-on 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
.
Jangan terlalu mengandalkan library
Menggunakan library Apps Script dapat menyebabkan add-on 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 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}.
Tempatkan HTML antarmuka dan JavaScript sisi klien di file skripnya sendiri
Anda dapat membuat beberapa file skrip di project Apps Script. 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 dikhususkan untuknya.
Lakukan pengujian secara menyeluruh dalam berbagai mode otorisasi
Saat menguji add-on, pastikan untuk mencoba konfigurasi yang memiliki file berbeda dan status otorisasi yang berbeda.