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 aos 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 teclado ou proprietário do script, dependendo das opções selecionadas ao implantar o app |
| Acionável 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 o serviço de planilhas, serviço de documentos, serviço de Apresentações ou serviço de Formulários, é possível forçar a caixa de diálogo de autorização a solicitar apenas o acesso 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 realmente exige 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 sem autorização que apresenta algumas complicações adicionais. Para mais
informações, consulte o
guia sobre o ciclo de vida da 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.