Enum AuthMode

AuthMode

Eine Aufzählung, die angibt, welche Kategorien von autorisierten Diensten 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 findest du im Leitfaden zum Autorisierungslebenszyklus für Add-ons.

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 erfordert, für die eine Autorisierung erforderlich ist. Dieser Modus wird verwendet, 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 jedoch nicht im aktuellen Dokument verwendet wurde.
CUSTOM_FUNCTION	Enum	Ein Modus, der den Zugriff auf eine begrenzte Anzahl von Diensten für benutzerdefinierte Tabellenfunktionen ermöglicht. Für einige dieser Dienste, einschließlich des schreibgeschützten Zugriffs auf den Tabellendienst, ist normalerweise eine Autorisierung erforderlich. Bei Verwendung in einer benutzerdefinierten Funktion sind sie jedoch ohne Autorisierung zulässig. Da benutzerdefinierte Funktionen keinen Ereignisparameter enthalten, wird dieser Wert nie zurückgegeben. Er wird nur dokumentiert, um zu zeigen, dass benutzerdefinierte Funktionen in ihrem eigenen Autorisierungsmodus ausgeführt werden.
LIMITED	Enum	Ein 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 Falls für NONE.
FULL	Enum	Ein Modus, der den Zugriff auf alle Dienste erlaubt, die eine Autorisierung erfordern. Dieser Modus tritt auf, wenn ein Add-on oder ein Skript als Ergebnis eines anderen Triggers als den für LIMITED oder NONE beschriebenen Fällen ausgeführt wird.