Los complementos de Google Workspace que agregan soluciones de conferencias a menudo tienen detalles que el usuario debe controlar desde la página de configuración del complemento. Por ejemplo, es común tener un botón o un 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
Puedes abrir la página de configuración de un complemento que instalaste de la siguiente manera:
- Abre el Calendario de Google.
- Haz clic en el ícono y selecciona Configuración.
- En el panel de navegación izquierdo, selecciona Complementos para saltar 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 los 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 de complementos según sea necesario.
Alojada 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 manifest del proyecto del complemento.
Se alojan en Apps Script
Puedes proporcionar una página de configuración para tu complemento con una aplicación web de Apps Script. Como aplicación web, tu proyecto de secuencia de comandos de complemento puede compilar y, luego, 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.