A API Apps Script exige 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 implantações do seu projeto de script.
Se você precisar usar a API Apps Script no seu app, ative a API no projeto do Google Cloud do app. 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 seu aplicativo. Depois de ativar a API Apps Script, você pode criar credenciais OAuth e fazer 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.
Use este assistente para criar ou selecionar um projeto do Google Cloud no console de API 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, você pode criar credenciais OAuth, IDs de cliente e segredos de cliente para seus apps no painel APIs e serviços > Credenciais.
Os Guias de início rápido da API Apps Script oferecem uma visão detalhada de todo o processo de ativação da API e configuração de autorização para um aplicativo.
Como conceder acesso a apps de terceiros aos seus projetos de script
A API Apps Script pode permitir 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 de terceiros malicioso, que passa a criar mais scripts maliciosos ou modificar o comportamento dos scripts que você já tem.
Para ajudar a reduzir esse risco, a API Apps Script não pode acessar seus projetos de script por padrão. É necessário conceder explicitamente o acesso à API antes de usar qualquer aplicativo que crie ou modifique scripts ou implantações. Depois de conceder o acesso da API aos scripts, os aplicativos que você autorizar poderão usar a API para gerenciar seus projetos de script.
Um erro vai ocorrer se você tentar executar um aplicativo afetado sem conceder o acesso à API primeiro. Esse erro ocorre depois que você autoriza o app.
É possível conceder à API Apps Script acesso 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. Quando você concede o acesso à API, isso é feito para todos os aplicativos. No entanto, os aplicativos individuais ainda precisam ser autorizados.
Antes de conceder o acesso, entenda que há um risco envolvido ao permitir que os aplicativos modifiquem seus scripts. Nunca autorize um aplicativo que você suspeita que seja malicioso.