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 Administración de proyectos, se muestran ejemplos de solicitudes de administración de API. La documentación de referencia de cada método proporciona detalles de la 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 ni un manifiesto de 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, Formularios o Presentaciones de Google para que actúe como elemento 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 que lo creó, la hora de creación y otros detalles.

Lee 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 contienen el contenido fuente 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 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 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 secuencia de comandos, en el modo de vista previa del complemento o como una app web o una API de Apps Script en modo de desarrollo.

Nota: Cuando se actualiza el contenido de un proyecto de secuencia de comandos, la práctica habitual es emitir primero una solicitud projects.getContent para recuperar un array de los File existentes, realizar la acción deseada en 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 secuencia de comandos. Se quitan los archivos que no se actualizaron 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.