La implementación de un proyecto de Apps Script es una versión de la secuencia de comandos que se crea disponible para su uso como una aplicación web, un complemento o un ejecutable de API. Al crear y administrar implementaciones, puede iterar el código, hacer un seguimiento de los cambios y controlar la versión de código exacta 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 una secuencia de comandos de Apps Script automáticamente, crearás una implementación principal para ese proyecto.
La implementación principal siempre está sincronizada con el código guardado más reciente. Para Por ejemplo, si creas una implementación con control de versiones y, luego, modificas el código, head Deployment refleja esos cambios, mientras que la implementación con control de versiones permanece intacto.
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 permitirá que tus 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 un con control de versiones. Puedes tener varias implementaciones con control de versiones activas en una vez.
Importante: No puedes transferir la propiedad de las implementaciones con control de versiones. Si transferir la propiedad de un proyecto de secuencia de comandos a alguien, el propietario de un proyecto de implementaciones con control de versiones dentro del proyecto no cambian. Si un administrador la cuenta del propietario de la implementación, podrías experimentar errores de secuencia de comandos sus implementaciones.
Crea una implementación con control de versiones
Para implementar una versión de un complemento de Google Workspace, sigue estos pasos: complemento de Editor, app de Google Chat o una API ejecutable, primero debes cambiar la versión de Apps Script Asociación de proyectos de Google Cloud del proyecto predeterminado a un proyecto estándar proyecto.
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 > Implementación nueva.
- Junto a Seleccionar tipo, haz clic en Habilitar tipos de implementación.
- Selecciona el tipo de implementación que quieres implementar. Para los complementos de Google Workspace, los complementos de editores y Para 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 lo siguiente: Haz clic en Implementar > Administrar implementaciones.
Para ver el código de una versión específica, consulta Ver un anterior versión.
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 > Administra las 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, sigue los pasos anteriores.
Cuando quieras implementar un cambio en el código del proyecto, crea una versión nueva y y editar el Deployment para usarla. Cualquier usuario que utilice la versión nueva usa los usuarios que usan esa implementación.
Buscar un ID de implementación
Cada implementación tiene un ID de cadena asociado que se crea automáticamente. Para Para encontrar este ID, sigue estos pasos:
- Abre el proyecto Apps Script.
- En la esquina superior derecha, haz clic en Implementar > Administra las 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 Probar 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 Crea 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, sigue los pasos para habilitar la API de Google Chat. En la de configuración en "Permisos" especificar solo tu dirección de correo electrónico para que podrás instalar y probar tu app.
Ejecutable de API
Para probar una implementación ejecutable de API, primero debes crear una implementación con control de versiones. Después de crear un objeto Deployment, sigue sigue estos pasos:
- En la esquina superior derecha del proyecto Apps Script, haz clic en Implementar > Realiza pruebas Objetos Deployment.
- 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 > Administra las 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 Apps Script.
- En la esquina superior derecha, haz clic en Implementar > Administra las implementaciones.
- A la izquierda, en Archivados, selecciona la implementación que quieres volver a implementar. y haz clic en Editar . > Implementar.