Class AuthorizationInfo

AuthorizationInfo

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 che gli utenti possono utilizzare per 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 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). Nella maggior parte dei casi, gli script devono chiamare ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL), poiché nessun'altra modalità di autorizzazione richiede che gli utenti concedano l'autorizzazione.

Metodi

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

Documentazione dettagliata

getAuthorizationStatus()

Ottiene 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()

Ottiene 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 chiude 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()

Ottiene un elenco degli ambiti autorizzati per lo script. Se vengono richieste informazioni sull'autorizzazione per un elenco di ambiti specificato, vengono restituiti 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.