Enum AuthMode

AuthMode

列舉項目,用於識別 Apps Script 可存取哪些授權服務類別 透過觸發的函式執行這些值會在「觸發的函式」中顯示為 authMode 事件參數屬性 e。適用對象 請參閱這份指南 外掛程式的授權生命週期

如要呼叫列舉,您可以呼叫其父項類別、名稱和屬性。例如 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();
}

屬性

屬性類型說明
NONEEnum模式不允許存取任何需要授權的服務。發生這個模式時 外掛程式執行 onOpen(e) 簡單觸發條件,且使用者安裝 外掛程式,但並未在目前的文件中使用這個外掛程式。
CUSTOM_FUNCTIONEnum此模式允許存取部分服務,供自訂試算表使用 函式。其中一些服務 (包括試算表服務的唯讀存取權) 通常需要授權,但如果用於自訂和自訂用途,則不必獲得授權 函式。由於自訂函式不含事件參數,因此這個值一律不得 returned;但僅用於示範自訂函式是自行執行 授權模式。
LIMITEDEnum允許存取部分服務模式的模式。這個模式會發生在 「繫結」至文件的指令碼會執行 onOpen(e)onEdit(e) 簡易觸發條件,但 NONE 中描述的情況除外。
FULLEnum允許存取所有需要授權的服務。這時, 外掛程式或指令碼會在所有觸發事件的結果, LIMITEDNONE