Adicionando configurações de complemento para 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 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:

  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 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:

  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 fazem as alterações apropriadas para esse usuário.
  2. No projeto de script complementar, 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 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.