Cómo responder a eventos de Google Meet

En este documento, se explica cómo recibir eventos de Google Meet desde 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 los eventos para comprender lo que sucedió y, luego, tomar medidas o responder de manera significativa a tus usuarios.

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

  • Observar y responder a los cambios en una reunión, por ejemplo, cuando comienza o finaliza

  • Hacer 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.

Meet categoriza 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 Meet Tipo de evento
Un usuario se une a un espacio de reunión. Se crea un recurso ConferenceRecord. Nuevo récord de conferencia

Recibe datos de eventos de Google Meet

Para recibir datos de eventos, tu app puede realizar cualquiera de las siguientes acciones:

En la siguiente tabla, se explican las diferencias y los motivos para suscribirse a eventos en lugar de consultarlos:

Suscríbete a eventos Cómo consultar datos
Casos de uso
  • Procesar eventos o responder a ellos en tiempo real
  • Supervisa los cambios en los recursos para mejorar el rendimiento de tu app.
  • Recuperar datos manualmente
  • Recuperar todos los datos de Meet (debido a una interrupción o una suscripción inactiva)
API API de Google Workspace Events API de Meet
Fuente de eventos Registro de la conferencia y usuarios Registro de espacio y conferencia
Eventos admitidos Registro de conferencias

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

Para obtener una lista de los extremos admitidos, consulta el recurso Space y el recurso ConferenceRecord en la documentación de la API de REST de Meet.
Formato del evento Es un mensaje de Google Cloud Pub/Sub, con 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 Es una cadena codificada en Base64 con o sin datos de recursos. Para ver ejemplos de cargas útiles, consulta Datos de eventos. Es la carga útil JSON que contiene datos de recursos. Para ver un ejemplo de carga útil, consulta el recurso ConferenceRecord en la documentación de referencia.

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.