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
    • Google Chat (versión preliminar para desarrolladores)
    • 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.

  • Crea experiencias en la página principal: Puedes crear páginas principales individuales para cada app de Google Workspace a la que se 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 mostrar interfaces específicas de la app anfitrión 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 experiencia con HTML o CSS para definir estas interfaces.

  • Expande 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, complementos de Hojas de cálculo) puede tener su propio conjunto de funciones, restricciones y consideraciones especiales específicas del tipo. Cuando compilas complementos de Editor, es importante comprender estos detalles específicos de Editor. Para obtener más detalles sobre los complementos para editores específicos, consulta las secciones correspondientes:

Los complementos de editor pueden automatizar tareas comunes, como la creación, la edición, el formato y el traslado de datos entre aplicaciones. 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 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 y las barras laterales de los complementos se definen con HTML y CSS estándar.
  • Los complementos del editor tienen reglas de autorización especiales porque crean, modifican o interactúan de alguna otra manera con archivos en 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 ellas cuando se leen o editan archivos.
  • Los complementos de Editor solo funcionan en clientes para computadoras, no en Android ni iOS.
  • Los complementos del editor se deben implementar en Apps Script.