Inscreva-se em eventos do Google Meet

Nesta página, descrevemos os eventos do Google Meet em que seu app pode se inscrever usando a API Events do Google Workspace. Depois de decidir de quais tipos de eventos você precisa, crie uma assinatura para começar a receber eventos do Google Meet.

Para saber mais sobre o desenvolvimento de apps para o Google Meet, consulte a Visão geral da API REST do Google Meet.

Recursos compatíveis com o público-alvo do Meet

Para receber eventos do Meet, a API Events do Google Workspace é compatível com assinaturas dos seguintes recursos:

  • Espaços para reuniões, representados como recursos space.
  • Usuários, representados como recursos user da API Cloud Identity.

Eventos do Meet compatíveis

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

Ao criar uma assinatura em um recurso do Meet, use o campo eventTypes[] para especificar quais tipos de eventos quer receber. Os tipos de evento 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 de uma videoconferência em 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 os tipos de evento compatíveis, uma descrição e o recurso do Meet alterado representado nos dados do evento:

Tipo de evento Descrição Recurso do Meet

google.workspace.meet.conference.v2.started

A videoconferência começa no espaço de reunião.

conferenceRecord

google.workspace.meet.conference.v2.ended

Uma videoconferência termina no espaço de reunião.

conferenceRecord

google.workspace.meet.participant.v2.joined

Um participante entra em uma videoconferência ativa no espaço da reunião.

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

um participante sai de uma videoconferência ativa no espaço para reuniões;

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

Um arquivo de gravação é gerado para uma videoconferência no espaço de reunião.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

Um arquivo de transcrição é gerado para uma videoconferência no espaço da reunião.

conferenceRecord.transcript

Dados de eventos

Nesta seção, descrevemos dados de eventos e exemplos de payloads para eventos nos espaços de reunião do Meet.

Quando sua assinatura do Google Workspace recebe um evento do Meet, o campo data contém o payload do evento. Esse payload contém informações sobre o recurso do Google Workspace que foi alterado. 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 transcript que mudou.

Dados de recursos no payload do evento

A tabela a seguir mostra exemplos de payloads JSON de uma assinatura de um espaço de reunião do Meet. Os exemplos usam a conferência conferenceRecords/AAA-BBB-CCC-DDD-EEE que ocorre no espaço. Para cada evento que a assinatura recebe, o payload aparece no campo data do evento:

Exemplo Tipo de evento Payload do JSON

Uma videoconferência vai ser iniciada no espaço para reuniões do Meet.

google.workspace.meet.conference.v2.started

Exclui dados de recursos
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
    }
}
Um participante entra em uma videoconferência no espaço de reunião do Meet.

google.workspace.meet.participant.v2.joined

Exclui dados de recursos
{
    "participantSession":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP"
    }
}
Uma gravação é gerada para uma videoconferência no espaço de reunião do Meet. google.workspace.meet.recording.v2.fileGenerated
Exclui dados de recursos
{
    "recording":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP"
    }
}
Uma transcrição é gerada para uma videoconferência no espaço de reunião do Meet. google.workspace.meet.transcript.v2.fileGenerated
Exclui dados de recursos
{
    "transcript":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
    }
}