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 qué aplicaciones 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, incluidas las siguientes:

  • Compila un solo complemento para varias apps de Google Workspace: En lugar de complementos independientes para Gmail, Calendario, Drive y los editores, puedes compilar y administrar un solo complemento de Google Workspace a fin de extender varias apps de Google Workspace.

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

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

  • Refleja el contexto del usuario en tu complemento: Puedes diseñar tu complemento de Google Workspace de modo que muestre interfaces específicas de la app host del complemento. Por ejemplo, tu complemento puede mostrar información de un evento de correo electrónico o calendario, o sugerir una acción en función de 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 Apps Script. No necesitas tener experiencia en HTML o CSS para definir estas interfaces.

  • Extender los clientes móviles y de escritorio para Gmail: Si un complemento de Google Workspace extiende Gmail, puedes usarlo en las versiones de Gmail para computadoras y dispositivos móviles. Si compilas un complemento de Google Workspace que extiende Gmail, no es necesario que diseñes una versión independiente del complemento para dispositivos móviles. Se usa la misma interfaz en todas partes.

  • Usa tu entorno de ejecución preferido. Como alternativa a Apps Script, puedes desarrollar complementos de Google Workspace con la infraestructura de hosting, la cadena de herramientas de desarrollo, el sistema de control del código fuente, el lenguaje de programación y las bibliotecas de códigos que prefieras. Para obtener más información, consulta Cómo compilar un complemento en cualquier lenguaje de programación

Complementos del editor

Los complementos de editor extienden una de las aplicaciones del Editor de Google, como Documentos, Hojas de cálculo, Presentaciones o Formularios. Cada tipo de complemento de editor (por ejemplo, complementos de Hojas de cálculo) puede tener su propio conjunto de funciones, restricciones y consideraciones especiales específicas del tipo. Cuando compiles complementos de Editor, es importante comprender estos detalles específicos de Editor. Si quieres obtener más detalles sobre los complementos para editores específicos, consulta las secciones correspondientes:

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

Los complementos de editor se comportan de manera diferente que 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. Los diálogos y las barras laterales de los complementos se definen con HTML y CSS estándar.
  • Los complementos de editor tienen reglas de autorización especiales porque crean, modifican o interactúan con archivos de Google Drive. Es importante comprender el ciclo de vida de la autorización del complemento de Editor mientras desarrollas un complemento del editor.
  • Los archivos que se crean y actualizan en cada editor tienen estructuras específicas. Por ejemplo, los archivos de Presentaciones de Google constan de páginas que pueden ser diapositivas, patrones o diseños. Debes comprender estas estructuras de archivos, ya que los complementos suelen interactuar con ellas cuando leen o editan archivos.
  • Los complementos de Editor solo funcionan en clientes de escritorio, no en Android ni iOS.
  • Los complementos del editor se deben implementar en Apps Script.