Una implementación de un proyecto de Apps Script es una versión de la secuencia de comandos que se pone a disposición para usar como aplicación web, complemento o ejecutable de API. Cuando creas y administras implementaciones, puedes iterar en 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 principales, que siempre se sincronizan con el código del proyecto actual.
- Implementaciones con versión, que se conectan a una versión específica del proyecto.
Implementaciones principales
Una implementación principal es el código del proyecto actual. Cuando creas un proyecto de Apps Script, 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 control de versiones y, luego, modificas tu código, la implementación principal refleja esos cambios, mientras que la implementación con control de versiones permanece íntegra.
Usa implementaciones principales para probar el código. No uses implementaciones de lanzamiento para uso público.
Implementaciones con versiones
Una implementación con control de versiones 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 realizas cambios y mejoras en el código.
Cuando tu aplicación se publique para el consumo público, usa siempre una implementación con versión. Puedes tener varias implementaciones activas con control de versiones al mismo tiempo.
Importante: No puedes transferir la propiedad de las implementaciones con control de versiones. Si transfieres la propiedad de un proyecto de secuencia de comandos a alguien, el propietario de las implementaciones existentes con versión dentro del proyecto no cambiará. 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 control de versiones
Para implementar una versión de un complemento de Google Workspace, un complemento de Editor, una app de Google Chat o un archivo 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 con control de versiones, 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 implementar. Para los complementos de Google Workspace, los complementos de 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 implementaciones con control de versiones
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 con control de versiones
Puedes editar una implementación con control de versiones 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. Los usuarios que usan esa implementación usan automáticamente la versión nueva.
Cómo buscar 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 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
La forma de probar una implementación depende del tipo de app que compilas.
Complemento de Google Workspace
Para probar una implementación de complementos de Google Workspace, consulta Cómo probar complementos de Google Workspace.
Complemento del editor
Para probar la implementación de un complemento de Editor, consulta Cómo probar un complemento de 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 una implementación de la app de Chat, primero debes crear una implementación con control de versiones de la secuencia de comandos para acceder a su ID de implementación.
Una vez que tengas el ID de 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 control de versiones. Después de crear una implementación, sigue estos pasos:
- En la parte 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
> Executable de API.
- Copia y usa la URL para probar la implementación del ejecutable de la API.
Cómo archivar una implementación con versión
No puedes borrar implementaciones con control de versiones. En su lugar, puedes archivarlos.
Para archivar una implementación con versión, sigue estos pasos:
- Abre el proyecto de Apps Script.
- Haz clic en Implementar > Administrar implementaciones.
- Selecciona la implementación que quieres archivar y haz clic en Archivar implementación .
Vuelve a implementar una implementación archivada
- Abre el proyecto de Apps Script.
- En la esquina superior derecha, haz clic en Implementar > Administrar implementaciones.
- A la izquierda, en Archivado, selecciona la implementación que deseas volver a implementar y haz clic en Editar > Implementar.