Cette page a été traduite par l'API Cloud Translation.

Class AuthorizationInfo

Objet utilisé pour déterminer si l'utilisateur doit autoriser ce script à utiliser un ou plusieurs services, et pour fournir l'URL d'une boîte de dialogue d'autorisation. Si le script est publié en tant que composant complémentaire qui utilise des déclencheurs installables, ces informations peuvent être utilisées pour contrôler l'accès aux sections de code pour lesquelles l'utilisateur ne dispose pas de l'autorisation nécessaire. Le module complémentaire peut également demander à l'utilisateur d'ouvrir l'URL de la boîte de dialogue d'autorisation pour résoudre le problème.

Cet objet est renvoyé par ScriptApp.getAuthorizationInfo(authMode). Dans la quasi-totalité des 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éthode	Type renvoyé	Brève description
`getAuthorizationStatus()`	`AuthorizationStatus`	Récupère une valeur qui indique si l'utilisateur doit autoriser ce script à utiliser un ou plusieurs services (par exemple, `ScriptApp.AuthorizationStatus.REQUIRED`).
`getAuthorizationUrl()`	`String`	Récupère l'URL d'autorisation permettant d'accorder l'accès au script.

Documentation détaillée

`getAuthorizationStatus()`

Récupère 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()`

Récupère l'URL d'autorisation permettant d'accorder l'accès au script. Cette méthode renvoie null si aucune autorisation n'est requise. La page associée à l'URL se ferme 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 : URL pouvant être utilisée pour autoriser le script