Cómo compilar complementos del editor

Sigue este procedimiento general cuando compiles un complemento del editor:

  1. Crear un proyecto de Apps Script
  2. Escribe código para definir la apariencia y el comportamiento del complemento mediante el servicio de HTML integrado de Apps Script.
  3. Prueba el complemento.
  4. Publica el complemento.

Crea un proyecto de secuencia de comandos

Un complemento de editor es un proyecto independiente de Apps Script. En la guía de secuencias de comandos independiente, se proporcionan instrucciones para crear proyectos nuevos. También puedes abrir una secuencia de comandos nueva. Si lo haces, el archivo del proyecto (que inicialmente se llamaba Untitled project) se coloca en tu carpeta raíz de Drive.

Colaboración

Cuando colaboras con otras personas para desarrollar un complemento, el proyecto del complemento solo es propiedad de una sola cuenta de usuario. Cuando publicas un complemento, una sola cuenta de usuario actúa como el publicador. La cuenta de publicación debe tener acceso de edición al proyecto de secuencia de comandos del complemento, pero no necesita ser propietario del proyecto.

Es muy importante evitar situaciones en las que pierdas acceso al código o la configuración de un complemento porque el propietario del proyecto abandonó tu organización.

Para no perder el acceso al código del complemento, te recomendamos que uses unidades compartidas cuando colabores en un complemento. Ubicar tu archivo de secuencia de comandos del complemento en una unidad compartida garantiza que ninguna cuenta sea la única propietaria del proyecto.

También se recomienda agregar colaboradores al proyecto de Cloud Platform (GCP) del proyecto de secuencia de comandos. Esto ayuda a garantizar que alguien de tu equipo siempre pueda acceder a la configuración de Cloud del complemento.

Codifica el complemento

Una vez que hayas creado un proyecto de secuencia de comandos, puedes comenzar a escribir código para definir la apariencia y el comportamiento del complemento. Usa HtmlService de Apps Script para crear la interfaz de usuario del complemento (diálogos y barras laterales) con HTML y CSS convencionales. Los complementos de editor también pueden definir elementos de menú personalizados.

A medida que escribes el código, consulta la guía de estilo sobre el complemento de Editor para obtener lineamientos sobre cómo diseñar la experiencia del usuario con el complemento. Además, asegúrate de comprender y programar los diferentes estados del ciclo de vida de la autorización que puede encontrar tu complemento.

Prueba el complemento

Puedes probar los complementos del editor antes de que se publiquen para asegurarte de que se comporten como se espera. Las pruebas requieren que crees una configuración de prueba y uses un documento, una hoja de cálculo, un formulario o una presentación de prueba.

Consulta Cómo probar un complemento de editor para obtener más detalles.

Publica el complemento

Si publicas tu complemento, estará disponible para otros usuarios, ya sea de forma pública o solo para los usuarios de tu dominio. Antes de comenzar el proceso de publicación, asegúrate de revisar la descripción general de la publicación.

Los complementos de editor se publican en Google Workspace Marketplace. Los complementos disponibles públicamente deben completar la revisión del complemento antes de publicarse.

Consulta Cómo publicar un complemento de editor para obtener más detalles.