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 a tutti gli ambiti richiesti utilizzati dallo script. Le informazioni contenute in questo oggetto ti consentono di controllare l'accesso a sezioni di codice che richiedono determinati ambiti e di richiedere l'autorizzazione di questi ambiti per le esecuzioni successive.

Questo oggetto verrà restituito entro il giorno ScriptApp.getAuthorizationInfo(authMode). Quasi sempre, gli script devono chiamare ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL), poiché nessun'altra modalità di autorizzazione richiede che gli utenti concedano l'autorizzazione.

Metodi

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

Documentazione dettagliata

getAuthorizationStatus()

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

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

Indietro

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 eseguito l'accesso 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());

Indietro

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

getAuthorizedScopes()

Recupera un elenco di ambiti autorizzati per lo script. Se vengono richieste informazioni di autorizzazione per un elenco specifico 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());

Indietro

String[]|null: l'elenco degli ambiti autorizzati.