Autorização para Serviços do Google

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

O Apps Script requer autorização de 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 automaticamente os escopos de autorização (como acessar os arquivos do Planilhas Google ou o Gmail) com base em uma verificação do código. O código comentado 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 exibidas aqui quando ele for executado.

Os scripts autorizados anteriormente também solicitam autorização adicional se uma alteração de código adicionar novos serviços. Os scripts não poderão solicitar autorização se você acessar o script como um app da Web executado na identidade do usuário do proprietário do script.

Revogação de direitos de acesso

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

  1. Acesse a página Permissões da sua Conta do Google. Para navegar até essa página no futuro, acesse google.com.br e clique na imagem da sua conta no canto superior direito da tela. Em seguida, clique em My Account > Connected apps & sites na seção "Sign-in & security" e depois em Manage Apps.
  2. Clique no nome do script cuja autorização você quer revogar e, em seguida, clique em Remover à direita e em OK na caixa de diálogo resultante.

Permissões e tipos de script

A identidade do usuário com que um script é executado (e, assim, os dados que ele pode acessar) varia de acordo com o 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; mas os limites de cota são contabilizados no teclado
App da Web ou gadget do Google Sites Usuário no proprietário do teclado ou do script, dependendo das opções selecionadas ao implantar o app
Gatilho instalável Usuário que criou o gatilho

Escopos de autorização manual para o 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 slides ou o serviço de formulários, poderá forçar a caixa de diálogo de autorização a solicitar apenas acesso aos arquivos em que o complemento ou script é usado, em vez de todos os documentos, planilhas 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 principal exigir acesso a mais do que o arquivo atual.

Ciclo de vida da autorização de complementos

Os complementos do Planilhas, do Documentos, do Apresentações e do 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 complicações adicionais. Para mais informações, consulte o guia do ciclo de vida da autorização dos complementos.

Limites de usuário para aplicativos OAuth

Os aplicativos que usam 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ário do aplicativo OAuth para mais detalhes.