Esta página foi traduzida pela API Cloud Translation.

Class AuthorizationInfo

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