O Apps Script exige a autorização do usuário para acessar dados particulares de serviços integrados do Google ou avançados do Google.
Conceder direitos de acesso
O Apps Script determina os escopos de autorização (como acesso aos arquivos das Planilhas Google ou ao Gmail) automaticamente 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, uma das caixas de diálogo de autorização mostradas aqui vai aparecer quando ele for executado.
Os scripts que você autorizou anteriormente também solicitam autorização adicional se uma mudança de código adicionar novos serviços. Os scripts não podem solicitar autorização se você acessar o script 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 a seus dados, siga estas etapas:
- Acesse a página de permissões da sua Conta do Google. Para navegar até 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 e, em seguida, em Apps e sites conectados na seção "Fazer login e segurança" e, em seguida, em Gerenciar apps.
- Clique no nome do script cuja autorização você quer revogar e clique em Remover à direita. Em seguida, clique em OK na caixa de diálogo resultante.
Permissões e tipos de scripts
A identidade do usuário com que um script é executado, e, portanto, os dados que ele pode acessar, variam 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 para o usuário no teclado. |
| App da Web ou gadget do Google Sites | Usuário no proprietário do teclado ou script, dependendo das opções selecionadas ao implantar o app |
| Gatilho instalável | Usuário que criou o acionador |
Escopos de autorização manual para Planilhas, Documentos, Apresentações e Formulários
Se você estiver criando um complemento ou outro script que use os serviços Planilhas, Documentos, Apresentações ou Formulários, force 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 do 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 realmente exigir acesso a mais do que o arquivo atual.
Ciclo de vida de autorização para complementos
Os complementos para Planilhas, Documentos, Apresentações e Formulários Google
geralmente seguem o mesmo modelo de autorização dos scripts que são
vinculados a um documento. No entanto, em determinadas
circunstâncias, as funções onOpen(e) e onEdit(e) são executadas em um
modo não autorizado que apresenta algumas outras complicações. Para mais
informações, consulte o
guia do ciclo de vida de autorização de complementos.
Limites de usuários de aplicativos OAuth
Os aplicativos que usam o OAuth para acessar dados do usuário do Google, incluindo projetos do Apps Script, estão sujeitos a limites de autorização. Consulte Limites de usuários de aplicativos OAuth para mais detalhes.