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 del 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 complementos independientes para cada app, puedes crear y administrar un solo complemento de Google Workspace que funcione en todo Google Workspace. Un complemento de Google Workspace puede extender las siguientes aplicaciones host:

    • Gmail
    • Calendario de Google
    • Google Chat
    • Documentos de Google
    • Google Drive
    • Google Meet
    • Hojas de cálculo de Google
    • Presentaciones de Google

  • Aumenta 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 mostrar interfaces específicas de la app host. Por ejemplo, tu complemento puede mostrar información de un correo electrónico o un evento del 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 experiencia con HTML ni 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 diseñar una versión para dispositivos móviles independiente. Se usa la misma interfaz en todas partes.

  • Usa el entorno de ejecución que prefieras: Desarrolla complementos de Google Workspace con la infraestructura de hosting, las herramientas de desarrollo, el sistema de control de código fuente, el lenguaje de programación y las bibliotecas de código que prefieras.

Complementos del editor

Los complementos del editor extienden una aplicación de Google Editor, 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, comprende 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, la edición y el formato de archivos, y el movimiento 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. Para los complementos que requieren capacidades a gran escala que deben controlar 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 la infraestructura, la implementación y los procesos de lanzamiento.

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

  • Los complementos del editor pueden crear interfaces que constan de elementos de menú, diálogos y barras laterales. Las interfaces se definen con HTML y CSS estándar .
  • Los complementos del editor tienen reglas de autorización especiales porque interactúan con archivos en Google Drive. Comprende la autorización de los complementos del editor mientras desarrollas un complemento del editor.
  • Los archivos creados y actualizados en cada editor tienen estructuras específicas. Por ejemplo, las presentaciones de Presentaciones de Google 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.