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,请使用限定于工作区且具有
enterprise.analytics.usage.read 权限范围的 Admin 密钥。Codex 权限范围
codex.enterprise.analytics.read 不会授予该端点的访问权限。
API 参考负责定义当前的密钥配置、作用域要求、 路由、schema、字段、时间语义和分页行为。本页面 不会重复这份契约。