Class AuthorizationInfo

Informazioni sull'autorizzazione

Un oggetto che verifica se l'utente ha concesso l'autorizzazione per gli ambiti richiesti dello script. L'oggetto fornisce anche un URL di autorizzazione per consentire agli utenti di concedere queste autorizzazioni.

Alcune esecuzioni di script possono iniziare senza il consenso dell'utente per tutti gli ambiti richiesti utilizzati dall' script. Le informazioni in questo oggetto ti consentono di controllare l'accesso alle sezioni di codice che richiedono determinati ambiti e di richiedere l'autorizzazione di questi ambiti per le esecuzioni successive.

Questo oggetto viene restituito da ScriptApp.getAuthorizationInfo(authMode). In quasi tutti i casi, gli script devono chiamare ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL), poiché nessuna altra modalità di autorizzazione richiede che gli utenti ne concedano una.

Metodi

MetodoTipo restituitoBreve descrizione
getAuthorizationStatus()AuthorizationStatusRestituisce un valore che indica se l'utente deve autorizzare questo script a utilizzare uno o più servizi (ad es. ScriptApp.AuthorizationStatus.REQUIRED).
getAuthorizationUrl()StringRecupera l'URL di autorizzazione che può essere utilizzato per concedere l'accesso allo script.
getAuthorizedScopes()String[]Restituisce un elenco di ambiti autorizzati per lo script.

Documentazione dettagliata

getAuthorizationStatus()

Restituisce un valore che indica se l'utente deve autorizzare questo script a utilizzare uno o più servizi (ad es. ScriptApp.AuthorizationStatus.REQUIRED). 

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

Invio

AuthorizationStatus: lo stato dell'autorizzazione

getAuthorizationUrl()

Recupera l'URL di autorizzazione che può essere utilizzato per concedere l'accesso allo script. Questo metodo restituisce null se non è richiesta alcuna autorizzazione. La pagina all'URL si chiuderà automaticamente se viene visualizzata e lo script non richiede alcuna autorizzazione. 

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

Invio

String: un URL che può essere utilizzato per autorizzare lo script

getAuthorizedScopes()

Restituisce un elenco di ambiti autorizzati per lo script. Se vengono richieste informazioni di autorizzazione per un elenco specificato di ambiti, restituisce gli ambiti autorizzati dall'elenco specificato. 

// 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());

Invio

String[]: l'elenco degli ambiti autorizzati.