Analytics API
Codex Analytics API の目的と管理上の境界を理解します
Analytics API は、ChatGPT ワークスペースの利用状況とアクティビティの 集計指標を提供します。統合された Daily Usage Analytics API は、ChatGPT、Codex、 Work の日次利用状況を報告します。利用する前に、お使いのワークスペースでエンドポイントが 有効になっていることを確認してください。
Admin API リファレンスが、 現在のアクセス要件、ルート、リクエストとレスポンスの スキーマ、指標、時刻の扱い、ページネーションに関する正式な情報源です。
Analytics API を使用する場合
Analytics API は、次のことが必要な場合に適しています。
- ワークスペースの利用状況に関する定期レポートを自動化します。
- 集計された利用指標を組織内のデータと結合します。
- 許可された対象者向けに、管理されたレポート基盤を構築します。
- 連携機能が対話型ダッシュボードに依存するのを避けます。
これは未加工の監査ログ用インターフェースではありません。ワークフローに監査可能なアクティビティ記録が必要な場合は、 Compliance APIを使用してください。
管理上の境界を確認する
Analytics API の結果は、ChatGPT ワークスペースの範囲に限定されます。統合された Daily
Usage Analytics API では、ワークスペースをスコープとする Admin キーに
enterprise.analytics.usage.read を設定して使用してください。Codex のスコープ
codex.enterprise.analytics.read では、このエンドポイントへのアクセス権は付与されません。
現在のキーのプロビジョニング、スコープ要件、ルート、スキーマ、フィールド、 時間のセマンティクス、ページネーションの動作は API リファレンスで定義されています。このページでは、 その契約を重複して掲載しません。