A API Apps Script requer diferentes tipos de autorizações, dependendo da sua meta:
- Use a API Apps Script no seu app.
- Permita que outros aplicativos gerenciem os dados ou as implantações do projeto de script.
Se você precisa usar a API Apps Script no seu aplicativo, enable a API no projeto do Google Cloud do aplicativo. Isso permite que você crie credenciais do OAuth para que os usuários do aplicativo possam autorizá-las.
Se quiser permitir que aplicativos de terceiros gerenciem o conteúdo ou a implantação dos seus projetos de script, conceda acesso a eles.
Como usar a API Apps Script no seu app
Se você quiser usar a API Apps Script no seu app, ative-a no projeto do GCP do seu aplicativo. Depois de ativar a API Apps Script, crie credenciais do OAuth e faça o download do ID e da chave secreta do cliente para incluir no seu aplicativo. Também é possível monitorar o uso da API no console do Google Cloud.
É possível usar este assistente para criar ou selecionar um projeto do Google Cloud no Console de APIs e ativar a API automaticamente. Como alternativa, abra a página Gerenciar recursos do console, selecione um projeto e pesquise e adicione a API Apps Script manualmente usando o painel APIs e serviços do projeto. Depois de ativar a API, é possível criar credenciais do OAuth, IDs do cliente e chaves secretas dos clientes para seus aplicativos no painel APIs e serviços > Credenciais.
Os guias de início rápido da API Apps Script fornecem uma visão passo a passo de todo o processo de ativação da API e de configuração da autorização para um aplicativo.
Como conceder a apps de terceiros acesso aos seus projetos de script
A API Apps Script pode permitir que os aplicativos criem e modifiquem scripts e implantações. Isso pode levar a uma situação ruim se você autorizar um aplicativo malicioso de terceiros que, então, criará mais scripts maliciosos ou modificará o comportamento dos que você já tem.
Para reduzir esse risco, a API Apps Script não pode acessar seus projetos de script por padrão. Conceda explicitamente o acesso à API antes de usar qualquer aplicativo que crie ou modifique scripts ou implantações. Depois de conceder à API acesso aos scripts, os aplicativos que você autorizar poderão usar a API para gerenciar seus projetos de script.
Um erro será exibido se você tentar executar um aplicativo afetado sem conceder primeiro o acesso à API. Esse erro ocorre depois que você autoriza o aplicativo.
Você pode conceder à API Apps Script acesso aos seus projetos de script usando o painel do Apps Script. Também é possível usar o painel para revogar esse acesso a qualquer momento. Ao conceder acesso à API, você faz isso para todos os aplicativos. No entanto, aplicativos individuais ainda precisam ser autorizados.
Antes de conceder acesso, certifique-se de entender que há um risco envolvido em permitir que aplicativos modifiquem seus scripts. Nunca autorize aplicativos que você suspeite serem maliciosos.