Enum AuthMode

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.
AuthMode

Enumerasi yang mengidentifikasi kategori layanan resmi yang dapat dieksekusi oleh Apps Script melalui fungsi yang dipicu. Nilai ini ditampilkan dalam fungsi yang dipicu sebagai properti authMode dari parameter peristiwa, e. Untuk informasi selengkapnya, lihat panduan siklus proses otorisasi untuk add-on.

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

PropertiJenisDeskripsi
NONEEnumMode 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 belum digunakan dalam dokumen saat ini.
CUSTOM_FUNCTIONEnumMode 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 saat digunakan dalam fungsi kustom. Karena fungsi kustom tidak menyertakan parameter peristiwa, nilai ini tidak pernah ditampilkan. Nilai tersebut hanya didokumentasikan untuk menunjukkan bahwa fungsi kustom berjalan dalam mode otorisasinya sendiri.
LIMITEDEnumMode yang memungkinkan akses ke subset layanan terbatas. Mode ini terjadi saat add-on atau skrip terikat pada dokumen mengeksekusi pemicu sederhana onOpen(e) atau onEdit(e), kecuali dalam kasus yang dijelaskan untuk NONE.
FULLEnumMode yang memungkinkan akses ke semua layanan yang memerlukan otorisasi. Mode ini terjadi saat add-on atau skrip dieksekusi sebagai hasil dari pemicu selain kasus yang dijelaskan untuk LIMITED atau NONE.