O procedimento para criar um complemento do Google Workspace que fornece soluções de videoconferência de terceiros para o Google Agenda é essencialmente o mesmo que o procedimento para criar complementos do Google Workspace, com algumas etapas adicionais (mostradas em negrito abaixo):
- Escolha um proprietário e colaboradores do projeto de complemento.
- Crie um projeto do Apps Script.
- Projete a aparência e o comportamento do complemento.
- Ative o serviço avançado da Agenda.
- Configure o manifesto do projeto de complemento.
- Escreva código para definir a aparência e o comportamento do complemento usando o
serviço de card integrado do Apps Script.
- Escreva código para gerenciar soluções de conferência,
usando o serviço
ConferenceData
integrado do Apps Script. - (Opcional) Crie e configure uma página de configurações de complemento.
- Escreva código para gerenciar soluções de conferência,
usando o serviço
- Verifique os escopos OAuth do complemento.
- Teste o complemento nos aplicativos host que ele estende.
- Publique o complemento.
Esta página oferece uma visão geral de cada uma das novas etapas. Consulte Como criar complementos do Google Workspace para ver uma visão geral das outras etapas.
Ativar o serviço avançado da Agenda
O serviço avançado do Google Agenda permite chamar a API Calendar diretamente de um projeto do Apps Script. Algumas operações comuns, como sincronizações de eventos da agenda, só podem ser realizadas usando o serviço avançado. Antes de usar o serviço avançado, é preciso ativá-lo no projeto do complemento.
É possível ativar o serviço avançado do Google Agenda no editor do Apps Script. Não se esqueça de ativar a API na caixa de diálogo Serviços avançados do Google do editor 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 que o Google Agenda
mostre e ative as soluções de videoconferência corretamente. O manifesto do complemento precisa definir (na seção calendar
) uma ou mais soluções de conferência que descrevem os tipos de conferências de terceiros que os eventos do Google Agenda podem usar.
Consulte Manifestos para saber como configurar o manifesto do complemento.
Adicionar código para criar e sincronizar conferências
Depois de criar um projeto de script, comece a adicionar código para definir o comportamento do complemento relacionado a conferências. É possível usar o serviço avançado do Google Agenda, o serviço ConferenceData e outros serviços do Apps Script para controlar esse comportamento.
Ao adicionar código de processamento de conferências ao complemento, você precisa adicionar código para criar conferências, sincronizar mudanças na agenda e, opcionalmente, adicionar uma página de configurações.
Consulte o guia de estilo de complementos ao programar para diretrizes sobre como criar a experiência do usuário do complemento.
Como criar conferências
Seu complemento precisa conseguir usar as informações sobre o evento do Google Agenda
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 conferências de terceiros.
Sincronizar mudanças na agenda
Depois que uma conferência é criada e vinculada a um evento do Google Agenda, ela geralmente precisa ser atualizada para refletir as mudanças no evento. Por exemplo, se um usuário mudar o horário do evento, os dados da conferência no sistema de terceiros precisam ser atualizados para refletir isso. O processo de atualização dos dados da conferência em resposta a mudanças no evento é chamado de sincronização.
Para mais detalhes, consulte Sincronizar mudanças na agenda.
Adicionar configurações
Talvez você queira ter configurações opcionais para que os usuários configurem seu complemento. Por exemplo, você pode permitir que os usuários definam parâmetros ou observações anexadas à conferência.
Sempre que quiser dar aos usuários algum grau de controle sobre o comportamento do complemento, forneça essas opções em uma página de configurações do complemento. É uma página da Web (hospedada pelo script do complemento 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 do complemento é opcional. Para mais detalhes, consulte Adicionar configurações.