Responder a eventos do Google Meet

Este documento explica como receber e responder a eventos do Google Meet do Google Cloud Pub/Sub.

Um evento do Meet representa uma atividade ou mudança em um recurso do Meet, como a criação de uma nova reunião. É possível usar eventos para entender o que aconteceu e tomar medidas ou responder de maneira significativa para os usuários.

Confira alguns exemplos de como usar eventos:

  • Observe e responda a mudanças em uma reunião, como quando ela começa ou termina.

  • Acompanhe quem participou da reunião para fins regulamentares ou de treinamento.

  • Ouça a transcrição da reunião para que o conteúdo do arquivo possa ser analisado e registrado em um CRM ou banco de dados.

Como os eventos funcionam

Sempre que algo acontece no Google Meet, um recurso da API REST do Google Meet é criado ou atualizado. O Meet usa eventos para fornecer informações ao seu app sobre o tipo de atividade que ocorreu e o recurso da API REST do Meet que foi afetado.

O Meet categoriza os eventos por tipo. Os tipos de eventos ajudam a filtrar e receber apenas as informações necessárias, além de permitir que você lide com atividades semelhantes da mesma forma.

O exemplo a seguir mostra como uma atividade no Meet afeta um recurso relacionado da API REST do Meet e o tipo de evento que seu app Meet recebe:

Atividade Recurso da API REST Meet Tipo de evento
Um usuário entra em um espaço de reunião. Um recurso ConferenceRecord é criado. Novo recorde de conferências

Receber dados de eventos do Google Meet

Para receber dados de eventos, seu app pode fazer o seguinte:

A tabela a seguir explica a diferença e os motivos para assinar eventos em vez de consultá-los:

Inscrever-se em eventos Consultar dados
Casos de uso
  • Processar ou responder a eventos em tempo real.
  • Monitore as mudanças nos recursos para melhorar a performance do seu app.
  • Recupere os dados manualmente.
  • Extrair todos os dados do Meet (devido a uma interrupção ou assinatura inativa).
API API Google Workspace Events API REST do Meet
Origem dos eventos Registro da conferência e usuários Recorde de espaço e conferência
Eventos aceitos Registro da conferência

Para conferir uma lista de tipos de eventos compatíveis, consulte Tipos de eventos para criar assinaturas na documentação da API Google Workspace Events. 		Registro de espaço e conferência

Para conferir uma lista de endpoints compatíveis, consulte o recurso Space e o recurso ConferenceRecord na documentação da API REST do Meet.
Formato de eventos Uma mensagem do Google Cloud Pub/Sub, formatada de acordo com a especificação do CloudEvent. Para mais detalhes, consulte Estrutura dos eventos do Google Workspace. Um recurso da API REST do Meet (Space e ConferenceRecord)
Dados do evento String codificada em base64 com ou sem dados de recursos. Para exemplos de payloads, consulte Dados de eventos. Payload JSON que contém dados de recursos. Para um exemplo de payload, consulte o recurso ConferenceRecord na documentação de referência.

Limitações
  • Os convidados do Google Agenda e outros participantes de uma videoconferência só podem receber os seguintes eventos: google.workspace.meet.conference.v2.started e google.workspace.meet.transcript.v2.fileGenerated.