Mejora la experiencia general de los usuarios con estas guías para el diseño de complementos.
Prácticas recomendadas generales
Te recomendamos que sigas las siguientes prácticas recomendadas para todos los complementos que desarrolles.
Determina la propiedad de los complementos antes de comenzar
Los complementos se definen en proyectos de Apps Script, que deben ser propiedad de una cuenta específica o ubicarse en una unidad compartida. Antes de programar un complemento, determina qué cuenta debe ser la propietaria del proyecto y qué cuenta actúa como su publicador. Además, determina qué cuentas actuarán como colaboradores y asegúrate de que esas cuentas tengan acceso al proyecto de secuencia de comandos y a su proyecto de Cloud Platform asociado.
Extiende Google Workspace, no lo repliques
Los complementos están diseñados para proporcionar capacidades nuevas a las aplicaciones de Google Workspace que extienden o automatizar tareas complejas. Es probable que los complementos que simplemente replican una funcionalidad que ya está dentro de la aplicación o aquellos que no replican mejoras significativas en un flujo de trabajo no pasen la revisión de complementos para su publicación.
Mantén los alcances limitados
Cuando definas tus alcances de forma explícita, siempre elige el conjunto de alcances con el menor permiso posible. Por ejemplo, no
tengas a tu solicitud de complemento 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 el complemento se ejecute más lentamente de lo que lo haría si todo el código de Apps Script estuviera dentro de un solo proyecto de secuencia de comandos. Aunque las bibliotecas de Apps Script funcionan con complementos, es posible que se produzcan reducciones de rendimiento si los 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, con libertad sin encontrar esta latencia.
Prácticas recomendadas sobre el complemento del editor
Las siguientes recomendaciones solo se aplican al complemento del editor}.
Coloca la interfaz HTML y JavaScript del cliente en sus propios archivos de secuencia de comandos.
Puedes crear varios archivos de secuencias 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 define las barras laterales y los diálogos del complemento en los archivos de secuencias de comandos dedicados a ellos.
Realiza pruebas de manera exhaustiva en diferentes modos de autorización
Cuando pruebes tu complemento, asegúrate de probar configuraciones que tengan archivos diferentes y estados de autorización diferentes.