Enum AuthMode

AuthMode

Перечисление, определяющее, какие категории авторизованных служб Apps Script может выполнять через запускаемую функцию. Эти значения отображаются в запускаемых функциях в качестве свойства authMode параметра события , e . Для получения дополнительной информации см. руководство по жизненному циклу авторизации для дополнений .

Для вызова перечисления необходимо указать его родительский класс, имя и свойство. Например, 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();
}

Характеристики

Свойство	Тип	Описание
NONE	Enum	Режим, который не предоставляет доступ к каким-либо службам, требующим авторизации. Этот режим возникает, когда надстройка запускает простой триггер on Open(e) , и пользователь установил надстройку в другом документе, но эта надстройка не использовалась в текущем документе.
CUSTOM_FUNCTION	Enum	Режим, предоставляющий доступ к ограниченному набору служб для использования в пользовательских функциях электронных таблиц. Некоторые из этих служб, включая доступ только для чтения к службе электронных таблиц, обычно требуют авторизации, но разрешены без авторизации при использовании в пользовательской функции. Поскольку пользовательские функции не содержат параметра события, это значение никогда не возвращается; оно задокументировано только для демонстрации того, что пользовательские функции работают в собственном режиме авторизации.
LIMITED	Enum	Режим, предоставляющий доступ к ограниченному набору сервисов. Этот режим активируется, когда надстройка или скрипт, привязанный к документу, запускает простой триггер on Open(e) или on Edit(e) , за исключением случая, описанного для NONE .
FULL	Enum	Режим, разрешающий доступ ко всем сервисам, требующим авторизации. Этот режим активируется при выполнении дополнения или скрипта в результате любого триггера, кроме случаев, описанных для LIMITED или NONE .