Inscreva-se em eventos do Google Meet

Esta página descreve os eventos do Google Meet que seu app pode assinar 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 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.

Eventos do Meet compatíveis

As assinaturas do Google Workspace permitem que você receba eventos sobre os seguintes tipos de mudanças no Meet:

Recursos que podem ser monitorados para eventos

Para receber eventos, especifique um recurso do Meet a ser monitorado, chamado de recurso de destino da assinatura.

A API Google Workspace Events oferece suporte aos seguintes recursos de destino para o Meet:

Recurso de destino Formato Limitações (se aplicável)
Espaço para reuniões //meet.googleapis.com/spaces/SPACE

em que SPACE é o ID no nome do recurso do recurso space da API REST do Meet. Confira mais detalhes em Como o Meet identifica um espaço de reunião.
Usuário //cloudidentity.googleapis.com/users/USER

em que USER é o ID no campo signedinUser.user do recurso participant da API REST do Meet. Para mais detalhes, consulte Trabalhar com participantes.

A assinatura recebe eventos sobre espaços de reunião em que o usuário é um dos seguintes:

  • O proprietário do espaço de reunião.
  • O organizador do evento do Google Agenda associado ao espaço de reunião.

Tipos de evento para criar assinaturas

Ao criar uma assinatura para um recurso do Meet, você usa o campo eventTypes[] para especificar os tipos de eventos que 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 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 os tipos de evento compatíveis, uma descrição e o recurso do Meet alterado que é representado nos dados do evento:

Tipo de evento Descrição Recurso do Meet

google.workspace.meet.conference.v2.started

Uma conferência começa no espaço de reunião.

conferenceRecord

google.workspace.meet.conference.v2.ended

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

conferenceRecord

google.workspace.meet.participant.v2.joined

Um participante entra em uma conferência ativa no espaço de reunião.

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

Um participante sai de uma conferência ativa no espaço de reunião.

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

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

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

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

conferenceRecord.transcript

Dados de eventos

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 o payload do evento. Esse payload tem informações sobre o recurso do Google Workspace que foi alterado. Por exemplo, se você se inscreveu para eventos sobre novas transcrições em um espaço, o payload desses eventos contém informações sobre o recurso transcript que foi alterado.

Dados de recursos no payload do evento

A tabela a seguir mostra exemplos de payloads JSON para uma assinatura de um espaço de reunião do Meet. Os exemplos usam a conferência conferenceRecords/AAA-BBB-CCC-DDD-EEE que acontece 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 conferência é 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 conferê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 conferê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 conferê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"
    }
}