Glosario

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Los siguientes términos se utilizan en toda esta documentación.

Complemento de conferencia de Calendario

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

Consulta los complementos de la conferencia de Calendario para obtener más información. Consulta también Actualiza tus complementos publicados para obtener información sobre cómo convertir un complemento de conferencia de Calendario en un complemento de Google Workspace.

Tarjeta

Una sola página de una IU complementaria Las tarjetas están compuestas por diferentes objetos de widget (botones, campos de texto, encabezados, etcétera).

Consulta Tarjetas para obtener más información.

Basada en tarjeta

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

Los complementos de Google Workspace se basan en tarjetas.

Datos de la conferencia

El conjunto de información que necesita Calendario de Google para permitir que los usuarios creen y se unan a conferencias de terceros habilitadas mediante un complemento de Google Workspace o de Calendario

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

Solución de conferencias

Una representación de una conferencia de terceros que se puede crear desde Calendario de Google mediante el complemento de Google Workspace o el de la conferencia de Calendario.

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

Contexto

El estado actual de la aplicación host. Por ejemplo, qué mensaje se abre en Gmail, qué evento de Calendario estás editando o qué 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 activadora como un parámetro.

Activación contextual

La práctica de definir activadores que se activan cuando el usuario ingresa en un contexto específico, como cuando abre una conversación de correo electrónico en Gmail. La activación contextual permite que el complemento proporcione una IU relevante 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

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 de editor no están basados en tarjetas; más bien, requerían que el desarrollador creara una IU a partir de HTML y CSS sin procesar. Cada complemento de editor solo puede extender una aplicación host.

Consulta los complementos de Editor para obtener más detalles.

Objeto de evento

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

Consulta Objetos de eventos para obtener más detalles.

Complementos de Gmail

Un complemento que extiende Gmail únicamente. Los complementos de Gmail se basan en tarjetas. Gran parte de los detalles de funcionalidad, comportamiento y desarrollo que se usan para crear complementos de Gmail es idéntico a los mismos detalles que se usan en la creación de complementos de Google Workspace.

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

Página principal

La tarjeta de IU raíz de un complemento. Las páginas principales se muestran cuando los usuarios abren el complemento y permiten que el complemento muestre contenido fuera de un contexto específico (por ejemplo, cuando el usuario ve sus conversaciones de correo electrónico en Gmail, pero no abrió una). Debes definir 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 host

La aplicación de Google Workspace extiende un complemento de Google Workspace, como Gmail o Calendario de Google.

Basadas en HTML

Un complemento cuya interfaz de usuario se define mediante HTML y CSS, en lugar del servicio de tarjeta incorporado de Apps Script. Solo los complementos de edición anteriores están basados en HTML.

Manifest

Un archivo JSON adjunto a un proyecto de Apps Script. El manifiesto se utiliza 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 ciertas configuraciones de control de IU.

Activador del manifiesto

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

Los activadores de manifiesto son distintos de otros activadores en Apps Script porque no están integrados (como activadores simples) y no se pueden crear de manera programática con el servicio de secuencia de comandos de Apps Script (como activadores instalables).

Tarjetas no contextuales

Tarjetas que muestran contenido cuando el usuario está fuera de un contexto específico; por ejemplo, cuando ven sus conversaciones de correo electrónico en Gmail, pero no abrieron una. Las páginas principales son un tipo de tarjeta no contextual.

La sección a la derecha de la IU del host donde aparece la IU del complemento de Google Workspace. Los complementos de Gmail y del editor también pueden definir barras laterales.

Activador

Una condición y una respuesta de evento automática definidas por un proyecto o complemento de Apps Script. Los activadores se activan cuando ocurre su evento asociado (por ejemplo, cuando se abre un complemento) y provocan que una función específica de Apps Script (la función de activación) se ejecute automáticamente. En el caso de los complementos de Google Workspace, las funciones de activación suelen compilar tarjetas nuevas 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

Una función de Apps Script en un proyecto que se ejecuta en respuesta a un activador que se activa.

Widget

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 widget, definidos por el servicio de tarjetas integrado de Apps Script.

Consulta Widgets para obtener más información.

Función de controlador de widgets

Una 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 del controlador de widgets definidas que puede usar para conectarse a las acciones. Las funciones del controlador de widgets definen qué tipo de interacción del usuario activa la acción resultante y son un componente crucial de la interacción del widget.

Consulta las funciones del controlador de widgets para obtener más información.