A API Apps Script exige diferentes tipos de autorizações dependendo da sua meta:
- Use a API Apps Script no seu app.
- Permitir que outros aplicativos gerenciem os dados ou implantações do projeto de script.
Se você precisar usar a API Apps Script no seu aplicativo, ative a API no projeto do Google Cloud do aplicativo. Isso permite que você crie credenciais OAuth para que os usuários do aplicativo possam autorizá-lo.
Se você 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 API Apps Script no projeto do GCP do aplicativo. Depois de ativar a API Apps Script, crie credenciais OAuth e baixe o ID e a chave secreta do cliente para incluir no aplicativo. Também é possível monitorar o uso da API no console do Google Cloud.
Use este assistente para criar ou selecionar um projeto do Google Cloud no console de API e ativar a API automaticamente. Outra opção é abrir a página Gerenciar recursos do console, selecionar um projeto e pesquisar e adicionar a API Apps Script manualmente usando o painel APIs e serviços do projeto. Depois de ativar a API, você pode criar credenciais OAuth, IDs de cliente e secrets de cliente para seus aplicativos no painel APIs e serviços > Credenciais.
Os inícios rápidos da API Apps Script mostram o processo completo de ativação da API e configuração da autorização para um aplicativo.
Como conceder acesso a aplicativos de terceiros aos seus projetos de script
A API Apps Script permite que os aplicativos criem e modifiquem seus scripts e as implantações deles. Isso pode levar a uma situação ruim se você autorizar um aplicativo malicioso de terceiros que cria mais scripts maliciosos ou modifica o comportamento de scripts que você já tem.
Para reduzir esse risco, a API Apps Script não pode acessar seus projetos de script por padrão. Você precisa conceder acesso à API explicitamente antes de usar qualquer aplicativo que crie ou modifique scripts ou implantações. Depois de conceder acesso da API aos seus scripts, os aplicativos autorizados poderão usar a API para gerenciar seus projetos de script.
Se você tentar executar um aplicativo afetado sem conceder acesso à API, um erro vai ocorrer. Esse erro ocorre depois que você autoriza o aplicativo.
Você pode conceder acesso da API Apps Script aos seus projetos de script usando o painel do Apps Script. Você também pode usar o painel para revogar esse acesso a qualquer momento. Ao conceder o acesso à API, você faz isso para todos os aplicativos. No entanto, os aplicativos individuais ainda precisam ser autorizados.
Antes de conceder acesso, entenda que há um risco envolvido em permitir que aplicativos modifiquem seus scripts. Nunca autorize um aplicativo que você suspeita ser malicioso.