Glosario

En esta documentación, se utilizan los siguientes términos:

Complemento de conferencias de Calendario

Es un tipo especial de complemento que se usa para permitir que los proveedores de servicios de conferencias presenten opciones de conferencias en los eventos del Calendario de Google. Estos complementos requieren una solución de conferencias bien desarrollada para conectarse. Debido a este requisito, la mayoría de los desarrolladores nunca necesitan crear un complemento de Conferencias de Calendar.

Consulta Complementos de conferencias de Calendario para obtener más información. Consulta también Cómo actualizar tus complementos publicados para obtener información sobre cómo convertir un complemento de conferencias de Calendario en un complemento de Google Workspace.

Tarjeta

Es una sola "página" de la IU de un complemento. Las tarjetas se componen de diferentes objetos de widgets (botones, campos de texto, encabezados, etcétera).

Consulta Tarjetas para obtener más información.

Basado en tarjetas

Es un complemento cuya interfaz de usuario aparece como un panel en la barra lateral (o, en dispositivos móviles, como otra ventana de actividad a la que se accede a través del menú). El complemento tiene una barra de herramientas superior que lo identifica y muestra una tarjeta, que es básicamente una "página" de la IU del complemento.

Los complementos de Google Workspace se basan en tarjetas.

Datos de la conferencia

Es el conjunto de información que necesita el Calendario de Google para permitir que los usuarios creen conferencias de terceros y se unan a ellas a través de un complemento de Google Workspace o un complemento de conferencias del Calendario.

Consulta Datos de la conferencia para obtener más información.

Solución para conferencias

Es una representación de una conferencia de terceros que se puede crear desde Calendario de Google con un complemento de Google Workspace o un complemento de conferencias de Calendario.

Consulta Soluciones para conferencias para obtener más información.

Contexto

Es el estado actual de la aplicación host. Por ejemplo, el mensaje que está abierto en Gmail, el evento de Calendario que estás editando o los archivos de Drive que seleccionaste forman parte del contexto actual de la aplicación host. El contexto, junto con otra información, se recopila en un objeto de evento que se pasa a la función de activación como parámetro.

Activación contextual

Práctica de definir activadores que se activan cuando el usuario ingresa a un contexto específico, por ejemplo, cuando abre un hilo de correos electrónicos en Gmail. La activación contextual permite que tu complemento proporcione una IU pertinente para ese contexto. Los activadores contextuales se configuran en el manifiesto del proyecto de secuencia de comandos del complemento y, por lo tanto, son un tipo de activador de manifiesto.

Complementos del editor

Es el conjunto original de tipos de complementos que solo permitían extensiones de Documentos, Hojas de cálculo, Formularios o Presentaciones de Google. Los complementos del editor no se basan en tarjetas, sino que requieren que el desarrollador cree una IU a partir de HTML y CSS sin procesar. Cada complemento del editor solo puede extender una aplicación host.

Consulta Complementos del Editor para obtener más detalles.

Objeto de evento

Es el objeto JSON que se crea automáticamente cuando se solicitan páginas principales, cuando el complemento ingresa en contextos a los que debe responder o como resultado de las interacciones del usuario con los widgets en la interfaz del complemento. Una vez creados, los objetos de eventos se pasan a una función de devolución de llamada o de activación especificada. El propósito de los objetos de eventos es pasar información del entorno del cliente del usuario (como la información que ingresó en los widgets de la interfaz del complemento) al código del servidor del complemento, que luego puede actuar en función de esa información y devolver la respuesta adecuada.

Consulta Objetos de eventos para obtener más detalles.

Complementos de Gmail

Un complemento que solo extiende Gmail. Los complementos de Gmail se basan en tarjetas. Gran parte de la funcionalidad, el comportamiento y los detalles de desarrollo que se usan para crear complementos de Gmail son idénticos a los que se usan para crear complementos de Google Workspace.

Consulta Complementos de Gmail para obtener más información. Consulta también Cómo actualizar tus complementos publicados para obtener información sobre cómo convertir un complemento de Gmail en un complemento de Google Workspace.

Página principal

Es la tarjeta de la IU raíz de un complemento. Las páginas principales se muestran cuando los usuarios abren el complemento y permiten que este muestre contenido fuera de un contexto específico (por ejemplo, cuando el usuario ve sus cadenas de correos electrónicos en Gmail, pero no abrió ninguna). Defines la apariencia y el comportamiento de la página principal del complemento como cualquier otra tarjeta.

