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 um usuário saia do sistema de videoconferência de terceiros.
As páginas de configuração de complementos são opcionais. As seções abaixo descrevem como abrir a página de configuração de um complemento e criar essa página.
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 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 videoconferência de terceiros para implementar essas mudanças conforme adequado. A página também pode armazenar e recuperar informações das propriedades do usuário do projeto de complemento, conforme necessário.
Hospedado em um servidor da Web externo
É possível hospedar a página de configuração de complementos externamente por meio do projeto de script de complementos, 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 de 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 complementos.
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 de script de complemento pode criar e implantar a página, que é hospedada nos servidores do Apps Script.
Consulte o guia de serviço HTML para mais detalhes sobre como criar HTML para apps da Web. Sua 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 videoconferência do Agenda mostra como criar uma página de configurações de app da Web.