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.
Concessão de direitos de acesso
O Apps Script determina os escopos de autorização automaticamente (como acesso aos arquivos do Planilhas Google ou Gmail) com base na leitura 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 será exibida aqui quando ele for executado.
Os scripts que você autorizou anteriormente também pedem autorização adicional se uma alteração 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 com a identidade do usuário do proprietário do script.
Revogação de 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, Aplicativos e sites conectados na seção "Login e segurança" e Gerenciar aplicativos.
- 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 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 de acordo com o cenário em que o script é executado, conforme mostrado na tabela abaixo.
| Tipo de script | O script é executado como... |
|---|---|
| Independentes, complementos ou vinculados 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 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 os apps 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 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 exigir acesso a mais do que o arquivo atual.
Ciclo de vida de autorização para complementos
Os complementos do Planilhas, Documentos, Apresentações e Formulários Google geralmente seguem o mesmo modelo de autorização dos 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 do 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 Limites de usuários do aplicativo OAuth para mais detalhes.