Os complementos do Google Workspace que adicionam soluções de videoconferê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 permita que o usuário saia do sistema de conferência de terceiros.
As páginas de configuração 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 configurações de complementos
Para abrir a página de configurações de um complemento instalado, faça o seguinte:
- Abra o 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 fará 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 projetar sua página, siga as diretrizes de estilo do complemento.
Quando um usuário faz ajustes nas configurações do complemento, a página precisa enviar solicitações ao sistema de conferências de terceiros para ativar essas mudanças conforme apropriado. A página também pode armazenar e extrair informações das propriedades do usuário do projeto complementar, conforme necessário.
Hospedado em um servidor da Web externo
É possível hospedar a página de configuração do complemento externamente no projeto do script do complemento, talvez como parte do site de videoconferência de terceiros.
Para vincular um complemento a uma página de configurações externas, você precisa fazer o seguinte:
- Crie a página e hospede-a externamente. Ao adicionar elementos à página, verifique se eles se comunicam corretamente com o sistema de videoconferência de terceiros e fazem as alterações apropriadas para esse usuário.
- No projeto de script complementar, 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 do complemento.
Hospedado no Apps Script
Você pode fornecer uma página de configurações para o complemento usando um app da Web do Apps Script. Como um app da Web, o projeto do script do complemento pode criar e implantar a página, que é hospedada nos servidores do Apps Script.
Consulte o guia de serviço de 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. Também é possível usar modelos na página para torná-la mais dinâmica.
O exemplo de complemento de conferências do Google Agenda mostra como criar uma página de configurações de apps da Web.