Inscreva-se em eventos do Google Meet

Nesta página, descrevemos 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 Meet.

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

Eventos do Meet compatíveis

Com as assinaturas do Google Workspace, você recebe 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 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:

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. Para mais detalhes, consulte 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 todos os espaços de reunião em que o usuário é o proprietário. Normalmente, o proprietário do espaço de reunião também é o organizador do evento do Google Agenda associado ao espaço.

Tipos de eventos para criar assinaturas

Ao criar uma assinatura de um recurso do Meet, use o campo eventTypes[] para especificar os tipos de eventos que você quer receber. Os tipos de eventos são formatados 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 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 eventos 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 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 transcript 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 de reunião do Meet. Os exemplos usam o ID do registro da conferência (por exemplo, conferenceRecords/AAA-BBB-CCC-DDD-EEE) para identificar o espaço de reunião. 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:

Exemplo Tipo de evento Payload JSON

Uma conferência é iniciada para o espaço de reunião do Meet.

google.workspace.meet.conference.v2.started
Exclui dados de recursos
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
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/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
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/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
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/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}