Enum AuthMode

AuthMode

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

Um eine Enumeration aufzurufen, rufen Sie die übergeordnete Klasse, den Namen und das Attribut 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();
}

Properties

Attribut	Typ	Beschreibung
NONE	Enum	Ein Modus, der den Zugriff auf alle Dienste verhindert, für die eine Autorisierung erforderlich ist. Dieser Modus tritt ein, wenn ein Add-on einen onOpen(e) einfachen Trigger ausführt und der Nutzer das Add-on in einem anderen Dokument installiert hat, das Add-on aber nicht im aktuellen Dokument verwendet wurde.
CUSTOM_FUNCTION	Enum	Ein Modus, der den Zugriff auf eine begrenzte Teilmenge von Diensten zur Verwendung in benutzerdefinierten Tabellenfunktionen ermöglicht. Für einige dieser Dienste, einschließlich des schreibgeschützten Zugriffs auf den Tabellendienst, ist normalerweise eine Autorisierung erforderlich. Sie sind jedoch 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 wird nur dokumentiert, um zu zeigen, dass benutzerdefinierte Funktionen in einem eigenen Autorisierungsmodus ausgeführt werden.
LIMITED	Enum	Ein Modus, der den Zugriff auf eine begrenzte Teilmenge von Diensten ermöglicht. Dieser Modus tritt ein, wenn ein Add-on oder ein Skript gebunden an ein Dokument einen onOpen(e) oder onEdit(e) einfachen Trigger ausführt, außer im Fall von NONE.
FULL	Enum	Ein Modus, der den Zugriff auf alle Dienste ermöglicht, für die eine Autorisierung erforderlich ist. Dieser Modus tritt ein, wenn ein Add-on oder ein Skript als Ergebnis eines anderen Triggers als in den Fällen für LIMITED oder NONE ausgeführt wird.