O Apps Script exige autorização do usuário para acessar dados particulares de Serviços do Google integrados ou serviços avançados do Google.
Concessão de direitos de acesso
![](https://developers-dot-devsite-v2-prod.appspot.com/static/apps-script/images/new-auth-1.png?authuser=7&hl=pt)
![](https://developers-dot-devsite-v2-prod.appspot.com/static/apps-script/images/new-auth-2.png?authuser=7&hl=pt)
O Apps Script determina os escopos de autorização (como acessar o Planilhas Google arquivos ou Gmail) automaticamente, com base na leitura do código. Um código que é comentado ainda pode gerar uma solicitação de autorização. Se um script precisar autorização, você verá uma das caixas de diálogo de autorização mostradas aqui correr.
Os scripts que você autorizou anteriormente também pedem autorização 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 aplicativo da web executado em a identidade de 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 o página de permissões para sua Conta do Google. Para acessar esta página no futuro, acesse Google.com e clique na imagem da sua conta no canto superior direito da tela. Em seguida, clique em Minha conta e em Apps conectados e sites na "Fazer login e segurança" e em Gerenciar aplicativos.)
- Clique no nome do script cuja autorização você deseja revogar e, em seguida, Clique em Remove à 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, como mostrado na tabela a seguir.
Tipo de script | O script é executado como... |
---|---|
Independentes, complemento, ou vinculado ao Documentos, Planilhas, Apresentações ou Formulários Google | Usuário no teclado |
Função personalizada em uma planilha | Usuário anônimo No entanto, os limites de cota contar contra usuário no teclado |
App da Web ou Widget do Google Sites | Usuário no teclado ou proprietário do script, dependente 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 Planilhas; Serviço de documentos, serviço Apresentações ou Formulários, é possível forçar a autorização para 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 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
inclui uma biblioteca que declara
@OnlyCurrentDoc
, mas o script mestre realmente requer acesso a mais de
o arquivo atual.
Ciclo de vida de autorização para complementos
Complementos para o Planilhas, o Documentos, o Apresentações e o Formulários Google
geralmente seguem o mesmo modelo de autorização dos scripts
vinculado a um documento. Em determinados
circunstâncias, no entanto, as funções onOpen(e)
e onEdit(e)
são executadas em uma
o modo sem autorização que apresenta algumas complicações adicionais. Para mais
mais informações, consulte a
guia do ciclo de vida de autorização de complementos.
Limites de usuários do aplicativo OAuth
Aplicativos que usam OAuth para acessar dados de usuários do Google, incluindo aplicativos Os projetos de script estão sujeitos a limites de autorização. Consulte Limites de usuários do app OAuth para mais detalhes.