Consulta Páginas principales para obtener más información.

Host o aplicación de host

Es la aplicación de Google Workspace que extiende un complemento de Google Workspace, como Gmail o Calendario de Google.

Basado en HTML

Es un complemento cuya interfaz de usuario se define con HTML y CSS en lugar del servicio de tarjetas integrado de Apps Script. Solo los complementos del Editor más antiguos se basan en HTML.

Los activadores de vista previa de vínculos se activan cuando los usuarios interactúan con una URL de terceros o que no es de Google dentro de una aplicación host de Google, como Documentos de Google. El activador de vista previa del vínculo te permite definir patrones de URL para obtener una vista previa desde tu servicio o API, y configurar el contenido de la vista previa, lo que incluye el chip inteligente y la tarjeta de vista previa. Los activadores de vista previa de vínculos se configuran en el manifiesto del proyecto de secuencia de comandos del complemento y, por lo tanto, son un tipo de activador de manifiesto.

Consulta Vista previa de vínculos con chips inteligentes para obtener más información.

Manifiesto

Es un archivo JSON adjunto a un proyecto de Apps Script. El manifiesto se usa para definir la información del proyecto que la secuencia de comandos necesita para ejecutarse correctamente. En el caso de los complementos de Google Workspace, el manifiesto se usa para especificar qué hosts puede extender el complemento y proporcionar ciertos parámetros de configuración de control de la IU.

Activador de manifiesto

Es un activador que se define en el manifiesto de un proyecto, como un activador de página principal o un activador contextual. Los activadores de manifiesto se usan exclusivamente para crear y mostrar tarjetas nuevas cuando se solicita la página principal de un complemento o cuando el complemento ingresa en un contexto que requiere una actualización de la pantalla.

Los activadores del manifiesto se distinguen de otros activadores en Apps Script porque no están integrados (como los activadores simples) y no se pueden crear de forma programática con el servicio de secuencias de comandos de Apps Script (como los activadores instalables).

Tarjetas no contextuales

Tarjetas que muestran contenido cuando el usuario está fuera de un contexto específico; por ejemplo, cuando ve sus cadenas de correos electrónicos en Gmail, pero no abrió ninguna. Las páginas principales son un tipo de tarjeta no contextual.

Es la sección a la derecha de la IU del host en la que aparece la IU de un complemento de Google Workspace. Los complementos de Gmail y Editor también pueden definir barras laterales.

Chip inteligente

Un chip inteligente es una mención de una persona, un archivo, un evento de calendario o alguna otra entidad dentro de una aplicación de Google Workspace. Cuando los usuarios colocan el cursor sobre un chip, también pueden obtener una vista previa del contenido adicional sobre el archivo o el vínculo. Por ejemplo, cuando los usuarios colocan el cursor sobre un chip de una presentación de Presentaciones de Google, ven una captura de pantalla de una diapositiva, el propietario de la presentación y si ya la vieron.

Puedes configurar tu complemento para que use chips inteligentes y obtener una vista previa de los vínculos a un servicio de terceros o que no sea de Google. Consulta Vistas previas de vínculos en Documentos de Google.

Activador

Es una condición y una respuesta automática a eventos definidas por un proyecto o complemento de Apps Script. Los activadores se activan cuando se produce el evento asociado (por ejemplo, cuando se abre un complemento) y hacen que se ejecute automáticamente una función de Apps Script especificada (la función del activador). En el caso de los complementos de Google Workspace, las funciones de activación suelen compilar nuevas tarjetas para controlar qué parte de la IU del complemento se muestra. Solo ciertos tipos de eventos pueden tener activadores.

Consulta activadores de complementos para obtener más información.

Función de activación

Es una función de Apps Script en un proyecto que se ejecuta en respuesta a la activación de un activador.

Widget

Es un elemento de la IU, como un botón, un campo de texto o una casilla de verificación. Las tarjetas se construyen a partir de una secuencia de objetos de widgets, definidos por el servicio de tarjetas integrado de Apps Script.

Consulta Widgets para obtener más información.

Función de controlador de widgets

Función que vincula un widget en particular a un objeto de acción en particular. Cada tipo de widget tiene un conjunto de funciones de controlador de widgets definidas que puede usar para conectarse a acciones. Las funciones de controlador de widgets definen qué tipo de interacción del usuario activa la acción resultante y son un componente fundamental de la interactividad del widget.

Consulta Funciones de controlador de widgets para obtener más información.