Tipos de complementos

En esta página, se proporciona una descripción general de los dos tipos de complementos que puedes compilar: complementos de Google Workspace y complementos de Editor. Estos tipos de complementos difieren en las aplicaciones a las que se extienden, cómo se crean y qué restricciones tienen.

Complementos de Google Workspace

Los complementos de Google Workspace son la generación más reciente de complementos y proporcionan muchas funciones, como las siguientes:

  • Crea un solo complemento para varias apps de Google Workspace: En lugar de crear complementos independientes para cada aplicación de Google Workspace, puedes compilar y administrar un solo complemento de Google Workspace que funcione en todos los productos de Google Workspace. Un complemento de Google Workspace puede extender las siguientes aplicaciones de host:

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

  • Aumentar el reconocimiento de tu marca: Los íconos de los complementos se muestran de forma predeterminada en el panel lateral derecho de las apps de host del complemento.

  • Compila experiencias en la página principal: Puedes crear páginas principales individuales para cada app de Google Workspace que tu complemento extienda, o bien usar la misma página principal para varias apps.

  • Reflejar el contexto del usuario en tu complemento: Puedes diseñar tu complemento de Google Workspace para mostrar interfaces específicas de la app host del complemento. Por ejemplo, el complemento puede mostrar información de un correo electrónico o un evento de calendario, o sugerir una acción en función de la página actual de la app de Google Workspace.

  • Usa interfaces estandarizadas: Construye interfaces de usuario a partir de elementos de widgets integrados que proporciona el servicio Card de Apps Script. No necesitas experiencia con 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, puedes usarlo en las versiones para computadoras y dispositivos móviles de Gmail. Si compilas un complemento de Google Workspace que extiende Gmail, no es necesario que diseñes una versión para dispositivos móviles del complemento. Se usa la misma interfaz en todas partes.

  • Usa el entorno de ejecución que prefieras. Puedes desarrollar complementos de Google Workspace con tu infraestructura de alojamiento, cadena de 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 de editor amplían una de las aplicaciones de Editor de Google, como Documentos, Hojas de cálculo, Presentaciones o Formularios. Cada tipo de complemento de editor (por ejemplo, los complementos de Hojas de cálculo) puede tener su propio conjunto de capacidades específicas del tipo, restricciones y consideraciones especiales. Cuando compilas complementos de Editor, es importante comprender estos detalles específicos del Editor. Si quieres obtener más detalles sobre los complementos para editores específicos, consulta las secciones correspondientes:

Los complementos de editor pueden automatizar las tareas comunes del editor, como la creación, la edición, el formateo y el movimiento de datos entre aplicaciones de archivos. Las interfaces de complementos del editor son altamente personalizables para las tareas en cuestión.

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

  • Los complementos de editor pueden crear interfaces que consisten en elementos de menú, diálogos y barras laterales. Los diálogos de complementos y las barras laterales se definen con HTML y CSS estándar.
  • Los complementos de editor tienen reglas de autorización especiales porque crean, modifican o interactúan de algún otro modo con archivos dentro de Google Drive. Es importante comprender el ciclo de vida de la autorización de 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 que pueden ser diapositivas, diseños o maestros. Debes comprender estas estructuras de archivos, ya que los complementos suelen interactuar con ellos cuando se leen o editan archivos.
  • Los complementos de Editor solo funcionan en clientes de escritorio, no en Android o iOS.
  • Los complementos del editor se deben implementar en Apps Script.