A API Google Apps Script exige diferentes tipos de autorizações, dependendo do seu objetivo:
- Usar a API Apps Script no seu app.
- Permitir que outros aplicativos gerenciem os dados ou implantações do seu 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 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 na nuvem do Google do aplicativo. Depois de ativar a API Apps Script, você pode criar credenciais OAuth e fazer o download do ID do cliente e da chave secreta para incluir no aplicativo. Também é possível monitorar o uso da API no console do Google Cloud.
Você pode usar o assistente de ativação da API para criar ou selecionar um projeto na nuvem do Google Cloud no console do Google Cloud e ativar a API automaticamente. Como alternativa, você pode 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 do cliente e chaves secretas do cliente para seus aplicativos 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 da autorização para um aplicativo.
Conceder acesso a aplicativos de terceiros aos seus projetos de script
A API Apps Script pode permitir que os aplicativos criem e modifiquem seus scripts e suas implantações. Isso pode levar a uma situação ruim se você autorizar um aplicativo de terceiros malicioso que cria mais scripts maliciosos ou modifica 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. Você precisa conceder acesso explicitamente à API antes de usar qualquer aplicativo que crie ou modifique scripts ou implantações. Depois de conceder acesso à API aos seus scripts, os aplicativos autorizados poderão usar a API para gerenciar seus projetos de script.
Um erro ocorre se você tentar executar um aplicativo afetado sem conceder acesso à API. Esse erro ocorre depois que você autoriza o aplicativo.
Você pode conceder acesso à 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ê está fazendo 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 os aplicativos modifiquem seus scripts. Nunca autorize um aplicativo que você suspeite ser malicioso.