Antes de compilar tu complemento del Editor, revisa las cuotas y limitaciones de Apps Script para asegurarte de que el diseño de tu proyecto se alinee con estos lineamientos. Familiarizarte con estos límites al comienzo del proceso de desarrollo puede ayudarte a evitar posibles problemas más adelante. Apps Script es ideal para el desarrollo de complementos ligeros para ti, tu equipo o tu organización. Sin embargo, si prevés crear un complemento a gran escala que necesite controlar a muchos usuarios, requiera una latencia baja o exija un control total sobre tu infraestructura, considera desarrollar un complemento de Google Workspace en un entorno de tiempo de ejecución diferente.
Sigue este procedimiento general cuando compiles un complemento del Editor:
- Crea un proyecto de Apps Script.
- Escribe código para definir la apariencia y el comportamiento del complemento con el servicio HTML integrado de Apps Script.
- Prueba el complemento.
- Publica el complemento.
Crea un proyecto de secuencia de comandos
Un complemento del Editor es un proyecto de Apps Script independiente. La guía de secuencias de comandos independientes proporciona instrucciones para crear proyectos nuevos.
También puedes abrir un nuevo guion.
Si lo haces, el archivo del proyecto (inicialmente llamado Untitled project) se colocará en la carpeta raíz de Drive.
Colaboración
Cuando colaboras con otras personas en el desarrollo de un complemento, una sola cuenta de usuario es propietaria del proyecto del complemento. Cuando publicas un complemento, una sola cuenta de usuario actúa como publicador. La cuenta de publicación debe tener acceso de edición al proyecto de secuencia de comandos del complemento, pero no es necesario que sea la propietaria del proyecto.
Es muy importante evitar situaciones en las que pierdas el acceso al código o la configuración de un complemento porque el propietario del proyecto dejó tu organización.
Para evitar perder el acceso al código del complemento, te recomendamos que uses unidades compartidas cuando colabores en un complemento. Colocar el 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 que agregues 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. Usas HtmlService de Apps Script para crear la interfaz de usuario del complemento (diálogos y barras laterales) con HTML y CSS convencionales. Los complementos del editor también pueden definir elementos de menú personalizados.
Mientras escribes el código, consulta la guía de estilo del complemento del editor para obtener instrucciones sobre cómo diseñar la experiencia del usuario de tu complemento. Además, asegúrate de comprender y programar los diferentes estados del ciclo de vida de la autorización con los que se puede encontrar tu complemento.
Prueba el complemento
Puedes probar los complementos del Editor antes de que se publiquen para asegurarte de que funcionen según lo previsto. Para realizar pruebas, debes crear una configuración de prueba y usar un documento, una hoja de cálculo, un formulario o una presentación de prueba.
Consulta Cómo probar un complemento del Editor para obtener más detalles.
Publica el complemento
Publicar tu complemento lo pone a disposición de otras personas, 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 del editor se publican en Google Workspace Marketplace. Los complementos disponibles públicamente deben completar la revisión de complementos antes de publicarse.
Para obtener más información, consulta Cómo publicar un complemento para el Editor.