Cómo responder a eventos de Google Meet

En este documento, se explica cómo recibir eventos de Google Meet de Google Cloud Pub/Sub y responder a ellos.

Un evento de Meet representa una actividad o un cambio en un recurso de Meet, como la creación de una reunión nueva. Puedes usar eventos para comprender lo que sucedió y, luego, tomar medidas o responder de manera significativa para tus usuarios.

Estos son algunos ejemplos de cómo puedes usar eventos:

  • Observa los cambios en una reunión y responde a ellos, por ejemplo, cuando comienza o termina una reunión.

  • Haz un seguimiento de quién asistió a la reunión con fines reglamentarios o de capacitación.

  • Escucha la transcripción de la reunión para que el contenido del archivo se pueda analizar y registrar en un CRM o una base de datos.

Cómo funcionan los eventos

Cada vez que sucede algo en Google Meet, se crea o actualiza un recurso de la API de REST de Google Meet. Meet usa eventos para entregar información a tu app sobre el tipo de actividad que ocurrió y el recurso de la API de REST de Meet que se vio afectado.

Ejemplo de cómo un nuevo espacio de reuniones activa un evento.
Figura 1. Un usuario crea un espacio de reunión, lo que crea un Space recurso. Luego, Meet crea un evento que contiene datos sobre el nuevo espacio de reunión.

Meet clasifica los eventos por tipo. Los tipos de eventos te ayudan a filtrar y recibir solo el tipo de información que necesitas, y te permiten controlar actividades similares de la misma manera.

En el siguiente ejemplo, se muestra cómo una actividad en Meet afecta un recurso relacionado de la API de REST de Meet y el tipo de evento que recibe tu app de Meet:

Actividad Recurso de la API de REST de Meet Tipo de evento
Un usuario se une a un espacio de reunión. Se crea un recurso ConferenceRecord. Nuevo registro de conferencia

Recibe datos de eventos de Google Meet

Para recibir datos de eventos, tu app puede hacer lo siguiente:

En la siguiente tabla, se explica la diferencia y los motivos para suscribirse a eventos en lugar de consultarlos:

Suscríbete a eventos Consulta datos
Casos de uso
  • Procesa eventos o responde a ellos en tiempo real.
  • Supervisa los cambios en los recursos para mejorar el rendimiento de tu app.
  • Recupera datos de forma manual.
  • Recupera todos los datos de Meet (debido a una interrupción o una suscripción inactiva).
API API de Google Workspace Events API de REST de Meet
Fuente de eventos Registro de conferencia y usuarios Registro de espacio y conferencia
Eventos admitidos Registro de conferencia

Para obtener una lista de los tipos de eventos admitidos, consulta Tipos de eventos para crear suscripciones en la documentación de la API de Google Workspace Events. 		Registro de espacio y conferencia

Para obtener una lista de los extremos admitidos, consulta el Space recurso y el ConferenceRecord recurso en la documentación de la API de REST de Meet.
Formato del evento Un mensaje de Google Cloud Pub/Sub, con el formato según la especificación de CloudEvent Para obtener más detalles, consulta Estructura de los eventos de Google Workspace. Un recurso de la API de REST de Meet (Space y ConferenceRecord)
Datos de eventos String codificada en Base64 con o sin datos de recursos. Para ver ejemplos de cargas útiles, consulta Datos de eventos. Carga útil de JSON que contiene datos de recursos. Para ver un ejemplo de carga útil, consulta el ConferenceRecord recurso en la documentación de referencia.

Ejemplo: Recupera eventos sobre participantes en un espacio de reunión

En este ejemplo, una app de Meet quiere recibir información sobre los cambios de participantes en un espacio de reunión. En el espacio de reunión, un participante se une a una conferencia activa, lo que propaga un ParticipantSession recurso y activa un evento nuevo. Luego, puedes obtener información sobre estos eventos con el método de suscripción o de consulta.

Suscríbete a eventos

Para recibir eventos en tiempo real, la app de Meet llama al método subscriptions.create de la API de Google Workspace Events para suscribirse al espacio de reunión para todos los tipos de eventos. Después de crear la suscripción, la app de Meet puede comenzar a recibir eventos.

Una app de Meet que se suscribe a eventos de participantes con la API de Google Workspace Events.
Figura 2. Una app de Meet recibe eventos de participantes a través de una suscripción con la API de Google Workspace Events.

En la figura 2, la app de Meet tiene una suscripción activa al espacio de reunión, por lo que la app recibe un evento cada vez que cambia una sesión de participante en el espacio de reunión. Luego, la app de Meet puede responder en tiempo real a cualquiera de las actividades, como saber cuándo un participante se une a una conferencia activa o la abandona.

Para obtener información sobre cómo crear suscripciones con la API de Google Workspace Events, consulta la documentación de la API de Google Workspace Events.

Consulta eventos recientes

En lugar de recibir eventos a medida que ocurren, una app de Meet también puede llamar a la API de REST de Meet para enumerar los eventos recientes del espacio de reunión que están relacionados con la actividad de los participantes.

Una app de Meet que consulta eventos de participantes con la API de REST de Meet.
Figura 3. Una app de Meet recibe eventos recientes de participantes consultando eventos del espacio de reunión con la API de REST de Meet.

En la figura 3, una app de Meet llama al método de la API de REST de Meet conferenceRecords.participants.participantSessions.list después de que se produjeron todas las actividades de la sesión de participantes. La API de REST de Meet muestra una lista de recursos ParticipantSession que representan cada uno de los cambios. Luego, la app de Meet puede procesar o responder según la actividad reciente, como crear una lista de participantes que se unieron a la conferencia y la abandonaron.

Para consultar eventos con la API de REST de Meet, consulta Cómo enumerar todas las sesiones de participantes.

Limitaciones
  • Los invitados de 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.