Class AuthorizationInfo

Informations sur l'autorisation

Objet qui vérifie si l'utilisateur a accordé l'autorisation pour les niveaux d'accès requis du script. L'objet fournit également une URL d'autorisation permettant aux utilisateurs d'accorder ces autorisations.

Certaines exécutions de scripts peuvent démarrer sans le consentement de l'utilisateur pour toutes les habilitations requises utilisées par le script. Les informations de cet objet vous permettent de contrôler l'accès aux sections de code qui nécessitent certains niveaux d'accès et de demander l'autorisation de ces niveaux d'accès pour les exécutions ultérieures.

Cet objet est renvoyé par ScriptApp.getAuthorizationInfo(authMode). Dans presque tous les cas, les scripts doivent appeler ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL), car aucun autre mode d'autorisation n'exige que les utilisateurs accordent une autorisation.

Méthodes

MéthodeType renvoyéBrève description
getAuthorizationStatus()AuthorizationStatusObtient une valeur qui indique si l'utilisateur doit autoriser ce script à utiliser un ou plusieurs services (par exemple, ScriptApp.AuthorizationStatus.REQUIRED).
getAuthorizationUrl()String|nullObtient l'URL d'autorisation qui peut être utilisée pour accorder l'accès au script.
getAuthorizedScopes()String[]|nullObtient la liste des champs d'application autorisés pour le script.

Documentation détaillée

getAuthorizationStatus()

Obtient une valeur qui indique si l'utilisateur doit autoriser ce script à utiliser un ou plusieurs services (par exemple, ScriptApp.AuthorizationStatus.REQUIRED). 

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

Renvois

AuthorizationStatus : état de l'autorisation

getAuthorizationUrl()

Obtient l'URL d'autorisation qui peut être utilisée pour accorder l'accès au script. Cette méthode renvoie null si aucune autorisation n'est requise. La page à l'URL se fermera automatiquement si elle est consultée et que le script ne nécessite aucune autorisation. 

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

Renvois

String|null : URL permettant d'autoriser le script

getAuthorizedScopes()

Obtient la liste des champs d'application autorisés pour le script. Si des informations d'autorisation sont demandées pour une liste de champs d'application spécifiée, renvoie les champs d'application autorisés à partir de la liste spécifiée. 

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

Renvois

String[]|null : liste des champs d'application autorisés.