Una implementación de proyecto de Google Apps Script es una versión del script que está disponible para usarse como una app web, un complemento de Google Workspace o un ejecutable de API. Si creas y administras implementaciones, puedes iterar tu código, hacer un seguimiento de tus cambios y controlar la versión del código a la que acceden los usuarios.
Existen dos tipos de implementaciones:
- Implementaciones de encabezado, que siempre se sincronizan con el código del proyecto actual
- Implementaciones versionadas, que se conectan a una versión específica del proyecto
Implementaciones de encabezado
Una implementación principal es el código del proyecto actual. Cuando creas un proyecto de Apps Script, el sistema crea automáticamente una implementación principal para ese proyecto.
La implementación principal siempre se sincroniza con el código guardado más recientemente. Por ejemplo, si creas una implementación con versiones y, luego, modificas tu código, la implementación principal reflejará esos cambios, mientras que la implementación con versiones permanecerá intacta.
Usar implementaciones principales para probar el código No uses implementaciones de encabezado para uso público.
Solo hay una implementación principal para cada proyecto de Apps Script. Para usar una implementación principal, debes tener al menos acceso de lectura al proyecto de secuencia de comandos.
Implementaciones con versiones
Una implementación versionada hace que esté disponible una versión específica del código del proyecto. Esto permite que los usuarios sigan usando una versión funcional mientras realizas cambios y mejoras en el código.
Cuando publiques una aplicación para uso público, siempre usa una implementación con versiones. Puedes tener varias implementaciones con versiones activas a la vez.
Importante: No puedes transferir la propiedad de las implementaciones versionadas. Si transfieres la propiedad de un proyecto de secuencia de comandos, no cambiará el propietario de las implementaciones existentes con versiones. Si un administrador borra la cuenta del propietario de la implementación, es posible que sus implementaciones experimenten errores de secuencia de comandos.
Crea una implementación con versiones
Para implementar una versión de un complemento, un complemento del Editor, una app de Chat o un ejecutable de API, primero debes cambiar la asociación del proyecto de Google Cloud de tu proyecto predeterminado de Apps Script a un proyecto estándar.
Para crear una implementación versionada, sigue estos pasos:
- Abre el proyecto de Apps Script. <<../_common/snippets/create-new-deployment.md>>
Cada implementación nueva se puede compartir como una biblioteca. Si compartes la secuencia de comandos como biblioteca, los usuarios de la biblioteca podrán ver la descripción de la implementación.
Cómo ver las implementaciones versionadas
Para ver las implementaciones de un proyecto de Apps Script, en la parte superior, haz clic en Implementar > Administrar implementaciones.
Para ver el código de una versión específica, consulta Cómo ver una versión anterior.
Cómo editar una implementación versionada
Puedes editar una implementación versionada para cambiar su descripción o versión. Para editar una implementación, haz lo siguiente:
- Abre el proyecto de Apps Script.
- Haz clic en Implementar > Administrar implementaciones.
- Selecciona la implementación activa y haz clic en Editar .
- Realiza los cambios y haz clic en Implementar.
Para editar una implementación archivada, vuelve a implementarla y, luego, sigue los pasos anteriores.
Para implementar un cambio en el código del proyecto, crea una versión nueva y edita la implementación para que la use. La implementación usa automáticamente la nueva versión para todos los usuarios.
Cómo encontrar un ID de implementación
Cada implementación tiene un ID de cadena asociado. Para encontrar este ID, haz lo siguiente:
- Abre el proyecto de Apps Script.
- En la esquina superior derecha, haz clic en Implementar > Administrar implementaciones.
- Selecciona una implementación activa para encontrar su ID.
Los IDs de implementación solo aparecen en las implementaciones activas.
Prueba una implementación
El método para probar una implementación depende del tipo de app que compiles.
Complemento de Google Workspace
Para probar la implementación de un complemento, consulta Cómo probar complementos.
Complemento del editor
Para probar la implementación de un complemento del Editor, consulta Cómo probar un complemento del Editor.
App web
Para probar la implementación de una app web, consulta Cómo probar la implementación de una app web.
App de Google Chat
Para probar la implementación de una app de Chat, crea una implementación con versiones de la secuencia de comandos para acceder a su ID de implementación.
Después de obtener el ID de la implementación, especifícalo en la configuración de la API de Chat y sigue los pasos para probar las funciones interactivas.
Ejecutable de API
Para probar una implementación ejecutable de la API, crea una implementación con versiones. Después de crear una implementación, sigue estos pasos:
- En la esquina superior derecha del proyecto de Apps Script, haz clic en Implementar > Implementaciones de prueba.
- Junto a “Seleccionar tipo”, haz clic en
> API Executable. - Copia y usa la URL para probar la implementación del ejecutable de la API.
Archiva una implementación con versión
No puedes borrar implementaciones versionadas. En su lugar, puedes archivarlos.
Para archivar una implementación con versiones, sigue estos pasos:
- Abre el proyecto de Apps Script.
- Haz clic en Implementar > Administrar implementaciones.
- Selecciona la implementación y haz clic en Archivar implementación .
Cómo volver a implementar una implementación archivada
- Abre el proyecto de Apps Script.
- En la esquina superior derecha, haz clic en Implementar > Administrar implementaciones.
- En Archived, selecciona la implementación y haz clic en Editar > Implementar.