日本語

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 リファレンスで定義されています。このページでは、 その契約を重複して掲載しません。

関連ドキュメント