Suscríbete a eventos de Google Meet

En este documento, 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.

Además de suscribirte a eventos, también puedes consultar eventos llamando a la API de REST de Google Meet. Llama a la API de REST de Meet para recuperar eventos de forma periódica o ponerte al día con los eventos que podrías haberte perdido de una suscripción debido a una interrupción. Para obtener información sobre las formas en que puedes recibir y responder a eventos de Meet, consulta Cómo responder a eventos de Google Meet en la documentación 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:

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:

Recurso objetivo Formato Limitaciones (si corresponde)
Sala de reuniones //meet.googleapis.com/spaces/SPACE

donde SPACE es el ID en el nombre del recurso del recurso spaces de la API de REST de Meet. Para obtener más información, consulta Cómo identifica Meet un espacio de reunión.
Usuario //cloudidentity.googleapis.com/users/USER

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

La suscripción recibe eventos sobre todos los espacios de reuniones de los que el usuario es propietario. Por lo general, el propietario del espacio de reunión también es el organizador del evento de Calendario de Google asociado al espacio de reunión.

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 para las suscripciones a recursos de Meet:

Tipo de evento Formato Datos de recursos
Comienza una conferencia en el espacio de reunión. google.meet.conference.v2.started conferenceRecord
Finaliza una conferencia en el espacio de reuniones. google.meet.conference.v2.ended conferenceRecord
Un participante se une a una conferencia activa en el espacio de la reunión. google.meet.participant.v2.joined conferenceRecord.participantSession
Un participante abandona una conferencia activa en el espacio de la reunión. google.meet.participant.v2.left conferenceRecord.participantSession
Se genera un archivo de grabación para una conferencia en el espacio de la reunión. google.meet.recording.v2.fileGenerated conferenceRecord.recording
Se genera un archivo de transcripción para una conferencia en el espacio de la reunión. google.meet.transcript.v2.fileGenerated conferenceRecord.transcript

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 transcripts 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/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) 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:

Ejemplo Tipo de evento Carga útil de JSON

Comienza una conferencia para el espacio de reuniones de Meet.

google.workspace.meet.conference.v2.started
Excluye los datos de recursos
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
Un participante se une a una conferencia en el espacio de la reunión de Meet.

google.workspace.meet.participant.v2.joined
Excluye los datos de recursos
{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
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/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
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/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}

Limitaciones
  • Los invitados al Calendario y otros participantes invitados a una conferencia solo pueden recibir los siguientes eventos: google.workspace.meet.conference.v2.started y google.workspace.meet.transcript.v2.fileGenerated.