Class AuthorizationInfo

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 de 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 solicitar 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étodoTipo de retornoBreve descrição
getAuthorizationStatus()AuthorizationStatusRecebe 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()StringExtrai 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());

Retorno

AuthorizationStatus: o status da autorização


getAuthorizationUrl()

Extrai 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 será fechada automaticamente se for acessada e o script não requer autorização.

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

Retorno

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