Los complementos de Google Workspace que agregan soluciones de conferencias suelen tener detalles que el usuario debe controlar desde una página de configuración del complemento. Por ejemplo, es común tener un botón o control que le permita al usuario salir del sistema de conferencias de terceros.
Las páginas de configuración de complementos son opcionales. En las siguientes secciones, se describe cómo abrir la página de configuración de un complemento y cómo compilar una.
Cómo abrir la configuración del complemento
Para abrir la página de configuración de un complemento que instalaste, haz lo siguiente:
- Abre el Calendario de Google.
- Haz clic en el ícono y selecciona Configuración.
- En el panel de navegación izquierdo, selecciona Complementos para ir a la lista de complementos instalados.
- Haz clic en el botón Configuración que aparece a la derecha del nombre del complemento para abrir la página de configuración de ese complemento. Esto hará que el Calendario de Google abra la URL de la página de configuración.
Si un complemento no define una página de configuración, no aparecerá el botón Configuración.
Compila una página de configuración
Por lo general, una página de configuración se crea con HTML y CSS estándar. Cuando diseñes tu página, sigue los lineamientos de estilo de complementos.
Cuando un usuario realiza ajustes en la configuración del complemento, la página debe enviar solicitudes al sistema de conferencias de terceros para aplicar esos cambios según corresponda. La página también puede almacenar y recuperar información de las propiedades del usuario del proyecto del complemento según sea necesario.
Se aloja en un servidor web externo.
Puedes alojar tu página de configuración de complementos de forma externa desde el proyecto de secuencia de comandos del complemento, quizás como parte del sitio web de conferencias de terceros.
Para vincular un complemento a una página de configuración externa, debes hacer lo siguiente:
- Compila la página y alójala de forma externa. Cuando agregues elementos a la página, asegúrate de que se comuniquen correctamente con el sistema de conferencias de terceros y realiza los cambios adecuados para ese usuario.
- En el proyecto de secuencia de comandos del complemento, implementa una función que muestre la URL de la página externa.
- Especifica el nombre de esta función como el campo
calendar.createSettingsFunctionen el manifiesto del proyecto del complemento.
Se alojan en Apps Script
Puedes proporcionar una página de configuración para tu complemento con una app web de Apps Script. Como app web, el proyecto de secuencia de comandos del complemento puede compilar e implementar la página, que luego se aloja en los servidores de Apps Script.
Consulta la Guía de servicios de HTML para obtener detalles sobre cómo compilar HTML para apps web. La página de configuración puede comunicarse con los servidores de Google según sea necesario. También puedes usar plantillas en la página para que sea más dinámica.
En el ejemplo del complemento de conferencias de Calendario, se muestra cómo crear una página de configuración de la app web.