Ativar autorização e acesso ao script

A API Apps Script requer diferentes tipos de autorizações, dependendo do seu objetivo:

  • Use a API Apps Script no seu app.
  • Permita que outros aplicativos gerenciem as implantações ou os dados do projeto de script.

Se você precisar usar a API Apps Script no seu aplicativo, enable a API no projeto do Google Cloud do aplicativo. Com isso, você cria 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 projetos de script, conceda acesso a eles.

Como usar a API Apps Script no seu app

Para 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 OAuth e faça o download do ID do cliente e da chave secreta 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 automaticamente a API. Outra opção é abrir a página Gerenciar recursos do console, selecionar um projeto, pesquisar e adicionar a API Apps Script manualmente usando o painel APIs e serviços do projeto. Depois de ativar a API, é possível criar credenciais OAuth, IDs de 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 fornecem uma visão detalhada de todo o processo de ativação da API e configuração da autorização de um aplicativo.

Como conceder a aplicativos de terceiros acesso aos seus projetos de script.

A API Apps Script pode permitir que aplicativos criem e modifiquem seus scripts e as implantações deles. Isso pode resultar em 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 reduzir esse risco, por padrão, a API Apps Script não pode acessar seus projetos de script. Você precisa conceder acesso explicitamente à API antes de usar qualquer aplicativo que crie ou modifique scripts ou implantações. Depois de conceder à API acesso aos seus scripts, os aplicativos autorizados poderão usar a API para gerenciar os projetos de script.

Se você tentar executar um aplicativo afetado sem conceder acesso à API antes, ocorrerá um erro. Esse erro ocorre depois que você autorizar 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, os aplicativos individuais ainda precisam ser autorizados.

Antes de conceder acesso, entenda que há risco de permitir que os aplicativos modifiquem seus scripts. Nunca autorize um aplicativo que você suspeita que seja malicioso.