Suscríbete a eventos de Google Meet

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 Meet.

Para obtener más información sobre el desarrollo de apps para Meet, consulta la descripción general de la API de REST de Google Meet.

Eventos de Meet admitidos

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

• Comienza o finaliza una conferencia en un espacio de reunión.
• Un participante se une a una conferencia o la abandona.
• 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 para 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:

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 los 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:

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 contiene 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 del recurso 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 reunión de Meet. En los ejemplos, se usa el ID de registro de la conferencia (por ejemplo, conferenceRecords/AAA-BBB-CCC-DDD-EEE) para identificar el espacio de la reunión. Para obtener más información, consulta Cómo identifica Meet un espacio de reunión.

Para cada evento que recibe la suscripción, la carga útil aparece en el campo data del evento:

{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
      

{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
      

{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
      

{
    "transcript":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}
      

Temas relacionados

• Descripción general de la API de Google Workspace Events
• Estructura de los eventos de Google Workspace
• Elige los alcances de la API de Google Workspace Events
• Descripción general de la API de REST de Google Meet
• Elige los alcances de la API de REST de Google Meet
• Instructivo: Observa eventos de reuniones con Python y la API de REST de Google Meet