Autorização para serviços do Google

O Apps Script exige autorização do usuário para acessar dados particulares de Serviços integrados do Google ou Serviços avançados do Google.

Como conceder direitos de acesso

O Apps Script determina os escopos de autorização (como acessar arquivos do Planilhas Google ou do Gmail) automaticamente com base em uma verificação do código. O código com comentários ainda pode gerar uma solicitação de autorização. Se um script precisar de autorização, você verá uma das caixas de diálogo de autorização mostradas aqui quando ele for executado.

Os scripts que você autorizou anteriormente também pedem autorização adicional se uma mudança de código adicionar novos serviços. Os scripts não podem solicitar autorização se você acessá-los como um app da Web executado sob a identidade do usuário do proprietário do script.

Como revogar direitos de acesso

Para revogar o acesso de um script aos seus dados, siga estas etapas:

  1. Acesse a página de permissões da sua Conta do Google. Para acessar essa página no futuro, acesse Google.com e clique na foto da sua conta, no canto superior direito da tela. Em seguida, clique em Minha conta, em Apps e sites conectados na seção "Login e segurança" e em Gerenciar aplicativos.
  2. Clique no nome do script com a autorização que você quer revogar. Em seguida, clique em Remover à direita e em OK na caixa de diálogo exibida.

Permissões e tipos de scripts

A identidade do usuário com que um script é executado e, portanto, os dados que ele pode acessar varia com base no cenário em que o script é executado, conforme mostrado na tabela abaixo.

Tipo de script O script é executado como...
Independente, complemento ou vinculado a Documentos, Planilhas, Apresentações ou Formulários Usuário no teclado
Função personalizada em uma planilha Usuário anônimo. No entanto, os limites de cota são contabilizados no uso do teclado
App da Web ou gadget do Google Sites Usuário como proprietário do teclado ou do script, de acordo com as opções selecionadas ao implantar o app
Gatilho instalável Usuário que criou o acionador

Escopos de autorização manual para os apps Planilhas, Documentos, Apresentações e Formulários

Se você estiver criando um complemento ou outro script que use o serviço de planilhas, o serviço de documentos, o serviço de Apresentações ou o serviço de Formulários, poderá forçar a caixa de diálogo de autorização a solicitar acesso apenas aos arquivos em que o complemento ou script é usado, em vez de todas as planilhas, documentos ou formulários de um usuário. Para fazer isso, inclua a seguinte anotação JsDoc em um comentário no nível do arquivo:

/**
 * @OnlyCurrentDoc
 */

Uma anotação oposta, @NotOnlyCurrentDoc, estará disponível se o script incluir uma biblioteca que declare @OnlyCurrentDoc, mas o script mestre, na verdade, exige acesso a mais recursos do que o arquivo atual.

Ciclo de vida da autorização para complementos

Os complementos dos apps Planilhas, Documentos, Apresentações e Formulários Google geralmente seguem o mesmo modelo de autorização que os scripts vinculados a um documento. No entanto, em determinadas circunstâncias, as funções onOpen(e) e onEdit(e) são executadas em um modo sem autorização que apresenta algumas outras complicações. Para mais informações, consulte o guia para o ciclo de vida de autorização de complementos.

Limites de usuários do aplicativo OAuth

Os aplicativos que usam o OAuth para acessar dados de usuários do Google, incluindo projetos do Apps Script, estão sujeitos a limites de autorização. Consulte os limites de usuários do aplicativo OAuth para mais detalhes.