Introdução

A API Google Apps Script permite automatizar a criação, o gerenciamento e a execução de scripts no Google Apps Script. É possível criar, modificar e implantar projetos do Google Apps Script de maneira programática e executar funções do Apps Script remotamente, ações que exigem o uso do editor de script do Apps Script ou da interface.

Essa API geralmente é usada 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 de outros aplicativos.
  • Monitorar registros e status de execução de scripts.

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

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

Para permitir que outros apps gerenciem seus scripts, você deve conceder 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 : representação de um projeto de script. A API fornece métodos para criar, ler, monitorar e modificar projetos. Use esse recurso para gerenciar os arquivos de script e os metadados do projeto.
  • projects.deployments : representação de uma implantação de script. A API fornece 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 : representação de uma versão de projeto de script. A API fornece métodos para criar e ler versões de projetos. Use versões para acompanhar diferentes iterações do projeto de script.
  • processes : representação de uma execução de 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 execuções de script iniciadas usando 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.