Enum AuthMode

AuthMode

Enumerasi yang mengidentifikasi kategori layanan resmi yang dapat dieksekusi Apps Script melalui fungsi yang dipicu. Nilai ini diekspos 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, Anda memanggil class induk, nama, dan propertinya. Misalnya, ScriptApp.AuthMode.CUSTOM_FUNCTION.

function onOpen(e) {
  const 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).
    const properties = PropertiesService.getDocumentProperties();
    const 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 lain, tetapi add-on belum digunakan di dokumen saat ini.
CUSTOM_FUNCTION	Enum	Mode yang memungkinkan akses ke sebagian kecil layanan 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 ini hanya didokumentasikan untuk menunjukkan bahwa fungsi kustom berjalan dalam mode otorisasi sendiri.
LIMITED	Enum	Mode yang memungkinkan akses ke sebagian kecil layanan. Mode ini terjadi saat add-on atau skrip yang terikat ke dokumen menjalankan 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 dijalankan sebagai hasil dari pemicu apa pun selain kasus yang dijelaskan untuk LIMITED atau NONE.