Class AuthorizationInfo

AuthorizationInfo

Ein Objekt, mit dem bestimmt wird, ob der Nutzer dieses Skript autorisieren muss, einen oder mehrere Dienste zu verwenden, und die URL für ein Autorisierungsdialogfeld bereitstellen. Wenn das Skript als Add-on mit installierbaren Triggern veröffentlicht wird, kann mit diesen Informationen der Zugriff auf Codeabschnitte gesteuert werden, 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 Skripts ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL) aufrufen, da kein anderer Autorisierungsmodus erfordert, dass Nutzer die Autorisierung erteilen.

Methoden

MethodeRückgabetypKurzbeschreibung
getAuthorizationStatus()AuthorizationStatusRuft einen Wert ab, der angibt, ob der Nutzer dieses Skript autorisieren muss, um einen oder mehrere Dienste zu verwenden (z. B. ScriptApp.AuthorizationStatus.REQUIRED).
getAuthorizationUrl()StringRuft die Autorisierungs-URL ab, mit der Zugriff auf das Skript gewährt werden kann.

Detaillierte Dokumentation

getAuthorizationStatus()

Ruft einen Wert ab, der angibt, ob der Nutzer dieses Skript autorisieren muss, um einen oder mehrere Dienste zu verwenden (z. B. ScriptApp.AuthorizationStatus.REQUIRED). 

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

Return

AuthorizationStatus: der Autorisierungsstatus

getAuthorizationUrl()

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

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

Return

String: eine URL, die zum Autorisieren des Skripts verwendet werden kann