Adicionando as configurações do complemento de videoconferência

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 de complementos. Por exemplo, é comum ter um botão ou controle que permite 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 como criar uma.

Abrir configurações de complementos

Para abrir a página de configurações de um complemento instalado, faça o seguinte:

  1. Abra o 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 desse complemento. 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 Settings não será exibido.

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 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 que essas alterações sejam aplicadas conforme adequado. A página também pode armazenar e recuperar informações das propriedades do usuário do projeto de complementos, conforme necessário.

Hospedado em um servidor da Web externo

É possível hospedar a página de configuração do complemento externamente no projeto de script de complemento, talvez como parte do site de videoconferência de terceiros.

Para vincular um complemento a uma página de configuração 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 alterações apropriadas 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 campo calendar.createSettingsFunction no 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, seu 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 ver 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 para videoconferência do Google Agenda mostra como criar uma página de configurações de app da Web.