제네시스 클라우드
확장된 데이터 액세스 및 페이지 매김 기능을 갖춘 새로운 사용 쿼리 서비스의 출시 예정
에 발표 | 발효일 | 아하! 아이디어 |
---|---|---|
2025-04-21 | - | - |
Genesys Cloud는 고객이 사용 데이터에 접근하고 상호 작용하는 방식을 개선하기 위해 기존 공용 API 사용 쿼리 서비스를 대체하는 새로운 사용 쿼리 서비스를 출시했습니다. 2025년 3월 31일부터 이 새로운 서비스를 사용하면 공개 API 사용뿐 아니라 더 광범위한 데이터에 대해 비동기 쿼리를 실행할 수 있습니다. 새로운 서비스는 전체 페이지 매김과 페이지 크기 제어를 지원합니다.
왜 이런 변화가 중요한가요?
이러한 변경의 목적은 고객에게 플랫폼 사용에 대한 더 나은 접근성과 가시성을 제공하고, 향후 공개 API 사용을 넘어 다른 데이터 세트로의 확장을 지원하는 것입니다. 이전에는 공개 API 사용 엔드포인트에 엄격한 필터가 적용되었습니다. 예를 들어, 일부 시스템 수준 조직 ID를 제외했고 페이지 매김 기능이 부족했습니다.
새로운 서비스를 통해 고객은 다음과 같은 이점을 얻을 수 있습니다.
- 클라이언트 ID, 플랫폼, 사용자 ID, HTTP 메서드 등을 기준으로 고급 필터를 적용해 쿼리에 대한 제어력을 강화하세요.
- 이전에는 숨겨져 있던 전체 데이터에 액세스할 수 있습니다(예: purecloud나 purecloud-builtin과 같은 OAuth 클라이언트가 이제 포함됨).
- 비동기 쿼리 작업으로 더 빠르고 안정적으로 데이터를 수신하세요.
- 대규모 결과 집합에 대한 제한을 피하고 출력 크기를 관리하는 기능을 얻어 결과를 페이지별로 나누어 봅니다.
제한 사항
이 서비스를 통해 제공되는 데이터에는 청구 가능한 데이터뿐만 아니라 모든 사용 활동이 포함됩니다. 고객은 이 API를 사용하여 청구를 결정해서는 안 됩니다. 이 서비스에서는 무엇이 청구 가능한지, 무엇이 청구 불가능한지를 정의하지 않습니다.
사용 가능한 새로운 엔드포인트
- 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}
사용 중단을 위한 엔드포인트
- 다양한 api/v2/usage/query 및 api/v2/oauth/clients/{clientId}/usage 엔드포인트
전환 세부 정보
고객은 사용 데이터에 대한 완전하고 사용자 정의 가능한 보기를 위해 새로운 엔드포인트로 마이그레이션하는 것이 좋습니다.