La implementación de un proyecto de Apps Script es una versión de la secuencia de comandos que está disponible para su uso como una app web, un complemento 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 exacta del código a la que tienen acceso tus usuarios.
Existen dos tipos de implementaciones:
- Implementaciones de encabezado, que siempre se sincronizan con el código del proyecto actual
- Implementaciones versionadas, que están conectadas 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, también creas automáticamente una implementación principal para ese proyecto.
La implementación principal siempre está sincronizada 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.
Usa implementaciones de encabezado para probar el código. No uses implementaciones de encabezado para uso público.
Implementaciones con versiones
Una implementación versionada pone a disposición una versión específica del código del proyecto. Esto permite que los usuarios sigan usando una versión funcional mientras tú realizas cambios y mejoras en el código.
Cuando tu aplicación se publique para el público, siempre usa una implementación con versiones. Puedes tener varias implementaciones con versiones activas al mismo tiempo.
Importante: No puedes transferir la propiedad de las implementaciones versionadas. Si le transfieres la propiedad de un proyecto de secuencia de comandos a otra persona, no cambiará el propietario de las implementaciones versionadas existentes dentro del proyecto. Si un administrador borra la cuenta del propietario de la implementación, es posible que experimentes errores de secuencia de comandos en sus implementaciones.
Crea una implementación con versiones
Para implementar una versión de un complemento de Google Workspace, un complemento del Editor, una app de Google Chat o un ejecutable de API, primero debes cambiar la asociación del proyecto de Google Cloud de Apps Script del proyecto predeterminado a un proyecto estándar.
Para crear una implementación versionada, sigue estos pasos:
- Abre el proyecto de Apps Script.
- En la esquina superior derecha, haz clic en Implementar > Nueva implementación.
- Junto a Seleccionar tipo, haz clic en Habilitar los tipos de implementación .
- Selecciona el tipo de implementación que deseas realizar. En el caso de los complementos de Google Workspace, los complementos del Editor y las apps de Google Chat, selecciona Complemento.
Ingresa la información sobre tu implementación y haz clic en Implementar.
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, sigue estos pasos:
- Abre el proyecto de Apps Script.
- Haz clic en Implementar > Administrar implementaciones.
- Selecciona la implementación activa que deseas cambiar y haz clic en Editar .
Realiza los cambios y haz clic en Implementar.
Si quieres editar una implementación archivada, debes volver a implementarla y, luego, seguir los pasos anteriores.
Cuando quieras implementar un cambio en el código del proyecto, crea una versión nueva y edita la implementación para usarla. La nueva versión la usan automáticamente todos los usuarios que utilizan esa implementación.
Cómo encontrar un ID de implementación
Cada implementación tiene un ID de cadena asociado que se crea automáticamente. Para encontrar este ID, sigue estos pasos:
- Abre el proyecto de Apps Script.
- En la parte 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
La forma en que pruebas una implementación depende del tipo de app que compiles.
Complemento de Google Workspace
Para probar la implementación de un complemento de Google Workspace, consulta Cómo probar complementos de Google Workspace.
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, primero debes crear 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, primero debes crear una implementación con versiones. Después de crear una implementación, sigue los pasos que se indican a continuación:
- En la esquina superior derecha del proyecto de Apps Script, haz clic en Implementar > Implementaciones de prueba.
- Junto a "Seleccionar tipo", haz clic en Habilitar los tipos de implementación
> 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 versionada, sigue estos pasos:
- Abre el proyecto de Apps Script.
- Haz clic en Implementar > Administrar implementaciones.
- Selecciona la implementación que deseas archivar y haz clic en Archivar implementación .
Vuelve a implementar una implementación archivada
- Abre el proyecto de Apps Script.
- En la parte superior derecha, haz clic en Implementar > Administrar implementaciones.
- A la izquierda, en Archived, selecciona la implementación que deseas volver a implementar y haz clic en Editar > Implementar.