Os complementos do Google Workspace que adicionam soluções de conferência geralmente têm detalhes que precisam ser controlados pelo usuário em uma página de configurações do complemento. Por exemplo, é comum ter um botão ou controle que permite que um usuário faça logout do sistema de conferência de terceiros.
As páginas de configurações de complementos são opcionais. As seções a seguir descrevem como abrir a página de configurações de um complemento e como criar uma página de configurações.
Abrir as configurações de complementos
Para abrir a página de configurações de um complemento instalado, faça o seguinte:
- Abra a Google Agenda.
- Clique no ícone e selecione Configurações.
- No painel de navegação à esquerda, selecione complementos para acessar a lista de complementos instalados.
- Clique no botão Configurações que aparece à direita do nome do complemento para abrir a página de configurações dele. Isso faz com que o Google Agenda abra o URL da página de configurações.
Se um complemento não definir uma página de configurações, o botão Configurações não vai aparecer.
Criar uma página de configurações
Uma página de configurações geralmente é criada usando HTML e CSS padrão. Ao criar sua página, siga as diretrizes de estilo de complementos.
Quando um usuário faz ajustes nas configurações do complemento, a página precisa enviar solicitações ao sistema de conferência de terceiros para implementar essas mudanças conforme necessário. A página também pode armazenar e recuperar informações das propriedades do usuário do projeto do complemento conforme necessário.
Hospedado em um servidor da Web externo
Você pode hospedar a página de configurações do complemento externamente ao projeto de script do complemento, talvez como parte do site de videoconferência de terceiros.
Para vincular um complemento a uma página de configurações externa, faça o seguinte:
- Crie e hospede a página externamente. Ao adicionar elementos à página, verifique se eles se comunicam corretamente com o sistema de conferência de terceiros e faça as mudanças adequadas para o usuário.
- No projeto de script do complemento, implemente uma função que retorne o URL da página externa.
- Especifique o nome dessa função como o campo
calendar.createSettingsFunctionno manifesto do projeto de complemento.
Hospedado no Apps Script
Você pode fornecer uma página de configurações para seu complemento usando um app da Web do Apps Script. Como um app da Web, o projeto de script do complemento pode criar e implantar a página, que é hospedada nos servidores do Apps Script.
Consulte o guia do serviço HTML para saber como criar HTML para apps da Web. A página de configurações pode se comunicar com os servidores do Google conforme necessário. Você também pode usar modelos na página para torná-la mais dinâmica.
O exemplo de complemento de videoconferência do Google Agenda mostra como criar uma página de configurações de app da Web.