Responder a eventos do Google Meet

Este documento explica como receber e responder a eventos do Google Meet no 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. Você pode usar eventos para entender o que aconteceu e tomar medidas ou responder de maneira significativa para seus usuários.

Confira alguns exemplos de como usar eventos:

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

  • Acompanhar quem participou da reunião para fins regulatórios ou de treinamento.

  • Ouvir 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 enviar informações ao seu app sobre o tipo de atividade que ocorreu e o recurso da API REST do Meet afetado.

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

O Meet categoriza os eventos por tipo. Os tipos de evento ajudam a filtrar e receber apenas o tipo de informação necessário e permitem que você processe atividades semelhantes da mesma maneira.

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 do Meet recebe:

Atividade Recurso da API REST do Meet Tipo de evento
Um usuário entra em um espaço para reuniões. Um recurso ConferenceRecord é criado. Novo registro de conferência

Receber dados de eventos do Google Meet

Para receber dados de eventos, seu app pode fazer uma das seguintes ações:

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

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

Para uma lista de tipos de eventos aceitos, consulte Tipos de eventos para criar assinaturas na documentação da API Google Workspace Events. 		Espaço e registro de conferência

Para uma lista de endpoints aceitos, consulte o Space recurso e o ConferenceRecord recurso 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 de eventos 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 ConferenceRecord recurso na documentação de referência.

Exemplo: recuperar eventos sobre participantes em um espaço para reuniões

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

Inscrever-se em eventos

Para receber eventos em tempo real, o app do Meet chama o Google Workspace Events API subscriptions.create método para se inscrever no espaço para reuniões de todos os tipos de eventos. Depois de criar a assinatura, o app do 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 do Meet tem uma assinatura ativa no espaço para reuniões. Assim, o app recebe um evento sempre que uma sessão de participante muda no espaço para reuniões. O app do Meet pode responder em tempo real a qualquer uma das atividades, como saber quando um participante entra ou sai de uma conferê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 ocorrem, um app do Meet também pode chamar a API REST do Meet para listar eventos recentes do espaço para reuniões relacionados à atividade do participante.

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

Na Figura 3, um app do Meet chama o método da API REST do Meet conferenceRecords.participants.participantSessions.list depois que todas as atividades da sessão do participante ocorreram. A API REST do Meet retorna uma lista de recursos ParticipantSession que representam cada uma das mudanças. O app do 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 Agenda e outros participantes convidados para uma conferência só podem receber os seguintes eventos: google.workspace.meet.conference.v2.started e google.workspace.meet.transcript.v2.fileGenerated.