Inscreva-se em eventos do Google Meet

Este documento descreve os eventos do Meet aos quais seu app pode se inscrever usando a API Google Workspace Events. Depois de decidir quais tipos de eventos você precisa, crie uma assinatura para começar a receber eventos do Meet.

Além de se inscrever em eventos, você também pode consultar eventos chamando a API REST do Google Meet. Chame a API REST do Meet para recuperar eventos periodicamente ou recupere eventos que você pode ter perdido de uma assinatura devido a uma interrupção. Para saber como receber e responder a eventos do Meet, consulte Responder a eventos do Meet na documentação do Meet.

Para saber mais sobre como desenvolver apps para o Meet, consulte a visão geral da API REST do Meet.

Eventos do Meet compatíveis

Com as assinaturas do Google Workspace, você recebe eventos sobre os seguintes tipos de mudanças no Meet:

• Uma conferência começa ou termina em um espaço de reunião.
• Um participante entra ou sai de uma conferência.
• Uma gravação começa, termina ou um arquivo é gerado para uma conferência.
• Uma observação inteligente começa, termina ou um arquivo é gerado para uma conferência.
• Uma transcrição é iniciada, encerrada ou um arquivo é gerado para uma conferência.

Recursos que podem ser monitorados para eventos

Para receber eventos, especifique um recurso do Meet para monitorar, que é chamado de recurso de destino da assinatura.

A API Google Workspace Events é compatível com os seguintes recursos de destino do Meet:

Tipos de eventos para criar assinaturas

Ao criar uma assinatura de um recurso do Meet, use o campo eventTypes[] para especificar quais tipos de eventos você quer receber. Os tipos de eventos são formatados de acordo com a especificação do CloudEvents, como google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.

Por exemplo, para receber eventos sobre novos participantes em uma conferência de um espaço do Meet, especifique o tipo de evento como google.workspace.meet.participant.v2.joined. Para saber mais sobre como os eventos funcionam, consulte Estrutura dos eventos do Google Workspace.

A tabela a seguir mostra quais tipos de eventos são compatíveis com assinaturas de recursos do Meet:

Dados do evento

Esta seção descreve os dados de eventos e exemplos de payloads para eventos em espaços de reunião do Meet.

Quando sua assinatura do Google Workspace recebe um evento do Meet, o campo data contém a carga útil do evento. Esse payload tem informações sobre o recurso do Google Workspace que mudou. Por exemplo, se você se inscreveu em eventos sobre novas transcrições em um espaço, o payload desses eventos contém informações sobre o recurso transcripts que mudou.

Dados de recursos no payload do evento

A tabela a seguir mostra exemplos de payloads JSON para uma assinatura de um espaço para reuniões do Meet. Os exemplos usam o ID do registro da conferência (por exemplo, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) para identificar o espaço para reuniões. Para mais informações, consulte Como o Meet identifica um espaço de reunião.

Para cada evento que a assinatura recebe, o payload aparece no campo data do evento:

{
  "conferenceRecord":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID"
  }
}
      

{
  "participantSession":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
  }
}
      

{
  "recording":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
  }
}
      

{
  "smartNote":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/smartNotes/SMART_NOTE_ID"
  }
}
      

{
  "transcript":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
  }
}
      

• Os convidados do Google 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.

Temas relacionados

• Visão geral da API Google Workspace Events
• Estrutura dos eventos do Google Workspace
• Escolher escopos da API Google Workspace Events
• Visão geral da API REST do Meet
• Escolher escopos da API REST do Meet
• Tutorial: observar eventos de reunião com Python e a API REST do Meet