Objet utilisé pour déterminer si l'utilisateur doit autoriser ce script à utiliser une ou plusieurs et de 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, cette information peut être utilisée pour 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 pour que la boîte de dialogue d'autorisation se résolve le problème.
Cet objet est renvoyé par ScriptApp.getAuthorizationInfo(authMode). Dans presque
Dans 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 qui indique si l'utilisateur doit autoriser ce script à utiliser une ou plusieurs
(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 une ou plusieurs
(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 permettant d'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
il est accessible et 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