En esta página, se describen los eventos de Google Meet a los que tu app puede suscribirse con la API de Google Workspace Events. Después de decidir qué tipos de eventos necesitas, crea una suscripción para comenzar a recibir eventos de Google Meet.
Para obtener más información sobre el desarrollo de apps para Google Meet, consulta la descripción general de la API de REST de Google Meet.
Eventos de Meet compatibles
Las suscripciones a Google Workspace te permiten recibir eventos sobre los siguientes tipos de cambios en Meet:
- Una conferencia comienza o termina en un espacio de reunión.
- Un participante se une o abandona una conferencia.
- Se genera una grabación para una conferencia.
- Se genera una transcripción para una conferencia.
Recursos que puedes supervisar para detectar eventos
Para recibir eventos, debes especificar un recurso de Meet que se supervisará, 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) |
|---|---|---|
| Espacio 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
En el que USER es el ID en el campo
|
La suscripción recibe eventos sobre espacios de reunión en los que el usuario es una de las siguientes opciones:
|
Tipos de eventos para crear suscripciones
Cuando creas una suscripción a un recurso de Meet, usas el campo eventTypes[] para especificar qué tipos de eventos deseas recibir. Los tipos de eventos se formatean según la especificación de CloudEvents, como google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.
Por ejemplo, para recibir eventos sobre participantes nuevos en una conferencia de un espacio de Meet, especifica el tipo de evento como google.workspace.meet.participant.v2.joined. Para obtener más información sobre el funcionamiento de los eventos, consulta Estructura de los eventos de Google Workspace.
En la siguiente tabla, se muestran los tipos de eventos admitidos, una descripción y el recurso de Meet modificado que se representa en los datos del evento:
| Tipo de evento | Descripción | Recurso de Meet |
|---|---|---|
|
Comienza una conferencia en el espacio de reuniones. |
|
|
Una conferencia finaliza en el espacio de reuniones. |
|
|
Un participante se une a una conferencia activa en el espacio de reuniones. |
|
|
Un participante abandona una conferencia activa en el espacio de reuniones. |
|
|
Se genera un archivo de grabación para una conferencia en el espacio de reuniones. |
|
|
Se genera un archivo de transcripción para una conferencia en el espacio de reuniones. |
|
Datos de eventos
En esta sección, se describen los datos de eventos y las cargas útiles de ejemplo para los eventos en los espacios de reuniones de Meet.
Cuando tu suscripción a Google Workspace recibe un evento de Meet, el campo 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 de estos eventos contiene información sobre el recurso transcript 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 un espacio de reuniones de Meet. En los ejemplos, se usa la conferencia 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 del evento:
| Ejemplo | Tipo de evento | Carga útil de JSON |
|---|---|---|
Se inicia una conferencia para el espacio 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 el espacio 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 una grabación para una conferencia en el espacio 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 una transcripción para una conferencia en el espacio 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"
}
}
|