Class AuthorizationInfo

AutorisierungInfo

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

Einige Skriptausführungen können ohne die Einwilligung des Nutzers zu allen erforderlichen Bereichen gestartet werden, die vom Skript 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 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()String|nullRuft die Autorisierungs-URL ab, mit der Zugriff auf das Skript gewährt werden kann.
getAuthorizedScopes()String[]|nullRuft eine Liste der autorisierten Bereiche für das Skript ab.

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).
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationStatus());

Rückflug

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 darauf zugegriffen wird und für das Skript keine Autorisierung erforderlich ist. 

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

Rückflug

String|null – eine URL, die zum Autorisieren des Skripts verwendet werden kann

getAuthorizedScopes()

Ruft eine Liste der autorisierten Bereiche für das Skript 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[]|null: Die Liste der autorisierten Bereiche.