En esta página, se describen los eventos de Google Meet a los que puede suscribirse tu app con la API de Google Workspace Events. Después de decidir qué tipos de eventos que necesites, crea un suscripción para comenzar a recibir eventos de Google Meet.
Si quieres obtener más información para desarrollar apps para Google Meet, consulta la API de REST de Google Meet descripción general.
Eventos de Meet compatibles
Las suscripciones a Google Workspace te permiten recibir eventos sobre el los siguientes tipos de cambios en Meet:
- R conferencia empieza o termina en una sala de reuniones.
- R participante se une a una conferencia o la abandona.
- R grabación para una conferencia.
- R transcribir para una conferencia.
Recursos que puedes supervisar para detectar eventos
Para recibir eventos, especifica un recurso de Meet que supervisarás, que se denomina recurso de destino de la suscripción.
La API de Google Workspace Events admite los siguientes recursos de destino: para Meet:
Recurso de destino | Formato | Limitaciones (si corresponde) |
---|---|---|
Sala de reuniones | //meet.googleapis.com/spaces/SPACE
donde SPACE es el ID en el
nombre del recurso del recurso |
|
Usuario | //cloudidentity.googleapis.com/users/USER
donde USER es el ID en el
Campo |
La suscripción recibe eventos sobre salas de reuniones en los que la usuario es uno de los siguientes:
|
Tipos de eventos para crear suscripciones
Cuando creas una suscripción a un recurso de Meet, usas el
eventTypes[]
para especificar qué tipos de eventos deseas recibir. Los tipos de eventos son
formateado según la especificación de CloudEvents, como
google.workspace.APPLICATION.RESOURCE.VERSION.ACTION
Por ejemplo, para recibir eventos sobre nuevos participantes en una conferencia para una
de Meet, especificas el tipo de evento como
google.workspace.meet.participant.v2.joined
Para obtener más información sobre cómo
consulta Estructura de Google Workspace
eventos.
En la siguiente tabla, se muestran los tipos de eventos admitidos, una descripción y los recurso de Meet modificado que está representado en los datos del evento:
Tipo de evento | Descripción | Recurso de Meet |
---|---|---|
|
Comienza una conferencia en la sala de reuniones. |
|
|
Una conferencia termina en la sala de reuniones. |
|
|
Un participante se une a una conferencia activa en la sala de reuniones. |
|
|
Un participante abandona una conferencia activa en la sala de reuniones. |
|
|
Se genera un archivo de grabación de una conferencia en la sala de reuniones. |
|
|
Se genera un archivo de transcripción para una conferencia en la sala de reuniones. |
|
Datos de eventos
Esta sección describe datos de eventos y cargas útiles de ejemplo para eventos en Salas de reuniones de Meet.
Cuando tu suscripción a Google Workspace recibe un evento de
Conoce a los
data
contiene la carga útil del evento. Esta carga útil tiene información sobre el
recurso de Google Workspace que cambió. Por ejemplo, si te suscribiste a
eventos sobre transcripciones nuevas en un espacio, la carga útil para estos eventos contiene
información sobre el
transcript
recurso que cambió.
Datos de recursos en la carga útil del evento
En la siguiente tabla, se proporcionan ejemplos de cargas útiles de JSON para una suscripción a
una sala de reuniones de Meet. En los ejemplos, se usa el paquete
conferenceRecords/AAA-BBB-CCC-DDD-EEE
que se lleva a cabo en el espacio. Para cada evento
que recibe la suscripción, la carga útil aparece en el campo data
de la
evento:
Ejemplo | Tipo de evento | Carga útil de JSON |
---|---|---|
Comienza una conferencia en la sala de reuniones de Meet. |
|
Excluye los datos de recursos
{ "conferenceRecord": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE" } } |
Un participante se une a una conferencia en la sala de reuniones de Meet. |
|
Excluye los datos de recursos
{ "participantSession": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP" } } |
Se genera la grabación de una conferencia en la sala de reuniones de Meet. | google.workspace.meet.recording.v2.fileGenerated |
Excluye los datos de recursos
{ "recording": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP" } } |
Se genera la transcripción de una conferencia en la sala de reuniones de Meet. | google.workspace.meet.transcript.v2.fileGenerated |
Excluye los datos de recursos
{ "transcript": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT" } } |