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 permita que un usuario salga 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 página de configuración.
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.
Cómo compilar una página de configuración
Por lo general, una página de configuración se crea con HTML y CSS estándares. Cuando diseñes tu página, sigue los lineamientos de diseño de complementos.
Cuando un usuario ajusta la configuración del complemento, la página debe enviar solicitudes al sistema de conferencias externo para implementar esos cambios según corresponda. La página también puede almacenar y recuperar información de las propiedades del usuario del proyecto de complemento según sea necesario.
Alojado en un servidor web externo
Puedes alojar la página de configuración del complemento de forma externa al proyecto de secuencia de comandos del complemento, tal vez 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 realicen los cambios adecuados para ese usuario.
- En el proyecto de secuencia de comandos del complemento, implementa una función que devuelva la URL de la página externa.
- Especifica el nombre de esta función como el campo
calendar.createSettingsFunctionen el manifiesto del proyecto de complemento.
Alojado en Apps Script
Puedes proporcionar una página de configuración para tu complemento usando una app web de Apps Script. Como app web, tu 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 del servicio HTML para obtener detalles sobre cómo compilar HTML para apps web. Tu 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 Calendar, se muestra cómo construir una página de configuración de la app web.