Enumerasi yang mengidentifikasi kategori layanan yang diizinkan Apps Script yang dapat
dieksekusi melalui fungsi yang dipicu. Nilai ini ditampilkan dalam fungsi yang dipicu sebagai properti authMode
dari parameter peristiwa, e
. Untuk
mengetahui informasi selengkapnya, lihat panduan
siklus proses otorisasi untuk add-on.
Untuk memanggil enum, panggil class, nama, dan properti induknya. Misalnya,
ScriptApp.AuthMode.CUSTOM_FUNCTION
.
function onOpen(e) { var menu = SpreadsheetApp.getUi().createAddonMenu(); if (e && e.authMode == ScriptApp.AuthMode.NONE) { // Add a normal menu item (works in all authorization modes). menu.addItem('Start workflow', 'startWorkflow'); } else { // Add a menu item based on properties (doesn't work in AuthMode.NONE). var properties = PropertiesService.getDocumentProperties(); var workflowStarted = properties.getProperty('workflowStarted'); if (workflowStarted) { menu.addItem('Check workflow status', 'checkWorkflow'); } else { menu.addItem('Start workflow', 'startWorkflow'); } // Record analytics. UrlFetchApp.fetch('http://www.example.com/analytics?event=open'); } menu.addToUi(); }
Properti
Properti | Jenis | Deskripsi |
---|---|---|
NONE | Enum | Mode yang tidak mengizinkan akses ke layanan apa pun yang memerlukan otorisasi. Mode ini terjadi
saat add-on menjalankan pemicu sederhana onOpen(e) , dan pengguna telah menginstal
add-on di dokumen yang berbeda, tetapi add-on tersebut belum digunakan dalam dokumen saat ini. |
CUSTOM_FUNCTION | Enum | Mode yang memungkinkan akses ke subset layanan terbatas untuk digunakan dalam fungsi spreadsheet kustom. Beberapa layanan ini — termasuk akses hanya baca ke layanan Spreadsheet — biasanya memerlukan otorisasi, tetapi diizinkan tanpa otorisasi jika digunakan dalam fungsi kustom. Karena fungsi kustom tidak menyertakan parameter peristiwa, nilai ini tidak pernah ditampilkan. Nilai ini didokumentasikan hanya untuk menunjukkan bahwa fungsi kustom berjalan dalam mode otorisasinya sendiri. |
LIMITED | Enum | Mode yang memungkinkan akses ke {i>subset<i} layanan yang terbatas. Mode ini terjadi saat add-on atau
skrip yang terikat ke dokumen mengeksekusi pemicu sederhana onOpen(e) atau onEdit(e) , kecuali dalam kasus yang dijelaskan untuk NONE . |
FULL | Enum | Mode yang memungkinkan akses ke semua layanan yang memerlukan otorisasi. Mode ini terjadi saat
add-on atau skrip dieksekusi sebagai hasil dari pemicu apa pun selain kasus yang dijelaskan untuk
LIMITED atau NONE . |