Inscreva-se em eventos do Google Meet

Esta página descreve os eventos do Google Meet em que seu app pode se inscrever usando a API Google Workspace Events. Depois de decidir qual tipos de eventos de que precisa, crie uma para começar a receber eventos no Google Meet.

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

Eventos do Meet compatíveis

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

Recursos que podem ser monitorados para eventos

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

A API Google Workspace Events é compatível com os 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 na Nome do recurso do recurso space da API REST do Meet. Para mais detalhes, consulte Como O Meet identifica um espaço para reuniões.
Usuário //cloudidentity.googleapis.com/users/USER

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

A assinatura recebe eventos sobre espaços para reuniões em que usuário é um dos seguintes:

  • O proprietário do espaço para reuniões.
  • O organizador do evento do Google Agenda associado ao espaço da reunião.

Tipos de evento para a criação de assinaturas

Ao criar a assinatura de um recurso do Meet, você usa o eventTypes[] para especificar os tipos de eventos que você quer receber. Os tipos de evento são formatado de acordo com a especificação CloudEvents, como google.workspace.APPLICATION.RESOURCE.VERSION.ACTION: Por exemplo, para receber eventos sobre novos participantes em uma conferência de um Meet, especifique o tipo de evento como google.workspace.meet.participant.v2.joined: Para saber mais sobre como os eventos consulte Estrutura do Google Workspace eventos.

A tabela a seguir mostra os tipos de evento compatíveis, uma descrição e os recurso do Meet representado nos dados do evento:

Tipo de evento Descrição Recurso do Meet

google.workspace.meet.conference.v2.started

A conferência começa no espaço para reuniões.

conferenceRecord

google.workspace.meet.conference.v2.ended

A conferência termina no espaço da reunião.

conferenceRecord

google.workspace.meet.participant.v2.joined

Um participante entra em uma conferência ativa no espaço correspondente.

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

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

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

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

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

Um arquivo de transcrição é gerado no espaço para reuniões.

conferenceRecord.transcript

Dados de eventos

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

Quando sua assinatura do Google Workspace recebe um evento de Conheça, a 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ê assinou eventos sobre novas transcrições em um espaço, a carga desses eventos contém informações sobre o transcript que foi alterado.

Dados de recursos no payload do evento

A tabela a seguir fornece exemplos de payloads JSON para uma assinatura do um espaço para reuniões do Meet. Os exemplos usam o modelo de 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 começa no espaço de reunião 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 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 de uma conferência é gerada no espaço para reuniões 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 de uma conferência é gerada no espaço correspondente 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"
    }
}