Genesys Cloud
Bevorstehende Veröffentlichung eines neuen Nutzungsabfragedienstes mit erweitertem Datenzugriff und Paginierung

Angekündigt am Datum des Inkrafttretens Aha! Idee
2025-04-21 - -

Genesys Cloud hat einen neuen Nutzungsabfragedienst eingeführt, der den vorhandenen öffentlichen API-Nutzungsabfragedienst ersetzt, um den Zugriff der Kunden auf ihre Nutzungsdaten und die Interaktion mit ihnen zu verbessern. Ab dem 31. März 2025 können Sie mit diesem neuen Dienst asynchrone Abfragen für einen größeren Datensatz ausführen, nicht nur für die Verwendung öffentlicher APIs. Der neue Dienst unterstützt die vollständige Paginierung und Seitengrößensteuerung.

Warum ist diese Änderung wichtig?

Diese Änderung zielt darauf ab, Kunden einen besseren Zugriff und Einblick in ihre Plattformnutzung zu geben und die zukünftige Erweiterung auf andere Datensätze über die öffentliche API-Nutzung hinaus zu unterstützen. Zuvor wendeten die öffentlichen API-Nutzungsendpunkte strenge Filter an, beispielsweise den Ausschluss einiger Org-IDs auf Systemebene, und es fehlte die Paginierung. 

Mit dem neuen Service können Kunden:

  • Erleben Sie mehr Kontrolle über Ihre Abfragen, einschließlich erweiterter Filter nach Client-ID, Plattform, Benutzer-ID, HTTP-Methode und mehr.
  • Greifen Sie auf vollständige Daten zu, die zuvor verborgen waren (beispielsweise sind jetzt OAuth-Clients wie purecloud oder purecloud-builtin enthalten).
  • Empfangen Sie Daten schneller und zuverlässiger mit asynchronen Abfrageaufträgen.
  • Durch Paginieren der Ergebnisse können Sie Einschränkungen bei großen Ergebnismengen vermeiden und die Ausgabegröße verwalten.

Beschränkungen

Die von diesem Dienst bereitgestellten Daten umfassen sämtliche Nutzungsaktivitäten, nicht nur die kostenpflichtigen Daten. Kunden sollten diese API nicht zur Abrechnung verwenden. Der Dienst definiert nicht, was abrechenbar ist und was nicht.

Neue verfügbare Endpunkte

  • 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}

Endpunkte für die Abkündigung

  • Verschiedene api/v2/usage/query und api/v2/oauth/clients/{clientId}/usage-Endpunkte

Übergangsdetails

Kunden werden ermutigt, auf die neuen Endpunkte zu migrieren, um eine vollständige und anpassbare Ansicht ihrer Nutzungsdaten zu erhalten.