Administra proyectos
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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 ejemplos de Administración de proyectos, se muestran ejemplos de solicitudes de administración de APIs. La documentación de referencia de cada método proporciona 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 del 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 elemento superior de la secuencia de comandos.
|
| Leer metadatos del proyecto |
projects.get
Results: 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.
|
| Leer el contenido del proyecto |
projects.getContent
Resultados: Devuelve un array de objetos File, uno para cada archivo HTML y de código 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 un activador, en el editor de secuencias 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 actualices el contenido del proyecto de secuencia de comandos, la práctica habitual es primero enviar una solicitud de
projects.getContent para recuperar un array de los File existentes, realizar los cambios deseados en esos objetos y, luego, usar los File como entrada para una solicitud de
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
MetricType para especificar la información que solicitas.
Opciones: Restringe los resultados a implementaciones o funciones de secuencias de comandos específicas con un objeto
MetricsFilter.
También puedes definir un intervalo de métricas específico con un objeto
MetricsIntervalConfig.
|
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-31 (UTC)
[null,null,["Última actualización: 2025-08-31 (UTC)"],[[["\u003cp\u003eThis section outlines Apps Script API methods for managing Apps Script projects, including creating, reading, updating, and monitoring.\u003c/p\u003e\n"],["\u003cp\u003eYou can create new projects, retrieve project metadata and content, and update project files using these methods.\u003c/p\u003e\n"],["\u003cp\u003eThe API allows you to access project metrics like user count, executions, and errors for analysis.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the provided links for detailed documentation and code samples on project management requests.\u003c/p\u003e\n"]]],[],null,["# Managing Projects\n\nThis section provides an overview of the Apps Script API methods\nyou can use to create, read, modify,\nand monitor your Apps Script projects. The\n[Project Management](/apps-script/api/samples/manage)\nsamples page shows examples of API management requests. The reference\ndocumentation for each method provides implementation details.\n\n| **API method overview** ||\n|----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Create projects** | [projects.create](/apps-script/api/reference/rest/v1/projects/create) **Results** : Create a basic, empty project with no project files and a default [project manifest](/apps-script/concepts/manifests). **Options** : You can provide a project title. You can also create a [bound script](/apps-script/guides/bound) by providing the Google Drive ID of a Google Docs, Google Sheets, Google Forms, or Slides file to act as the script's parent. |\n| **Read project metadata** | [projects.get](/apps-script/api/reference/rest/v1/projects/get) **Results** : Retrieves a [`Project`](/apps-script/api/reference/rest/v1/projects#Project) object, which represents project metadata. This data includes the project title, script ID, creating user, creation time, and other details. |\n| **Read project content** | [projects.getContent](/apps-script/api/reference/rest/v1/projects/getContent) **Results** : Returns an array of [`File`](/apps-script/api/reference/rest/v1/File) objects, one for each code and HTML file in the project. The list also includes the [project manifest](/apps-script/concepts/manifests) as a JSON file. File objects contain the source content of the file (`File.source`) and other metadata, such a list of functions in the file (`File.functionSet`). **Options** : You can specify which [version](/apps-script/guides/versions) of the content to retrieve with a query parameter. |\n| **Update project content** | [projects.updateContent](/apps-script/api/reference/rest/v1/projects/updateContent) **Results** : Changes the file content in a script project. You provide the new content as an array of [`File`](/apps-script/api/reference/rest/v1/File) objects. One of these `File` objects must have JSON type and represent the script project's new [project manifest](/apps-script/concepts/manifests). The new content is stored as the HEAD version of the project. It is used when the script executes as a trigger, in the script editor, in add-on preview mode, or as a web app or Apps Script API in development mode. **Note** : When updating script project content, common practice is to first issue a [projects.getContent](/apps-script/api/reference/rest/v1/projects/getContent) request to retrieve an array of the existing `File`s, make the desire to those objects, then use the `File`s as input for a [projects.updateContent](/apps-script/api/reference/rest/v1/projects/updateContent) request. **Warning:** The new content replaces all existing files in the script project. Files not updated by the request are removed. |\n| **Read project metrics** | [projects.getMetrics](/apps-script/api/reference/rest/v1/projects/getMetrics) **Results** : Read certain metrics about a project. These metrics include the number of users, the total number of executions, the total number of execution errors, and other details. Use a [MetricType](/apps-script/api/reference/rest/v1/projects/getMetrics#metrictype) to specify the information you are requesting. **Options** : Restrict the results to specific deployments or script functions using a [MetricsFilter](/apps-script/api/reference/rest/v1/projects/getMetrics#MetricsFilter). You can also define a specific metric interval using a [MetricsIntervalConfig](/api/reference/rest/v1/projects/getMetrics#metricsintervalconfig). |"]]
