Adicionar configurações de complementos de videoconferência

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 permita que um usuário faça logout 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 e criar uma página de configurações de complemento.

Abrir as configurações do complemento

As configurações dos complementos de videoconferência podem ser acessadas no menu de configurações do Google Agenda. Para abrir a página de configurações de um complemento instalado, faça o seguinte:

  1. Abra a Google Agenda.
  2. Clique no ícone e selecione Configurações.
  3. No painel de navegação à esquerda, selecione Complementos para acessar a lista de complementos instalados.
  4. 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 é criada usando HTML e CSS padrão. Ao criar a página, siga as diretrizes de estilo do complemento.

Quando um usuário ajusta as configurações do complemento, a página precisa enviar solicitações ao sistema de conferência de terceiros para implementar essas mudanças. 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ções do complemento externamente no 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:

  1. 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 faça as mudanças adequadas para esse usuário.
  2. No projeto de script do complemento, implemente uma função que retorne o URL da página externa.
  3. Especifique o nome dessa função como o calendar.createSettingsFunction campo no manifesto do projeto de complemento.

Hospedado no Apps Script

É possível 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 do complemento pode criar e implantar a página, que é hospedada nos servidores do Apps Script.

Consulte o guia do serviço HTML para mais detalhes sobre 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ência do Google Agenda mostra como criar uma página de configurações de app da Web.