Como ativar a autorização e o acesso a scripts

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

A API Apps Script requer 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 as implantações do seu projeto de script.

Se você precisar usar a API Apps Script no seu aplicativo, ative a API no projeto do Cloud Platform (GCP) do aplicativo. Assim, é possível criar credenciais do OAuth para que os usuários do aplicativo possam autorizá-lo.

Se quiser permitir que aplicativos de terceiros gerenciem o conteúdo ou a implantação dos seus projetos de script, conceda acesso aos seus projetos de script.

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 do OAuth e fazer o download do ID e da chave secreta do cliente a serem incluídos no aplicativo. Também é possível monitorar o uso da API no Console do Google Cloud Platform.

Use este assistente para criar ou selecionar um projeto do GCP no Console de APIs e ativá-la automaticamente. Como alternativa, é possível 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, você pode criar credenciais do OAuth, IDs do cliente e chaves secretas do cliente para seus aplicativos no painel APIs e recursos; serviços > Credenciais.

Nos guias de início rápido da API Apps Script, você encontra uma visão passo a passo 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 os aplicativos criem e modifiquem seus scripts e as implantações deles. Isso pode gerar uma situação ruim se você autorizar um aplicativo de terceiros mal-intencionado que, em seguida, vai 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. Você precisa conceder explicitamente o acesso à API antes de usar qualquer aplicativo que crie ou modifique scripts ou implantações. Depois que você concede à API acesso aos scripts, os aplicativos autorizados podem usar a API para gerenciar os projetos de scripts.

Um erro será exibido se você tentar executar um aplicativo afetado sem antes conceder o acesso à API. Esse erro ocorre depois que você autoriza 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á um risco envolvido em permitir que aplicativos modifiquem seus scripts. Nunca autorize esse uso de apps suspeitos.