Reuniones y Seminarios web con un solo participante

Mostrar los seminarios web y las reuniones unipersonales en el panel de control y en los informes

Los puntos de acceso o APIs designados para Dashboard/Panel de control y Reports/Informes, son excelentes herramientas para los clientes de Zoom que buscan obtener datos detallados de una gran variedad de funciones Zoom, con la primordial funcionalidad de generación de reportes y análisis de datos.

Cuando nos encontramos con reuniones o seminarios web con un solo participante, es importante hacer llamadas a la API con los query parameters apropiados, dependiendo del tipo de reunión que se está tratando obtener.

En la documentación para Dashboard y Reportes, al query parameter type(tipo) se le pueden asignar tres diferentes valores “past”, “pastOne” y el valor predeterminado “live”

Cuando se llaman estos puntos de acceso o APIs de manera programática y para evitar tener que cambiar el valor del query parameter o tipo de parámetro de consulta type de “past” a “pastOne” cada vez que nos encontramos con una reunión o seminario web con un solo participante, Zoom ofrece una funcionalidad que permite a los desarrolladores hacer solicitudes al endpoint a todas las reuniones en el pasado (incluidas las reuniones pasadas a las que asistió un solo usuario), con el mismo tipo de parámetro de consulta “past”

Pre requisitos

  • Para habilitar esta funcionalidad, la cuenta debe contar con un plan Business o superior.
  • dashboard_meetings:read:admin para aplicaciones Oauth Apps.
  • Se puede acceder a estos endpoints con credenciales JWT. (account level only)

¿Cómo habilitar dicha funcionalidad?

Esta funcionalidad debe ser habilitada por el administrador de la cuenta siguiendo los siguientes pasos:
Administración de Cuenta > Ajustes de Cuenta > Opciones de administración >
“Mostrar los seminarios web y las reuniones unipersonales en el panel de control y en los informes”

Nota:

Todos las reuniones o webinars pasados con un solo participante que se llevaron acabo antes de activar esta funcionalidad en la cuenta, se deberán seguir llamando con el parámetro de consulta/ query parameter type “pastOne”

Ejemplo usando postman

Punto de acceso: Get meeting details

Request URL: GET https://api.zoom.us/v2/metrics/meetings/85775354809?type=past
Response Body:

En el ejemplo anterior, noten como el valor de “participants” es 1 y el query parameter “type” es “past”. Si llamamos a la API nuevamente con el query parameter “type” “pastOne”, una vez configurada esta funcionalidad, nos devolverá un error 3001: Meeting does not exist.


Importante:
Cuando se active la propiedad “Mostrar los seminarios web y las reuniones unipersonales en el panel de control y en los informes”, todos los puntos de acceso referentes a Dashboards y Reportes serán accesibles con el query param “past” incluyendo Get meeting detail reports Zoom Meeting API

Espero que este post les ayude a descubrir y entender esta funcionalidad de manera práctica y la puedan implementar en futuros programas!

Saludos y no olviden compartir temas que les gustaría leer en Español!

Elisa

1 Like

Les dejo el post en Inglés también!

1 Like

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.