Os usuários precisam autorizar projetos de script que acessem os dados ou agem nos próprios dados nome de usuário. Quando um usuário executa um script que requer autorização para a primeira momento, a interface apresenta um prompt para iniciar o fluxo de autorização.
Durante esse fluxo, a interface informa ao usuário o que o script precisa de permissão o que fazer. Por exemplo, um script pode querer permissão para ler o mensagens de e-mail ou criar eventos na agenda. O projeto de script define essas permissões individuais como escopos do OAuth.
Na maioria dos scripts, o Apps Script detecta automaticamente quais escopos necessários para você. você pode ver os escopos usados por um script a qualquer momento. Também é possível definir escopos explicitamente no seu manifesto usando strings de URL. Ambiente escopos às vezes é explicitamente necessário para certos aplicativos, complementos, já que os aplicativos publicados devem sempre use os escopos mais estreitos possíveis.
Durante o fluxo de autorização, o Apps Script apresenta
descrições dos escopos necessários para o usuário. Por exemplo, se seu script
precisar de acesso somente leitura às planilhas, o manifesto poderá ter o escopo
https://www.googleapis.com/auth/spreadsheets.readonly
: Durante o
fluxo de autorização, um script com esse escopo solicita que o usuário permita esta
aplicativo para "Visualizar suas Planilhas do Google".
Alguns escopos incluem outros. Por exemplo, ao autorizar o escopo
https://www.googleapis.com/auth/spreadsheets
permite acesso de leitura e gravação a
planilhas.
Como visualizar escopos
Para ver os escopos de que seu projeto de script exige no momento, faça o seguinte:
- Abra o projeto de script.
- À esquerda, clique em Visão geral.
- Confira os escopos em Escopos do OAuth do projeto.
Definir escopos explícitos
O Apps Script determina automaticamente quais escopos um script precisa lendo o código em busca de chamadas de função que as exijam. Para a maioria dos scripts, é suficiente e economiza tempo, mas, para complementos publicados, apps do Google Chat e chamadas para a API Google Chat, você precisa se exercitar mais controle direto dos escopos.
Às vezes, o Apps Script atribui automaticamente escopos muito permissivos aos projetos. Isso pode significar que seu script está pedindo ao usuário mais do que o necessário, o que é ruim prática. Nos scripts publicados, substitua escopos amplos por uma um conjunto mais limitado que cubra as necessidades do script e nada mais.
Para definir explicitamente os escopos usados pelo projeto de script, edite
o arquivo de manifesto. O campo do manifesto
oauthScopes
é uma matriz de todos os escopos usados pelo projeto. Para definir seu
escopos do projeto, faça o seguinte:
- Abra o projeto de script.
- À esquerda, clique em Configurações do projeto .
- Selecione a caixa de seleção Mostrar arquivo de manifesto "appsscript.json" no editor.
- À esquerda, clique em Editor .
- À esquerda, clique no arquivo
appsscript.json
. - Localize o campo de nível superior rotulado como
oauthScopes
. Se ele não estiver presente, em que você pode adicioná-lo. - O campo
oauthScopes
especifica uma matriz de strings. Para definir os escopos seu projeto usa, substitua o conteúdo dessa matriz pelos escopos que você que quer que ele use. Exemplo:{ ... "oauthScopes": [ "https://www.googleapis.com/auth/spreadsheets.readonly", "https://www.googleapis.com/auth/userinfo.email" ], ... }
- Na parte superior, clique em Salvar .
Verificação do OAuth
Certos escopos do OAuth são sensíveis porque permitem acesso aos recursos do Dados do usuário. Se o projeto de script usar escopos que permitem o acesso aos dados do usuário, o projeto deve passar Verificação do cliente OAuth antes de publicá-lo publicamente como um aplicativo da web ou complemento. Para mais informações, consulte estes guias:
- Verificação do cliente OAuth para o Apps Script
- Apps não verificados
- Perguntas frequentes sobre a verificação do OAuth
- Serviço de APIs do Google: política de dados do usuário
Escopos restritos
Além dos escopos confidenciais, alguns são classificados como restrito e estão sujeitos a regras adicionais que ajudam a proteger os dados do usuário. Se você pretende publicar um app da Web ou complemento que usa um ou mais escopos restritos, o app precisa obedecer a todas as restrições especificadas antes da publicação.
Consulte a lista completa de escopos restritos antes de tentar publicar. Caso seu app use algum deles, você precisa obedecer às regras com o Consulte a seção Outros requisitos para escopos específicos da API antes da publicação.