Como criar complementos para videoconferências

O procedimento para criar um complemento do Google Workspace que fornece soluções de videoconferência de terceiros para o Google Agenda é basicamente o mesmo do procedimento de criação de complementos do Google Workspace, com algumas etapas extras (mostradas em negrito abaixo):

  1. Escolha o proprietário e os colaboradores do projeto do complemento.
  2. Crie um projeto do Apps Script.
  3. Crie a aparência e o comportamento do complemento.
  4. Ative o serviço avançado do Agenda.
  5. Configurar o manifesto do projeto de complemento.
    1. Definir soluções de videoconferência no manifesto.
  6. Escreva o código para definir a aparência e o comportamento do complemento usando o serviço Card integrado do Apps Script.
    1. Escreva código para gerenciar soluções de conferência usando o serviço integrado ConferenceData do Apps Script.
    2. (Opcional) Crie e defina uma página de configurações de complementos.
  7. Verifique os escopos do OAuth do complemento.
  8. Teste o complemento nos aplicativos host que ele estende.
  9. Publique o complemento.

Nesta página, você encontra uma visão geral de cada uma das novas etapas. Consulte Como criar complementos do Google Workspace para consultar uma visão geral das outras etapas.

Ativar o serviço avançado do Agenda

Com o serviço avançado do Google Agenda, é possível chamar a API Calendar diretamente de um projeto do Apps Script. Algumas operações comuns, como sincronizações de eventos do Google Agenda, só podem ser realizadas com o serviço avançado. Antes de usar o serviço avançado, você precisa ativá-lo para o projeto de complemento.

Você pode ativar o serviço avançado do Agenda no editor do Apps Script. Ative a API na caixa de diálogo do editor Serviços avançados do Google e no Console de APIs do Google.

Definir soluções de conferência no manifesto

O manifesto do complemento fornece as informações básicas necessárias para o Google Agenda exibir e ativar as soluções de conferência de complementos corretamente. O manifesto do complemento precisa definir (na seção calendar) uma ou mais soluções de videoconferência que descrevam os tipos de conferências de terceiros que os eventos do Google Agenda podem usar.

Consulte Manifestos para ver detalhes sobre como configurar o manifesto do seu complemento.

Adicione o código para criar e sincronizar videoconferências

Depois de criar um projeto de script, adicione o código para definir o comportamento do complemento em relação a conferências. Use o serviço avançado do Agenda, o serviço ConferenceData (em inglês) e outros serviços do Apps Script para controlar esse comportamento.

À medida que você adiciona o código de gerenciamento de videoconferências ao seu complemento, é preciso fazer isso para criar videoconferências, sincronizar alterações na agenda e, opcionalmente, adicionar uma página de configurações.

Consulte o guia de estilo do complemento durante a programação para conferir orientações sobre como criar a experiência do usuário do seu complemento.

Criar conferências

O complemento precisa receber informações sobre o evento do Google Agenda e usá-las para criar uma conferência no sistema de terceiros. Você precisa implementar um ou mais métodos onCreateFunction que executam esse processo e configurar esses métodos no manifesto do complemento.

Para mais detalhes, consulte Criar videoconferências de terceiros.

Sincronizar alterações da agenda

Depois que uma videoconferência é criada e vinculada a um evento do Google Agenda, ela geralmente precisa ser atualizada para refletir as alterações no evento. Por exemplo, se um usuário alterar o horário do evento, os dados da videoconferência no sistema de terceiros precisarão ser atualizados para refletir isso. O processo de atualização dos dados da videoconferência em resposta a alterações em eventos é chamado de sincronização.

Para mais detalhes, consulte Sincronizar mudanças na agenda.

Adicionar configurações

Você pode ter configurações opcionais que permitem aos usuários configurar seu complemento. Por exemplo, você pode permitir que os usuários definam parâmetros de videoconferência ou notas anexadas à conferência.

Sempre que você quiser dar aos usuários algum controle sobre o comportamento dos complementos, forneça essas opções na página de configurações dos complementos. Essa é uma página da Web (hospedada pelo script de complementos ou externamente) que é aberta quando o usuário acessa as configurações do complemento na interface do Google Agenda.

A criação de uma página de configurações de complementos é opcional. Para mais detalhes, consulte Adicionar configurações.