Objeto usado para determinar se o usuário precisa autorizar o script a usar um ou mais e fornecer o URL de uma caixa de diálogo de autorização. Se o script for publicado como um complemento que usa gatilhos instaláveis, essa informação poderá ser usada. controlar o acesso a seções de código para as quais o usuário não tem a autorização necessária. Alternativamente, o complemento pode solicitar que o usuário abra o URL para a caixa de diálogo de autorização para resolver o problema.
Esse objeto é retornado por ScriptApp.getAuthorizationInfo(authMode). Em quase
em todos os casos, os scripts chamarão ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL),
já que nenhum outro modo de autorização exige
que os usuários concedam autorização.
Métodos
| Método | Tipo de retorno | Breve descrição |
|---|---|---|
getAuthorizationStatus() | AuthorizationStatus | Recebe um valor que indica se o usuário precisa autorizar o script a usar um ou mais
serviços (por exemplo, ScriptApp.AuthorizationStatus.REQUIRED). |
getAuthorizationUrl() | String | Recebe o URL de autorização que pode ser usado para conceder acesso ao script. |
Documentação detalhada
getAuthorizationStatus()
Recebe um valor que indica se o usuário precisa autorizar o script a usar um ou mais
serviços (por exemplo, ScriptApp.AuthorizationStatus.REQUIRED).
// Log the authorization status (REQUIRED or NOT_REQUIRED). var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL); Logger.log(authInfo.getAuthorizationStatus());
Retornar
AuthorizationStatus: o status da autorização.
getAuthorizationUrl()
Recebe o URL de autorização que pode ser usado para conceder acesso ao script. Esse método retorna
null quando nenhuma autorização é necessária. A página no URL fechará automaticamente se
ele é acessado e o script não requer nenhuma autorização.
// Log the URL used to grant access to the script. var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL); Logger.log(authInfo.getAuthorizationUrl());
Retornar
String: um URL que pode ser usado para autorizar o script