Crea y administra implementaciones

Una implementación de 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 la API. Cuando creas y administras implementaciones, puedes iterar en el código, realizar un seguimiento de los cambios y controlar la versión de código exacta 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 con versiones, que están conectadas a una versión específica del proyecto.

Implementaciones de jefe

Una implementación principal es el código del proyecto actual. Cuando creas un proyecto de Apps Script, automáticamente creas una implementación principal para ese proyecto.

La implementación del encabezado siempre está sincronizada con el último código guardado. Por ejemplo, si creas una implementación con versión y, luego, modificas el código, la implementación principal refleja esos cambios, mientras que la implementación con versión permanece intacta.

Usa implementaciones de encabezado para probar el código. No uses implementaciones de encabezado para uso público.

Implementaciones con control de versiones

Una implementación con versión pone a disposición una versión específica del código del proyecto. Esto permite que tus usuarios sigan usando una versión funcional mientras realizas cambios y mejoras en el código.

Cuando tu aplicación esté publicada para el consumo público, siempre usa una implementación con versión. Puedes tener varias implementaciones con control de versiones activas a la vez.

Importante: No puedes transferir la propiedad de las implementaciones con versiones. Si transfieres la propiedad de un proyecto de secuencia de comandos a alguien, el propietario de las implementaciones con versiones existentes dentro del proyecto no cambia. 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 versión

Para implementar una versión de un complemento de Google Workspace, un complemento de Editor, una app de Google Chat o un ejecutable de la 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 versión, sigue estos pasos:

  1. Abre el proyecto Apps Script.
  2. En la esquina superior derecha, haz clic en Implementar > Nueva implementación.
  3. Junto a Seleccionar tipo, haz clic en Habilitar los tipos de implementación .
  4. Selecciona el tipo de implementación que quieres implementar. En Complementos de Google Workspace, Complementos del editor y apps de Google Chat, selecciona Complemento.
  5. 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 Cómo ver una versión anterior.

Edita una implementación con versión

Puedes editar una implementación con versión para cambiar su descripción o versión. Para editar una implementación, sigue estos pasos:

  1. Abre el proyecto Apps Script.
  2. Haz clic en Implementar > Administrar implementaciones.
  3. Selecciona la implementación activa que desees cambiar y haz clic en Editar .
  4. Realiza los cambios y haz clic en Implementar.

    Si deseas editar una implementación archivada, debes volver a implementarla y, luego, sigue 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. Cualquier usuario que use esa implementación usará automáticamente la versión nueva.

Busca un ID de implementación

Cada implementación tiene un ID de string asociado creado automáticamente. Para encontrar este ID, sigue estos pasos:

  1. Abre el proyecto Apps Script.
  2. En la esquina superior derecha, haz clic en Implementar > Administrar implementaciones.
  3. 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 aplicación que compiles.

Complemento de Google Workspace

Para probar una implementación de complementos de Google Workspace, consulta Prueba los complementos de Google Workspace.

Complemento Editor

Para probar una implementación de complemento de Editor, consulta Cómo probar 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 por la 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 estos pasos:

  1. En la esquina superior derecha del proyecto de Apps Script, haz clic en Implementar > Implementaciones de prueba.
  2. Junto a “Seleccionar tipo”, haz clic en Habilitar tipos de implementación > API ejecutable.
  3. Copia y usa la URL para probar tu implementación ejecutable de la API.

Archiva una implementación con versión

No puedes borrar las implementaciones con control de versiones. En su lugar, puedes archivarlos.

Para archivar una implementación con versión, sigue estos pasos:

  1. Abre el proyecto Apps Script.
  2. Haz clic en Implementar > Administrar implementaciones.
  3. Selecciona la implementación que deseas archivar y haz clic en Archivar implementación .

Vuelve a implementar una implementación archivada

  1. Abre el proyecto Apps Script.
  2. En la esquina superior derecha, haz clic en Implementar > Administrar implementaciones.
  3. A la izquierda, en Archivados, selecciona la implementación que deseas volver a implementar y haz clic en Editar > Implementar.