Genesys Cloud
Próximo lanzamiento de un nuevo servicio de consulta de uso con mayor acceso a los datos y paginación
| Anunciado el | Fecha efectiva | Idea |
|---|---|---|
| 2025-04-21 | - | - |
Genesys Cloud ha introducido un nuevo servicio de consulta de uso, que sustituye al actual servicio de consulta de uso público, para mejorar la forma en que los clientes acceden a sus datos de uso e interactúan con ellos. El 31 de marzo de 2025, podrá utilizar este nuevo servicio para realizar consultas asíncronas en un conjunto más amplio de datos, no sólo en el uso de la API pública. El nuevo servicio admite controles completos de paginación y tamaño de página.
¿Por qué es importante este cambio?
El objetivo de este cambio es ofrecer a los clientes un mejor acceso y visibilidad del uso de su plataforma y apoyar la futura expansión a otros conjuntos de datos más allá del uso de la API pública. Anteriormente, los puntos finales de uso de la API pública aplicaban filtros estrictos; por ejemplo, excluían algunos ID de org a nivel de sistema, y carecían de paginación.
Con el nuevo servicio, los clientes podrán:
- Disfrute de un mayor control sobre sus consultas, incluidos filtros avanzados por ID de cliente, plataforma, ID de usuario, método HTTP, etc.
- Accede a datos completos que antes estaban ocultos (por ejemplo, ahora se incluyen clientes OAuth como purecloud o purecloud-builtin).
- Reciba datos de forma más rápida y fiable con trabajos de consulta asíncronos.
- Pagine a través de los resultados, evitando las limitaciones en grandes conjuntos de resultados y ganando la capacidad de gestionar el tamaño de salida.
Limitaciones
Los datos que facilita este servicio incluyen toda la actividad de uso, no sólo los datos facturables. Los clientes no deben utilizar esta API para determinar la facturación. El servicio no define lo que es o no facturable.
Nuevos puntos finales disponibles
- POST /api/v2/usage/aggregates/query/jobs
- GET /api/v2/usage/aggregates/query/jobs/{jobId}
- POST /api/v2/usage/client/{clientId}/aggregates/query/jobs
- GET /api/v2/usage/client/{clientId}/aggregates/query/jobs/{jobId}
Puntos finales para su eliminación
- Varios puntos finales api/v2/usage/query y api/v2/oauth/clients/{clientId}/usage
Detalles de la transición
Se anima a los clientes a migrar a los nuevos terminales para obtener una visión completa y personalizable de sus datos de uso.
