Enumerasi yang mengidentifikasi kategori layanan yang diizinkan yang dapat dilakukan Apps Script
mengeksekusi melalui
fungsi yang dipicu. Nilai ini ditampilkan dalam fungsi yang dipicu sebagai authMode
parameter peristiwa, e
. Sebagai
informasi selengkapnya, lihat panduan untuk
siklus proses otorisasi untuk add-on.
Untuk memanggil enum, Anda memanggil 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 mengeksekusi pemicu sederhana onOpen(e) , dan pengguna telah menginstal
add-on di dokumen lain tetapi add-on tersebut belum digunakan dalam dokumen saat ini. |
CUSTOM_FUNCTION | Enum | Mode yang memungkinkan akses ke subset layanan terbatas untuk digunakan dalam spreadsheet kustom fungsi-fungsi lainnya. Beberapa layanan tersebut — termasuk akses hanya baca ke layanan Spreadsheet — biasanya membutuhkan otorisasi, namun diizinkan tanpa otorisasi bila digunakan dalam fungsi tersebut. Karena fungsi kustom tidak menyertakan parameter peristiwa, nilai ini tidak pernah returned; hal ini didokumentasikan hanya untuk menunjukkan bahwa fungsi kustom berjalan di mode otorisasi. |
LIMITED | Enum | Mode yang memungkinkan akses ke subset layanan 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 . |