Analytics API
Codex Analytics API의 목적과 관리 경계 이해하기
Analytics API는 ChatGPT 워크스페이스의 집계된 사용량 및 활동 지표를 제공합니다. 통합 Daily Usage Analytics API는 ChatGPT, Codex, Work의 일별 사용량을 보고합니다. 사용하기 전에 워크스페이스에서 해당 엔드포인트가 활성화되어 있는지 확인하세요.
Admin API 레퍼런스는 현재 액세스 요구 사항, 경로, 요청 및 응답 스키마, 지표, 시간의 의미, 페이지 매김에 대한 공식 기준입니다.
Analytics API를 사용해야 하는 경우
다음 작업이 필요할 때 Analytics API를 사용하는 것이 적합합니다.
- 정기적인 워크스페이스 사용량 보고를 자동화합니다.
- 집계된 사용량 지표를 조직 내부 데이터와 결합합니다.
- 승인된 대상자를 위해 통제된 보고 계층을 구축합니다.
- 통합 기능이 대화형 대시보드에 종속되지 않도록 합니다.
이 API는 원시 감사 로그 인터페이스가 아닙니다. 워크플로에 감사 가능한 활동 기록이 필요하면 Compliance API를 사용하세요.
관리 경계 확인하기
Analytics API 결과의 범위는 ChatGPT 워크스페이스로 한정됩니다. 통합 Daily
Usage Analytics API에는 워크스페이스 범위의 Admin 키를 사용하고
enterprise.analytics.usage.read 권한을 포함하세요. Codex 범위인
codex.enterprise.analytics.read는 해당 엔드포인트에 대한 액세스 권한을 부여하지 않습니다.
현재의 키 프로비저닝, 범위 요구 사항, 경로, 스키마, 필드, 시간 의미 체계 및 페이지네이션 동작은 API 레퍼런스를 기준으로 합니다. 이 페이지에서는 해당 계약을 중복해서 설명하지 않습니다.