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 module complémentaire utilisant des déclencheurs installables, ces informations peuvent servir à contrôler l'accès aux sections de code pour lesquelles l'utilisateur ne dispose pas des autorisations nécessaires. 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 presque tous les cas, les scripts doivent appeler ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL), car aucun autre mode d'autorisation ne nécessite que les utilisateurs accordent une autorisation.

Méthodes

Méthode	Type renvoyé	Brève description
`getAuthorizationStatus()`	`AuthorizationStatus`	Récupère une valeur indiquant 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 qui peut être utilisée pour accorder l'accès au script.

Documentation détaillée

`getAuthorizationStatus()`

Récupère une valeur indiquant 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).
var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationStatus());

Renvois

AuthorizationStatus : état d'autorisation

`getAuthorizationUrl()`

Récupère 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 au niveau de l'URL se ferme automatiquement si l'utilisateur y accède et si le script ne nécessite aucune autorisation.

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

Renvois

String : URL pouvant être utilisée pour autoriser le script