A API Google 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.
Para usar a API Apps Script no seu aplicativo, ative a API no projeto do Google Cloud do aplicativo. Isso permite criar credenciais do OAuth para que os usuários do aplicativo possam autorizá-lo.
Para permitir que aplicativos de terceiros gerenciem o conteúdo ou a implantação dos seus projetos de script, conceda acesso a eles.
Usar a API Apps Script no seu app
Para usar a API Apps Script no seu app, ative a API Apps Script no projeto do Google Cloud do aplicativo. Depois de ativar a API Apps Script, crie credenciais OAuth e baixe o ID do cliente e a chave secreta para incluir no aplicativo. Também é possível monitorar o uso da API no console do Google Cloud.
Use o assistente de ativação de API para criar ou selecionar um projeto na nuvem do Google Cloud no console do Google Cloud e ativar automaticamente a API. 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, crie credenciais OAuth, IDs e segredos 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.
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 então 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 primeiro conceder o acesso à API, vai ocorrer um erro. 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 acesso à API, você faz isso para todos os aplicativos. No entanto, os aplicativos individuais ainda precisam ser autorizados.
Antes de conceder acesso, entenda o risco envolvido em permitir que aplicativos modifiquem seus scripts. Nunca autorize um aplicativo que você suspeite ser malicioso.