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 y desplegar proyectos de Google Apps Script de forma programática, y ejecutar funciones de Apps Script de forma remota, acciones que, de otro modo, requieren el uso del editor de Apps Script o su IU.
Esta API se suele usar para lo siguiente:
- Crea y administra proyectos e implementaciones de Apps Script.
- Agregar o actualizar funciones en proyectos de secuencias de comandos
- Ejecutar funciones de Apps Script desde otras aplicaciones
- Supervisa los registros y estados de ejecución de la secuencia de comandos.
La API de Apps Script también reemplaza y extiende la API de Apps Script Execution. Puedes usar la API de Apps Script para ejecutar funciones de Apps Script de forma remota, al igual que 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— 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 implementaciones para que tu secuencia de comandos esté disponible como app web, complemento o ejecutable.projects.versions— Representación de una versión de un proyecto de secuencia de comandos. La API proporciona métodos para crear y leer versiones del proyecto. Usa 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 iniciadas con el métodoscripts.run.scripts: Es el endpoint 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.