Sigue estas guías para el diseño de complementos y mejora la experiencia general de los usuarios.
Prácticas recomendadas generales
Te recomendamos que uses 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 qué cuenta actuará como su publicador. También debes determinar qué cuentas actuarán como colaboradores y asegurarte de que tengan acceso al proyecto de secuencia de comandos y a su proyecto de Google Cloud asociado.
Extiende Google Workspace, no lo repliques
Los complementos están diseñados para proporcionar nuevas capacidades a las aplicaciones de Google Workspace que extienden o para automatizar tareas complejas. Es poco probable que los complementos que solo replican la funcionalidad que ya existe en la aplicación o los que no mejoran significativamente un flujo de trabajo pasen la revisión de complementos para su publicación.
Mantén los permisos limitados
Cuando definas tus alcances de forma explícita, elige siempre el conjunto de alcances menos permisivo posible. Por ejemplo, no solicites acceso completo al Calendario del usuario con el alcance https://www.googleapis.com/auth/calendar si tu complemento 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 bibliotecas de Apps Script puede hacer que tu complemento se ejecute más lentamente 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 los complementos, es posible que experimentes una reducción del 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 libremente bibliotecas de JavaScript del cliente, como jQuery, sin experimentar esta latencia.
Prácticas recomendadas para el complemento del editor
Las siguientes prácticas recomendadas solo se aplican al complemento del Editor.
Coloca el código 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 administrar un complemento complejo si colocas el código HTML y JavaScript que definen 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.