Suscríbete a eventos de Google Meet

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:

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 space de la API de REST de Meet. Para obtener más información, consulta Cómo Meet identifica una sala de reuniones.

Usuario //cloudidentity.googleapis.com/users/USER

donde USER es el ID en el Campo signedinUser.user del recurso participant de la API de REST de Meet. Para obtener más información, consulta Trabaja con los participantes.

La suscripción recibe eventos sobre salas de reuniones en los que la usuario es uno de los siguientes:

  • El propietario de la sala de reuniones.
  • El organizador del evento de Calendario de Google asociado a la sala de reuniones.

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

google.workspace.meet.conference.v2.started

Comienza una conferencia en la sala de reuniones.

conferenceRecord

google.workspace.meet.conference.v2.ended

Una conferencia termina 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 genera un archivo de grabación de una conferencia en la sala de reuniones.

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

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

conferenceRecord.transcript

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.

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