Tipos de complementos

En esta página, se proporciona una descripción general de los dos tipos de complementos que puedes crear: complementos de Google Workspace y complementos de Editor. Estos tipos de complementos difieren en las aplicaciones que extienden, los métodos de creación y las restricciones.

Complementos de Google Workspace

Los complementos de Google Workspace son la última generación de complementos y proporcionan muchas capacidades, incluidas las siguientes:

  • Crea un complemento para varias apps de Google Workspace: En lugar de crear complementos independientes para cada app, puedes crear y administrar un solo complemento de Google Workspace que funcione en todo el ecosistema. Un complemento de Google Workspace puede extender las siguientes aplicaciones host:

    • Gmail
    • Calendario de Google
    • Google Chat
    • Documentos de Google
    • Google Drive
    • Google Meet
    • Google Sheets
    • Presentaciones de Google

  • Aumentar el reconocimiento de la marca: Los íconos de los complementos son visibles de forma predeterminada en el panel lateral derecho de las apps host.

  • Crea experiencias de página principal: Crea páginas principales individuales para cada app de Google Workspace que extienda tu complemento o usa la misma página principal para varias apps.

  • Refleja el contexto en tu complemento: Diseña tu complemento de Google Workspace para que muestre interfaces específicas de la app host. Por ejemplo, tu complemento puede mostrar información de un correo electrónico o un evento de calendario, o sugerir una acción según la página actual de la app de Google Workspace.

  • Usa interfaces estandarizadas: Crea interfaces de usuario a partir de elementos de widgets integrados que proporciona el servicio Card de Google Apps Script. No necesitas tener experiencia en HTML o CSS para definir estas interfaces.

  • Extiende los clientes de Gmail para computadoras y dispositivos móviles: Si un complemento de Google Workspace extiende Gmail, úsalo en las versiones para computadoras y dispositivos móviles. No es necesario que diseñes una versión para dispositivos móviles por separado. Se usa la misma interfaz en todas partes.

  • Usa tu entorno de ejecución preferido: Desarrolla complementos de Google Workspace con tu infraestructura de hosting, herramientas de desarrollo, sistema de control de código fuente, lenguaje de programación y bibliotecas de código preferidos.

Complementos del editor

Los complementos del editor extienden una aplicación del Editor de Google, como Documentos, Hojas de cálculo, Presentaciones o Formularios. Cada tipo de complemento del Editor (por ejemplo, los complementos de Hojas de cálculo) tiene sus propias capacidades, restricciones y consideraciones especiales específicas del tipo. Cuando crees complementos del Editor, ten en cuenta estos detalles específicos del Editor. Para obtener más detalles sobre los complementos de editores específicos, consulta lo siguiente:

Los complementos del editor pueden automatizar tareas comunes del editor, como la creación, edición, formato y traslado de datos entre aplicaciones. Las interfaces de los complementos del editor son altamente personalizables.

Los complementos del editor son ideales para automatizar tareas en Documentos, Hojas de cálculo, Presentaciones o Formularios de Google para uso individual o interno. En el caso de los complementos que requieren capacidades a gran escala que deben controlar a muchos usuarios, requieren baja latencia o exigen un control total sobre tu infraestructura, considera crear complementos de Google Workspace en un entorno de ejecución diferente para tener un mejor control sobre los procesos de infraestructura, implementación y lanzamiento.

Los complementos del Editor se comportan de manera diferente a los complementos de Google Workspace de las siguientes maneras:

  • Los complementos de editor pueden crear interfaces que constan de elementos de menú, diálogos y barras laterales. Las interfaces se definen con HTML y CSS estándares.
  • Los complementos del editor tienen reglas de autorización especiales porque interactúan con archivos en Google Drive. Comprende la autorización del complemento del editor mientras desarrollas un complemento del editor.
  • Los archivos creados y actualizados en cada editor tienen estructuras específicas. Por ejemplo, en Presentaciones de Google, las presentaciones se componen de páginas, como diapositivas, patrones o diseños. Comprende estas estructuras de archivos, ya que los complementos suelen interactuar con ellas cuando leen o editan archivos.
  • Los complementos del editor solo funcionan en clientes de escritorio, no en Android ni iOS.
  • Los complementos del editor deben implementarse en Apps Script.