Suscríbete a eventos de Google Meet

En esta página, se describen los eventos de Google Meet a los que se puede suscribir tu app 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.

Si quieres obtener más información para desarrollar apps para Google Meet, consulta la descripción general de la API de REST de Google Meet.

Recursos de destino de Meet admitidos

Para recibir eventos de Meet, la API de Google Workspace Events admite suscripciones a los siguientes recursos:

  • Salas de reuniones, representadas como recursos space.
  • Usuarios, representados como recursos user de la API de Cloud Identity.

Eventos de Meet compatibles

Las suscripciones a Google Workspace te permiten recibir eventos sobre los siguientes tipos de cambios en Meet:

Cuando creas una suscripción a un recurso de Meet, usa el campo eventTypes[] para especificar qué tipos de eventos deseas recibir. Los tipos de eventos tienen el formato de 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, debes especificar el tipo de evento como google.workspace.meet.participant.v2.joined. Para obtener más información sobre cómo funcionan 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

google.workspace.meet.conference.v2.started

Una conferencia comienza en la sala de reuniones.

conferenceRecord

google.workspace.meet.conference.v2.ended

Una conferencia finaliza en la sala de reuniones.

conferenceRecord

google.workspace.meet.participant.v2.joined

Un participante se une a una conferencia activa en la sala de reuniones.

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

Un participante abandona una conferencia activa en la sala de reuniones.

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

Se generará un archivo de grabación para una conferencia en la sala de reuniones.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

Se generará un archivo de transcripción para una conferencia en la sala de reuniones.

conferenceRecord.transcript

Datos de eventos

En esta sección, se describen los datos de eventos y las cargas útiles de ejemplo para eventos en las salas 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 una sala de reuniones de Meet. En los ejemplos, se usa la conferencia conferenceRecords/AAA-BBB-CCC-DDD-EEE que se realiza 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

Comienza una conferencia en la sala de reuniones de Meet.

google.workspace.meet.conference.v2.started

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.

google.workspace.meet.participant.v2.joined

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 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"
    }
}