您可以通过 Google Analytics（分析）Data API v1 以程序化方式访问 Google Analytics（分析）4 (GA4) 报告数据。Google Analytics（分析）4 可帮助您了解用户如何使用您的 Web、iOS 或 Android 应用。详细了解 Google Analytics（分析）4 媒体资源。
借助 Google Analytics（分析）Data API v1，您可以创建报告来解答以下问题：
- 过去一周内我的 Android 应用有多少日活跃用户数？
- 在过去 28 天中，我的网站排名前 10 的网页分别获得了多少次网页浏览？
- 过去 30 分钟内，我的 iOS 应用在每个国家/地区有多少用户？
Google Analytics（分析）Data API v1 也可用于：
- 构建自定义信息中心，以展示 Google Analytics（分析）数据。
- 自动完成复杂的报告任务，从而节约时间。
- 将 Google Analytics（分析）数据与其他业务应用集成。
快速入门指南
只需编写几行代码，即可调用 API 来创建您的第一个报告。 如需开始使用，请参阅快速入门：使用客户端库。Java、Python、Node.js 和其他语言的客户端库可简化您的实现过程。
可用方法
- runReport：此方法会返回 Google Analytics（分析）事件数据的自定义报告，是简单报告查询的首选方法。
- batchRunReports：此 runRun 方法的批量版本，可使用单个 API 调用生成多个报告。
- runPivotReport：此方法会返回包含 Google Analytics（分析）事件数据的自定义数据透视报告。与常规报告相比，数据透视报告是一种更高级、更具表现力的格式。每个数据透视都描述了报告响应中可见的维度列和行。
- batchRunPivotReports：此 runPivotReport 方法的批量版本允许通过单个 API 调用生成多个报告。
- getMetadata 此方法会返回报告方法中提供的维度和指标的元数据。用于探索维度和指标。此方法的响应还包含适用于指定 GA4 媒体资源的自定义维度和指标。
- runRealtimeReport 此方法会返回媒体资源的实时事件数据的自定义报告。事件在发送到 Google Analytics（分析）后几秒钟内就会显示在实时报告中。实时报告会显示从当前时刻到 30 分钟之间的事件和使用情况数据（Google Analytics 360 媒体资源最多 60 分钟）。
- runFunnelReport （早期预览版）此方法会返回您的 Google Analytics（分析）事件数据的自定义漏斗报告。借助漏斗探索，您可以直观了解用户为完成任务而采取的步骤，并能迅速查看用户在每个步骤的表现。
支持的维度和指标
API 架构文档中列出了 Google Analytics（分析）Data API 目前支持的维度和指标。