La implementación de un proyecto de Apps Script es una versión de la secuencia de comandos que está disponible para usarse como app web, complemento o ejecutable de API. Cuando creas y administras implementaciones, puedes iterar en el código, realizar un seguimiento de los cambios y controlar la versión exacta del código a la que tienen acceso los usuarios.
Hay dos tipos de implementaciones:
- Implementaciones principales, que siempre se sincronizan con el código del proyecto actual.
- Implementaciones con versiones, que están conectadas 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, se crea automáticamente una implementación principal para ese proyecto.
La implementación principal siempre está sincronizada con el código guardado más reciente. Por ejemplo, si creas una implementación con control de versiones y, luego, modificas el código, la implementación principal reflejará esos cambios, mientras que la implementación con control de versiones permanece intacta.
Usa implementaciones principales para probar el código. No uses implementaciones principales para uso público.
Implementaciones con control de 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 consumo público, usa siempre una implementación con control de versiones. Puedes tener varias implementaciones con control de versiones activas a la vez.
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 con control de versiones existentes no cambiará. Si un administrador borra la cuenta del propietario de la implementación, es posible que experimentes errores de secuencia de comandos para 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 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 Apps Script.
- En la esquina superior derecha, haz clic en Implementar > Nueva implementación.
- Junto a Seleccionar tipo, haz clic en Habilitar tipos de implementación .
- Selecciona el tipo de implementación que quieres implementar. En el caso de 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.
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 Ver una versión anterior.
Edita una implementación con control de versiones
Puedes editar una implementación con versión para cambiar su descripción o versión. Para editar una implementación, sigue estos pasos:
- Abre el proyecto 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 desees implementar un cambio en el código del proyecto, crea una versión nueva y edita la implementación para usarla. Todos los usuarios que usan esa implementación utilizan automáticamente la versión nueva.
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 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 implementaciones activas.
Prueba una implementación
La forma de probar una implementación depende del tipo de app que compiles.
Complemento de Google Workspace
Para probar una implementación de complemento de Google Workspace, consulta Prueba los complementos de Google Workspace.
Complemento del editor
Para probar una implementación de complemento de editor, consulta Prueba un complemento de editor.
App web
Para probar una implementación de app web, consulta Prueba una implementación de app web.
App de Google Chat
Para probar una implementación de app de Chat, primero debes crear una implementación con versión de la secuencia de comandos para acceder a su ID de implementación.
Una vez que tengas el ID de implementación, sigue los pasos para habilitar la API de Google Chat. En la página Configuración, en "Permisos", especifica solo tu dirección de correo electrónico para que puedas instalar y probar tu app.
Ejecutable de API
Para probar una implementación ejecutable de API, primero debes crear una implementación con versión. Después de crear una implementación, sigue estos pasos:
- En la esquina superior derecha del proyecto Apps Script, haz clic en Implementar > Implementaciones de prueba.
- Junto a “Seleccionar tipo”, haz clic en Habilitar tipos de implementación
> Ejecutable de API.
- Copia y usa la URL para probar la implementación del ejecutable de la API.
Archiva una implementación con control de versiones
No puedes borrar las implementaciones con control de versiones. En su lugar, puedes archivarlas.
Para archivar una implementación con control de versiones, sigue estos pasos:
- Abre el proyecto 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 Apps Script.
- En la esquina superior derecha, haz clic en Implementar > Administrar implementaciones.
- A la izquierda, en Archivados, selecciona la implementación que deseas volver a implementar y haz clic en Editar > Implementar.