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
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getAuthorizationStatus() | AuthorizationStatus | 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 ). |
getAuthorizationUrl() | String | Ruft 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