Halaman ini diterjemahkan oleh Cloud Translation API.

Enum AuthMode

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 . 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`.