Class AuthorizationInfo

AutorizaçãoInformações

Um objeto usado para determinar se o usuário precisa autorizar esse script a usar um ou mais serviços 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, 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 ao usuário para abrir 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étodoTipo de retornoBreve descrição
getAuthorizationStatus()AuthorizationStatusRecebe um valor que indica se o usuário precisa autorizar esse script para usar um ou mais serviços (por exemplo, ScriptApp.AuthorizationStatus.REQUIRED).
getAuthorizationUrl()StringRecebe 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 para usar um ou mais serviços (por exemplo, ScriptApp.AuthorizationStatus.REQUIRED). 

// Log the authorization status (REQUIRED or NOT_REQUIRED).
const 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 se nenhuma autorização for necessária. A página no URL será fechada automaticamente se for acessada e o script não exigir nenhuma autorização. 

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

Retornar

String: um URL que pode ser usado para autorizar o script.