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

Attribut	Typ	Beschreibung
NONE	Enum	Ein 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_FUNCTION	Enum	Ein 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.
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 für NONE beschriebenen Falls.
FULL	Enum	Ein 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.