Enum AuthMode

AuthMode

Eine Aufzählung, die angibt, welche Kategorien autorisierter Dienste Apps Script über eine ausgelöste Funktion ausführen kann. Diese Werte werden in ausgelösten Funktionen als authMode-Attribut des Ereignisparameters e bereitgestellt. Weitere Informationen finden Sie im Leitfaden zum Autorisierungslebenszyklus für Add-ons.

Um eine Enum aufzurufen, rufen Sie ihre übergeordnete Klasse, ihren Namen und ihre Eigenschaft auf. Beispiel: 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();
}

Attribute

Property	Typ	Beschreibung
NONE	Enum	Ein Modus, der keinen Zugriff auf Dienste zulässt, für die eine Autorisierung erforderlich ist. Dieser Modus tritt auf, wenn ein Add-on einen einfachen 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_FUNCTION	Enum	Ein Modus, der den Zugriff auf eine begrenzte Teilmenge von Diensten zur Verwendung in benutzerdefinierten Tabellenfunktionen ermöglicht. Einige dieser Dienste – einschließlich des Lesezugriffs auf den Tabellendienst – erfordern normalerweise eine Autorisierung, sind aber ohne Autorisierung zulässig, wenn sie in einer benutzerdefinierten Funktion verwendet werden. Da benutzerdefinierte Funktionen keinen Ereignisparameter enthalten, wird dieser Wert nie zurückgegeben. Er dient nur zur Veranschaulichung, dass benutzerdefinierte Funktionen in ihrem eigenen Autorisierungsmodus ausgeführt werden.
LIMITED	Enum	Ein Modus, der Zugriff auf eine begrenzte Teilmenge von Diensten ermöglicht. Dieser Modus tritt auf, wenn ein Add-on oder ein Skript, das an ein Dokument gebunden ist, einen einfachen onOpen(e)- oder onEdit(e)-Trigger ausführt, mit Ausnahme des für NONE beschriebenen Falles.
FULL	Enum	Ein Modus, der den Zugriff auf alle Dienste ermöglicht, für die eine Autorisierung erforderlich ist. Dieser Modus tritt auf, wenn ein Add-on oder ein Skript als Ergebnis eines beliebigen Triggers ausgeführt wird, der nicht den für LIMITED oder NONE beschriebenen Fällen entspricht.