Los complementos de Google Workspace pueden brindar cuando el usuario ve o edita calendarios y eventos de Calendario. Esto te permite proporcionarle al usuario información relevante adicional, automatizar y conectar sistemas de terceros al Calendario de Google.
Cuando compilas una interfaz de complemento para el Calendario de Google, puedes proporcionar una página principal. Puedes usar el mismo página principal para varios hosts o diseñar uno específico para el Calendario de Google.
Tu complemento también puede definir una interfaz que aparece cuando el usuario tiene se abra un evento de Calendario.
Accede a la IU del complemento
Según cómo se abra, un complemento de Google Workspace puede definir una interfaz de página principal, una interfaz de evento de Calendario de Google, una interfaz de selección de archivos adjuntos o las tres opciones siguientes:
- Si un usuario hace clic en el ícono del complemento mientras está en una vista de calendario, el complemento se ejecuta.
el
calendar.homepageTriggercorrespondiente (si está presente). Esta función compila y muestra una tarjeta de la página principal en el Calendario para mostrarlos. Si la respuesta es nocalendar.homepageTriggerse define una función, en su lugar se muestra una tarjeta genérica de la página principal. - Si el usuario abre un evento de Calendario y, luego, hace clic en el ícono del complemento
el complemento está abierto cuando el usuario abre un evento, el complemento
ejecuta el comando
eventOpenTrigger(si está presente). Esta función compila el evento de Calendario del complemento y regresa al Calendario de Google para verlas. - Si el complemento define una función
eventAttachmentTrigger, El complemento aparece como proveedor de archivos adjuntos cuando el usuario hace clic en Agregar archivo adjunto mientras edita un evento de Calendario. Cuando se selecciona el complemento, La funcióneventAttachmentTriggercompila el adjunto del complemento. de selección del usuario y la devuelve al Calendario de Google para su visualización.
Cómo compilar la interfaz de complementos de Calendario
Puedes ampliar el Calendario de Google con una para el complemento de Google Workspace:
- Decide si quieres que tu complemento tenga una configuración específica de Calendario página principal. Además, decide si quieres proporcionar una interfaz personalizada mientras el usuario editar eventos de Calendario.
- Agrega las
addOns.commonyaddOns.calendarcampos al manifiesto del proyecto de secuencia de comandos del complemento incluidos los permisos necesarios. - Si proporcionas una dirección de correo electrónico
página principal
implementar el
calendar.homepageTriggerpara compilar esta interfaz. También puedes usar lacommon.homepageTriggerpara múltiples hosts de Google Workspace. - Si proporcionas una interfaz de evento de calendario, debes implementar una
calendar.eventOpenTriggerpara compilar esta interfaz. Consulta Extensión de la interfaz de eventos de Calendario para conocer los detalles. - Implementa las funciones de devolución de llamada asociadas necesarias para responder al mensaje Las interacciones de la IU, como los clics en botones.
Páginas principales del calendario
El Calendario de Google admite que se muestren las páginas principales del complemento de Google Workspace.
Para mostrar la página principal común de tu complemento en el Calendario de Google, asegúrate de que
es un addOns.calendar
en el manifiesto del complemento.
Como alternativa, puedes agregar
calendar.homepageTrigger
al manifiesto del complemento para proporcionar una página principal específica del Calendario.
En cualquier caso, debes proporcionar el nombre de una función activadora de página principal en tu
proyecto de secuencia de comandos del complemento. Esta función se llama automáticamente para compilar la
la página principal de Calendario de Google cuando lo necesites. Debes implementar esta función para compilar
y devolverán un solo
Card o un array de
Card
que conforman la página de inicio. A la función de activación de la página de inicio se le pasa un
objeto de evento
como un parámetro que contiene información general, como la configuración
plataforma. Puedes usar los datos del objeto de evento para personalizar la construcción del objeto
página principal.
Ampliación de la interfaz de eventos de Calendario
El Calendario de Google usa un activador contextual para determinar qué interfaz
(si corresponde) que se muestre cuando el usuario edite un evento de Calendario. Cuando el activador
activa, ejecuta la función de activación contextual especificada por el
calendar.eventOpenTrigger
en el manifiesto del complemento.
Debes implementar la función nombrada en el
calendar.eventOpenTrigger
. Esta función acepta un objeto de evento como un
argumento y debe mostrar un solo
Card o un array de
Card objetos para que Calendario
mientras el usuario tenga abierto el evento.
Objetos de evento
Se crea un objeto de evento y
se pasa a la
calendar.eventOpenTrigger
activador contextual cuando un usuario abre
un evento de calendario. La función de activación puede usar la información de este evento
para determinar cómo crear tarjetas de complementos o controlar el complemento
el comportamiento de los usuarios. Los objetos de eventos también se crean y pasan
homepageTrigger
cuando un complemento se abre por primera vez y cuando el usuario hace clic o selecciona
con widgets interactivos.
La estructura completa de los objetos de evento se describe en Objetos de evento. Cuando el Calendario es la aplicación host del complemento, el activador contextual y Los objetos de eventos de interacción del widget incluyen Objeto de evento de calendario campo que contiene información específica del cliente del Calendario.
Actualizando eventos del Calendario
Además del contexto
calendar.eventOpenTrigger
que se activa cuando un usuario abre
un evento de Calendario para editarlo, también puedes definir un
calendar.eventUpdateTrigger
que se activa cuando el usuario actualiza y guarda un evento de Calendario. Solo este activador
Se activa si el usuario realiza una o más de las siguientes ediciones:
- Agrega uno o más asistentes.
- Quita uno o más asistentes.
- Agrega o cambia a una solución de conferencia diferente.
Cuando este activador se activa, ejecuta el
función de activación especificada por el
calendar.eventUpdateTrigger
. La función se ejecuta antes de que se edite la edición del evento de Calendario.
guardado.
La calendar.eventUpdateTrigger
se suele usar para realizar una o más de las siguientes acciones:
- Actualizar la interfaz de eventos de Calendario del complemento en respuesta a los cambios del usuario al evento de Calendario.
- Sincronizar los datos de eventos de Calendario con un sistema de terceros, como una reunión que está conectado al Calendario de Google.
Si necesitas que el complemento realice ajustes en los datos de un evento de Calendario (como
como su lista de asistentes), debes establecer el complemento
calendar.currentEventAccess
de manifiesto en WRITE o READ_WRITE. Esto también
requiere que el complemento tenga las
https://www.googleapis.com/auth/calendar.addons.current.event.write
alcance.
Agregar soluciones de conferencia
Soluciones para conferencias representar opciones de conferencia de terceros a las que los usuarios pueden conectarse. Eventos del Calendario de Google El Descripción general de las conferencias de terceros documentación que brinda detalles sobre cómo crear un complemento que agregue nuevas para reuniones virtuales y conferencias. No es necesario compilar una IU para este tipo de extensión; las soluciones agregadas simplemente aparecen como opciones en el menú desplegable de la IU de eventos del Calendario de Google.