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 para editores. Estos tipos de complementos difieren en las aplicaciones que extienden, cómo se crean y qué restricciones tienen.

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 solo complemento para varias apps de Google Workspace: En lugar de crear complementos independientes para cada aplicación de Google Workspace, 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 (versión preliminar para desarrolladores)
    • Documentos de Google
    • Google Drive
    • Hojas de cálculo de Google
    • Presentaciones de Google

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

  • Crea experiencias de página principal: Puedes crear páginas principales individuales para cada app de Google Workspace que extienda tu 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 para que muestre interfaces específicas de la app host del complemento. 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: Construye interfaces de usuario a partir de elementos de widgets integrados que proporciona el servicio Card de Apps Script. No necesitas tener 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 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 para dispositivos móviles independiente 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 la infraestructura de hosting, la cadena de 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 de las aplicaciones 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) puede tener su propio conjunto de capacidades, restricciones y consideraciones especiales específicas del tipo. Cuando crees complementos del Editor, es importante que comprendas estos detalles específicos del Editor. Para obtener más detalles sobre los complementos de editores específicos, consulta las secciones correspondientes:

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

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. Los diálogos y las barras laterales de los complementos se definen con HTML y CSS estándares.
  • Los complementos del editor tienen reglas de autorización especiales porque crean, modifican o interactúan de alguna otra manera con los archivos de Google Drive. Es importante comprender el ciclo de vida de la autorización del complemento del Editor cuando 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, 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 del editor solo funcionan en clientes de escritorio, no en Android ni iOS.
  • Los complementos del editor se deben implementar en Apps Script.