Esta página foi traduzida pela API Cloud Translation.

Class AuthorizationInfo

Um objeto usado para determinar se o usuário precisa autorizar esse script a usar um ou mais serviços e fornecer o URL para uma caixa de diálogo de autorização. Se o script for publicado como um complemento que usa acionadores instaláveis, essas informações poderão ser usadas para controlar o acesso a seções de código para as quais o usuário não tem a autorização necessária. Como alternativa, o complemento pode pedir que o usuário abra o URL da caixa de diálogo de autorização para resolver o problema.

Esse objeto é retornado por ScriptApp.getAuthorizationInfo(authMode). Em quase todos os casos, os scripts precisam chamar 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 esse 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 esse 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 retornará null se nenhuma autorização for necessária. A página no URL fechará automaticamente se for acessada e o script não exigir 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