Introducción

La API de Google Apps Script te permite automatizar la creación, la administración y la ejecución de secuencias de comandos en Google Apps Script. Puedes crear, modificar e implementar proyectos de Google Apps Script de forma programática, y ejecutar funciones de Apps Script de forma remota, acciones que, de lo contrario, requieren el uso del editor de Apps Script o su IU.

Esta API se suele usar para lo siguiente:

  • Crear y administrar proyectos y las implementaciones de Apps Script
  • Agregar o actualizar funciones en proyectos de secuencias de comandos
  • Ejecutar funciones de Apps Script desde otras aplicaciones
  • Supervisar los registros de ejecución y los estados de las secuencias de comandos

La API de Apps Script también reemplaza y extiende la API de ejecución de Apps Script. Puedes usar la API de Apps Script para ejecutar funciones de Apps Script de forma remota, tal como lo hacías con la API de Execution.

Para usar esta API en tus apps, debes habilitarla.

Para permitir que otras apps administren tus secuencias de comandos, debes otorgarles acceso.

Descripción general de la API

La API de Apps Script se divide en varios recursos, cada uno con un propósito específico y un conjunto de solicitudes que puedes realizar. Estos recursos son los siguientes:

  • projects : Es una representación de un proyecto de secuencia de comandos. La API proporciona métodos para crear, leer, supervisar y modificar proyectos. Usa este recurso para administrar los archivos de secuencia de comandos y los metadatos de tu proyecto.
  • projects.deployments : Es una representación de una implementación de secuencia de comandos. La API proporciona métodos para crear, enumerar, actualizar y borrar implementaciones de proyectos de secuencias de comandos. Usa las implementaciones para que tu secuencia de comandos esté disponible como una app web, un complemento o un archivo ejecutable.
  • projects.versions : Es una representación de una versión de proyecto de secuencia de comandos. La API proporciona métodos para crear y leer versiones de proyectos. Usa las versiones para hacer un seguimiento de las diferentes iteraciones de tu proyecto de secuencia de comandos.
  • processes : Es una representación de la ejecución de una función de secuencia de comandos. La API proporciona métodos para enumerar los procesos existentes y recopilar información sobre ellos, como el tipo y el estado actual. Usa este recurso para supervisar las ejecuciones de secuencias de comandos que se inician con el método scripts.run.
  • scripts : Es el extremo que proporciona métodos para ejecutar de forma remota funciones de Apps Script. Usa este recurso para ejecutar funciones en tu proyecto de secuencia de comandos desde tu aplicación.