Enum AuthMode

AuthMode

Eine Aufzählung, die angibt, welche Kategorien von autorisierten Diensten in Apps Script über eine ausgelöste Funktion ausgeführt werden können. Diese Werte werden in ausgelösten Funktionen als authMode-Attribut des Ereignisparameters e freigegeben. Weitere Informationen finden Sie im Leitfaden zum Autorisierungslebenszyklus für Add-ons.

Wenn Sie ein Enum aufrufen möchten, rufen Sie die übergeordnete Klasse, den Namen und die Eigenschaft auf. Beispiel: 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();
}

Attribute

AttributTypBeschreibung
NONEEnumEin Modus, der den Zugriff auf Dienste, für die eine Autorisierung erforderlich ist, nicht zulässt. Dieser Modus tritt auf, wenn ein Add-on einen onOpen(e)-Trigger ausführt und der Nutzer ein Add-on in einem anderen Dokument installiert hat, das Add-on aber im aktuellen Dokument nicht verwendet wurde.
CUSTOM_FUNCTIONEnumEin Modus, der den Zugriff auf eine begrenzte Anzahl von Diensten für die Verwendung in benutzerdefinierten Tabellenfunktionen ermöglicht. Für einige dieser Dienste, einschließlich des Lesezugriffs auf den Tabellendienst, ist normalerweise eine Autorisierung erforderlich. Sie sind jedoch zulässig, wenn sie in einer benutzerdefinierten Funktion verwendet werden. Da benutzerdefinierte Funktionen keinen Ereignisparameter enthalten, wird dieser Wert nie zurückgegeben. Er wird nur dokumentiert, um zu zeigen, dass benutzerdefinierte Funktionen in einem eigenen Autorisierungsmodus ausgeführt werden.
LIMITEDEnumEin Modus, der den Zugriff auf eine begrenzte Anzahl von Diensten ermöglicht. Dieser Modus tritt auf, wenn ein Add-on oder ein Skript, das an ein Dokument gebunden ist, einen einfachen Trigger vom Typ onOpen(e) oder onEdit(e) ausführt, mit Ausnahme des für NONE beschriebenen Falls.
FULLEnumEin Modus, der Zugriff auf alle Dienste gewährt, für die eine Autorisierung erforderlich ist. Dieser Modus tritt auf, wenn ein Add-on oder ein Script durch einen anderen Trigger als die für LIMITED oder NONE beschriebenen Fälle ausgeführt wird.