분석 API는 ChatGPT 워크스페이스의 사용량과 활동 지표를 집계해 제공합니다. 통합 일일 사용량 분석 API에서는 ChatGPT, Codex, Work의 일별 사용량을 확인할 수 있습니다. 사용하기 전에 워크스페이스에서 해당 엔드포인트가 활성화되어 있는지 확인하세요.
현재 적용되는 접근 요건, API 경로, 요청 및 응답 스키마, 지표, 시간 값의 해석 방식, 페이지네이션에 관한 공식 기준은 관리자 API 레퍼런스에서 확인하세요.
분석 API를 사용하는 경우
다음과 같은 경우에 분석 API가 적합합니다.
- 워크스페이스 사용량에 대한 정기 보고를 자동화하려는 경우
- 집계된 사용량 지표를 조직 내부 데이터와 결합하려는 경우
- 승인된 사용자만 접근할 수 있는 보고 체계를 구축하려는 경우
- 연동 시스템이 대화형 대시보드에 의존하지 않도록 하려는 경우
분석 API는 원본 감사 로그를 제공하지 않습니다. 워크플로우에 감사 가능한 활동 기록이 필요하면 Compliance API를 사용하세요.
관리 범위와 접근 권한 확인
분석 API의 결과는 해당 ChatGPT 워크스페이스로 한정됩니다. 통합 일일 사용량 분석 API를 사용하려면 해당 워크스페이스에 한정된 관리자 키에 enterprise.analytics.usage.read 권한이 있어야 합니다. Codex용 codex.enterprise.analytics.read 권한만으로는 이 엔드포인트에 접근할 수 없습니다.
키 발급 방식, 필요한 권한 범위, API 경로, 스키마, 필드, 시간 값의 해석 방식, 페이지네이션 동작에 관한 최신 명세는 API 레퍼런스에서 확인하세요. 이 페이지에서는 해당 명세를 별도로 다루지 않습니다.