Sigue estas guías de diseño de complementos para mejorar la experiencia general de los usuarios.
Prácticas recomendadas generales
Te recomendamos que sigas las siguientes prácticas recomendadas para todos los complementos que desarrolles.
Determina la propiedad del complemento antes de comenzar
Los complementos se definen mediante proyectos de Apps Script, que deben ser propiedad de una cuenta específica o colocarse en una unidad compartida. Antes de codificar un complemento, determina qué cuenta debe ser propietaria del proyecto y cuál actúa como su publicador. También determina qué cuentas actuarán como colaboradores y asegúrate de que esas cuentas tengan acceso al proyecto de secuencia de comandos y al proyecto de plataforma de Cloud asociado.
Extiende Google Workspace, no lo repliques
Los complementos están diseñados para proporcionar nuevas funciones a las aplicaciones de Google Workspace que extienden o, de lo contrario, automatizar tareas complejas. Es probable que los complementos que solo replican la funcionalidad que ya está dentro de la aplicación o que no realizan mejoras significativas en un flujo de trabajo no aprueben la revisión de complementos para su publicación.
Mantén los permisos limitados
Cuando defines tus alcances de forma explícita,
siempre elige el conjunto de alcances menos permisivo posible. Por ejemplo, no hagas que el complemento solicite acceso completo al Calendario del usuario con el permiso https://www.googleapis.com/auth/calendar si solo necesita acceso de lectura. Para el acceso de solo lectura, usa el permiso https://www.googleapis.com/auth/calendar.readonly.
Evita depender demasiado de las bibliotecas
El uso de las bibliotecas de Apps Script puede hacer que tu complemento se ejecute más lento de lo que lo haría si todo el código de Apps Script estuviera contenido en un solo proyecto de secuencia de comandos. Si bien las bibliotecas de Apps Script funcionan en complementos, es posible que experimentes reducciones de rendimiento si las usas. Evita incluir bibliotecas innecesarias en tu proyecto y considera formas de reducir la dependencia de tu complemento en ellas.
La latencia descrita anteriormente solo se aplica a los proyectos de Apps Script que se usan como bibliotecas del servidor. Puedes usar bibliotecas de JavaScript del cliente, como jQuery, libremente sin encontrar esta latencia.
Prácticas recomendadas para complementos del editor
Las siguientes prácticas recomendadas solo se aplican al complemento de Editor}.
Coloca el HTML de la interfaz y el código JavaScript del cliente en sus propios archivos de secuencia de comandos.
Puedes crear varios archivos de secuencia de comandos en un proyecto de Apps Script. Es más fácil gestionar un complemento complejo si colocas el código HTML y JavaScript que define las barras laterales y los diálogos del complemento en archivos de secuencia de comandos dedicados a ellos.
Realiza pruebas exhaustivas en diferentes modos de autorización
Cuando pruebes tu complemento, asegúrate de probar configuraciones que tengan diferentes archivos y diferentes estados de autorización.