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:
- Uma conferência começa ou termina em um espaço de reunião.
- Um participante entra ou sai de uma videoconferência.
- Uma gravação é gerada para uma conferência.
- Uma transcrição é gerada para uma conferência.
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 |
---|---|---|
|
A videoconferência começa no espaço de reunião. |
|
|
Uma videoconferência termina no espaço de reunião. |
|
|
Um participante entra em uma videoconferência ativa no espaço da reunião. |
|
|
um participante sai de uma videoconferência ativa no espaço para reuniões; |
|
|
Um arquivo de gravação é gerado para uma videoconferência no espaço de reunião. |
|
|
Um arquivo de transcrição é gerado para uma videoconferência no espaço da reunião. |
|
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. |
|
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. |
|
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" } } |