Class AuthorizationInfo

Autorisierungsinformationen

Ein Objekt, mit dem ermittelt wird, ob der Nutzer dieses Script für die Verwendung eines oder mehrerer Dienste autorisieren muss, und mit dem die URL für ein Autorisierungsdialogfeld angegeben wird. Wenn das Script als Add-on veröffentlicht wird, das installierbare Trigger verwendet, können diese Informationen verwendet werden, um den Zugriff auf Codeabschnitte zu steuern, für die der Nutzer nicht die erforderliche Autorisierung hat. Alternativ kann das Add-on den Nutzer auffordern, die URL für das Autorisierungsdialogfeld zu öffnen, um das Problem zu beheben.

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.

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: URL, mit der das Script autorisiert werden kann