Genesys Cloud
Sortie prochaine d'un nouveau service d'interrogation sur l'utilisation avec un accès élargi aux données et à la pagination.
| Annoncé le | Date d’entrée en vigueur | L'idée d'Aha ! |
|---|---|---|
| 2025-04-21 | - | - |
Genesys Cloud a introduit un nouveau service de requête d'utilisation, qui remplace le service de requête d'utilisation public-api- existant, afin d'améliorer la façon dont les clients accèdent à leurs données d'utilisation et interagissent avec elles. Le 31 mars 2025, vous pourrez utiliser ce nouveau service pour exécuter des requêtes asynchrones sur un ensemble plus large de données, et pas seulement sur l'utilisation de l'API publique. Le nouveau service prend en charge la pagination complète et le contrôle de la taille des pages.
Pourquoi ce changement est-il important ?
Ce changement vise à donner aux clients un meilleur accès et une meilleure visibilité de l'utilisation de leur plateforme et à soutenir l'expansion future vers d'autres ensembles de données au-delà de l'utilisation de l'API publique. Auparavant, les points de terminaison de l'API publique appliquaient des filtres stricts ; par exemple, ils excluaient certains identifiants d'organisations au niveau du système et n'avaient pas de pagination.
Grâce à ce nouveau service, les clients pourront
- Ils disposent d'un meilleur contrôle sur leurs requêtes, y compris des filtres avancés par ID de client, plateforme, ID d'utilisateur, méthode HTTP, et plus encore.
- Accéder à des données complètes qui étaient auparavant cachées (par exemple, les clients OAuth comme purecloud ou purecloud-builtin sont maintenant inclus).
- Recevez des données plus rapidement et de manière plus fiable grâce à des tâches d'interrogation asynchrones.
- Paginer dans les résultats, en évitant les limitations sur les grands ensembles de résultats et en ayant la possibilité de gérer la taille des résultats.
Limitations
Les données mises à disposition par ce service comprennent toutes les activités d'utilisation, et pas seulement les données facturables. Les clients ne doivent pas utiliser cette API pour déterminer la facturation. Le service ne définit pas ce qui est ou n'est pas facturable.
Nouveaux points finaux 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}
Points finaux pour la dépréciation
- Divers points de terminaison api/v2/usage/query et api/v2/oauth/clients/{clientId}/usage
Détails de la transition
Les clients sont encouragés à migrer vers les nouveaux points de terminaison pour obtenir une vue complète et personnalisable de leurs données d'utilisation.
