Administra proyectos

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

Descripción general del método de la API
Cómo crear proyectos

projects.create

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

Opciones: Puedes proporcionar un título para el 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 de Google, Formularios de Google o Presentaciones para que actúe como el elemento superior de la secuencia de comandos.

Lee metadatos de proyectos

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 de creación, la hora de creación y otros detalles.

Cómo leer el contenido del proyecto

projects.getContent

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

Opciones: Puedes especificar qué versión del contenido se 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. Proporciona el contenido nuevo como un array de objetos File. Uno de estos objetos File debe tener el tipo JSON y representar el nuevo manifiesto del proyecto del proyecto de 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 activador, en el editor de secuencias de comandos, en el modo de vista previa de complementos, como una aplicación web o la API de Apps Script en modo de desarrollo.

Nota: Cuando actualizas el contenido del proyecto de la secuencia de comandos, la práctica común es emitir primero una solicitud projects.getContent para recuperar un array de los File existentes, solicitar esos objetos y, luego, usar los File como entrada para una solicitud projects.updateContent.

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

Lee las métricas de proyectos

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 mediante un MetricsFilter. También puedes definir un intervalo de métrica específica con MetricsIntervalConfig.