Introdução

Com a API Google Apps Script, é possível automatizar a criação, o gerenciamento e a execução de scripts no Google Apps Script. Você pode criar, modificar e implantar projetos do Google Apps Script de forma programática e executar funções do Apps Script remotamente. Essas ações exigem o uso do editor de script do Apps Script ou da interface dele.

Essa API é usada com frequência para:

  • Criar e gerenciar projetos e implantações do Apps Script.
  • Adicionar ou atualizar funções em projetos de script.
  • Executar funções do Apps Script em outros aplicativos.
  • Monitore os registros e status de execução de scripts.

A API Apps Script também substitui e estende a API Apps Script Execution. É possível usar a API Apps Script para executar funções do Apps Script remotamente, assim como você faria com a Execution API.

Para usar essa API nos seus apps, você precisa ativá-la.

Para permitir que outros apps gerenciem seus scripts, conceda acesso a eles.

Visão geral da API

A API Apps Script é dividida em vários recursos, cada um com uma finalidade específica e um conjunto de solicitações que podem ser feitas. Esses recursos são:

  • projects: uma representação de um projeto de script. A API oferece métodos para criar, ler, monitorar e modificar projetos. Use esse recurso para gerenciar os arquivos de script e os metadados do seu projeto.
  • projects.deployments — Uma representação de uma implantação de script. A API oferece métodos para criar, listar, atualizar e excluir implantações de projetos de script. Use implantações para disponibilizar seu script como um app da Web, complemento ou executável.
  • projects.versions — Uma representação de uma versão do projeto de script. A API fornece métodos para criar e ler versões do projeto. Use versões para acompanhar diferentes iterações do seu projeto de script.
  • processes: uma representação da execução de uma função de script. A API fornece métodos para listar processos atuais e coletar informações sobre eles, como tipo e status atual. Use esse recurso para monitorar as execuções de script iniciadas com o método scripts.run.
  • scripts: o endpoint que fornece métodos para executar funções do Apps Script remotamente. Use esse recurso para executar funções no projeto de script do seu aplicativo.