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