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.

Exemplo de como um novo espaço de reunião aciona um evento.
Figura 1. Um usuário cria um espaço de reunião, o que gera um recurso Space. Em seguida, o Meet cria um evento que contém dados sobre o novo espaço de reunião.

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.

Exemplo: recuperar eventos sobre participantes em um espaço de reunião

Neste exemplo, um app do Meet quer receber informações sobre mudanças de participantes em um espaço de reunião. No espaço de reunião, um participante entra em uma conferência ativa, que preenche um recurso ParticipantSession e aciona um novo evento. Em seguida, você pode receber informações sobre esses eventos usando o método subscribe ou query.

Inscrever-se em eventos

Para receber eventos em tempo real, o app Meet chama o método subscriptions.create da API Google Workspace Events para se inscrever no espaço de reunião em todos os tipos de eventos. Depois de criar a assinatura, o app Meet pode começar a receber eventos.

Um app do Meet que se inscreve em eventos de participantes usando a API Google Workspace Events.
Figura 2. Um app do Meet recebe eventos de participantes por uma assinatura usando a API Google Workspace Events.

Na Figura 2, o app Meet tem uma assinatura ativa do espaço de reunião. Portanto, ele recebe um evento sempre que uma sessão de participante muda no espaço. O app Meet pode responder em tempo real a qualquer uma das atividades, como saber quando um participante entra ou sai de uma videoconferência ativa.

Para saber como criar assinaturas usando a API Google Workspace Events, consulte a documentação da API Google Workspace Events.

Consultar eventos recentes

Em vez de receber eventos à medida que eles ocorrem, um app do Meet também pode chamar a API REST do Meet para listar eventos recentes do espaço de reunião relacionados à atividade do participante.

Um app do Meet que consulta eventos de participantes usando a API REST do Meet.
Figura 3. Um app Meet recebe eventos recentes de participantes consultando eventos de espaço de reunião usando a API REST do Meet.

Na figura 3, um app Meet chama o método conferenceRecords.participants.participantSessions.list da API REST do Meet depois que todas as atividades da sessão do participante foram concluídas. A API REST do Meet retorna uma lista de recursos ParticipantSession que representam cada uma das mudanças. O app Meet pode processar ou responder com base na atividade recente, como criar uma lista de participantes que entraram e saíram da conferência.

Para consultar eventos usando a API REST do Meet, consulte Listar todas as sessões de participantes.

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.