Administra proyectos

En esta sección, se proporciona una descripción general de los métodos de la API de Google Apps Script que puedes usar para crear, leer, modificar y supervisar tus proyectos de Google Apps Script. En la página de ejemplos de administración de proyectos , se muestran ejemplos de solicitudes de administración de la API. En la documentación de referencia de cada método, se proporcionan detalles de implementación.

Descripción general del método de la API
Crea proyectos

projects.create

Resultados: Crea un proyecto básico y vacío sin archivos de proyecto y un manifiesto de proyecto predeterminado.

Opciones: Puedes proporcionar un título del proyecto. También puedes crear una secuencia de comandos vinculada si proporcionas el ID de Google Drive de un archivo de Documentos, Hojas de cálculo, Formularios o Presentaciones de Google para que actúe como el superior de la secuencia de comandos.

Lee los metadatos del proyecto

projects.get

Resultados: Recupera un objeto Project, que representa los metadatos del proyecto. Estos datos incluyen el título del proyecto, el ID de la secuencia de comandos, el usuario creador, la hora de creación y otros detalles.

Lee el contenido del proyecto

projects.getContent

Resultados: Muestra un array de File objetos, uno para cada archivo de código y HTML del proyecto. La lista también incluye el manifiesto del proyecto como un archivo JSON. Los objetos de archivo contienen el contenido fuente de el archivo (File.source) y otros metadatos, como una lista de funciones en el archivo (File.functionSet).

Opciones: Puedes especificar qué versión del contenido recuperar con un parámetro de consulta.

Actualiza el contenido del proyecto

projects.updateContent

Resultados: Cambia el contenido del archivo en un proyecto de secuencia de comandos. Proporcionas el contenido nuevo como un array de File objetos. Uno de estos objetos File debe tener el tipo JSON y representar el nuevo manifiesto del proyecto de la secuencia de comandos. El contenido nuevo se almacena como la versión HEAD del proyecto. Se usa cuando la secuencia de comandos se ejecuta como un activador, en el editor de secuencias de comandos, en el modo de vista previa del complemento de Google Workspace o como una app web o una API de Apps Script en modo de desarrollo.

Nota: Para actualizar el contenido del proyecto de secuencia de comandos, primero emite una solicitud projects.getContent para recuperar un array de los File existentes, realiza los cambios deseados en esos objetos y, luego, usa los File como entrada para una solicitud projects.updateContent.

Advertencia: El contenido nuevo reemplaza todos los archivos existentes en el proyecto de secuencia de comandos. Se quitan los archivos que no se actualizan con la solicitud.

Lee las métricas del proyecto

projects.getMetrics

Resultados: Lee ciertas métricas sobre un proyecto. Estas métricas incluyen la cantidad de usuarios, la cantidad total de ejecuciones, la cantidad total de errores de ejecución y otros detalles. Usa un MetricType para especificar la información que solicitas.

Opciones: Restringe los resultados a implementaciones o funciones de secuencia de comandos específicas con un MetricsFilter. También puedes definir un intervalo de métricas específico con un MetricsIntervalConfig.