Class AuthorizationInfo

Autorisierungsinformationen

Ein Objekt, das prüft, ob der Nutzer die Autorisierung für die erforderlichen Bereiche des Scripts erteilt hat. Das Objekt enthält auch eine Autorisierungs-URL, über die Nutzer diese Berechtigungen gewähren können.

Einige Scriptausführungen können gestartet werden, ohne dass der Nutzer seine Einwilligung für alle erforderlichen Bereiche erteilt hat, die vom Script verwendet werden. Mit den Informationen in diesem Objekt können Sie den Zugriff auf Codeabschnitte steuern, für die bestimmte Bereiche erforderlich sind, und die Autorisierung dieser Bereiche für nachfolgende Ausführungen anfordern.

Dieses Objekt wird von ScriptApp.getAuthorizationInfo(authMode) zurückgegeben. In fast allen Fällen sollten Scripts ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL) aufrufen, da bei keinem anderen Autorisierungsmodus Nutzer die Autorisierung erteilen müssen.

Methoden

MethodeRückgabetypKurzbeschreibung
getAuthorizationStatus()AuthorizationStatusGibt einen Wert zurück, der angibt, ob der Nutzer dieses Script für die Verwendung eines oder mehrerer Dienste autorisieren muss (z. B. ScriptApp.AuthorizationStatus.REQUIRED).
getAuthorizationUrl()StringRuft die Autorisierungs-URL ab, mit der Zugriff auf das Script gewährt werden kann.
getAuthorizedScopes()String[]Ruft eine Liste der autorisierten Bereiche für das Script ab.

Detaillierte Dokumentation

getAuthorizationStatus()

Gibt einen Wert zurück, der angibt, ob der Nutzer dieses Script für die Verwendung eines oder mehrerer Dienste autorisieren muss (z. B. ScriptApp.AuthorizationStatus.REQUIRED). 

// Log the authorization status (REQUIRED or NOT_REQUIRED).
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationStatus());

Rückflug

AuthorizationStatus – Autorisierungsstatus

getAuthorizationUrl()

Ruft die Autorisierungs-URL ab, mit der Zugriff auf das Script gewährt werden kann. Diese Methode gibt null zurück, wenn keine Autorisierung erforderlich ist. Die Seite mit der URL wird automatisch geschlossen, wenn darauf zugegriffen wird und das Script keine Autorisierung erfordert. 

// Log the URL used to grant access to the script.
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationUrl());

Rückflug

String: eine URL, mit der das Script autorisiert werden kann

getAuthorizedScopes()

Ruft eine Liste der autorisierten Bereiche für das Script ab. Wenn Autorisierungsinformationen für eine bestimmte Liste von Bereichen angefordert werden, werden die autorisierten Bereiche aus der angegebenen Liste zurückgegeben. 

// Logs which scopes in the specified list have been authorized for the script.
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL, [
  'https: //www.googleapis.com/auth/documents',
  'https: //www.googleapis.com/auth/spreadsheets',
]);
Logger.log(authInfo.getAuthorizedScopes());

Rückflug

String[]: Liste der autorisierten Bereiche.