借助 Google Analytics（分析）Data API v1，您能够以编程方式访问 Google Analytics（分析）4 (GA4) 报告数据。Google Analytics（分析）4 可帮助您了解用户如何使用您的网站、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：这是 runReport 方法的批处理版本，允许使用单个 API 调用生成多个报告。
- runPivotReport：此方法会返回您的 Google Analytics（分析）事件数据的自定义数据透视报告。与常规报告相比，数据透视报告是一种更高级、更具表现力的格式。每个数据透视都描述了报告响应中的可见维度列和行。
- batchRunPivotReports：这是 runPivotReport 方法的批量版本，可让您使用单个 API 调用生成多个报告。
- getMetadata：此方法会返回报告方法中提供的维度和指标的元数据。用于探索维度和指标。此方法的响应还包括适用于指定 GA4 媒体资源的自定义维度和指标。
- checkCompatibility：此方法会列出可添加到报告请求并保持兼容性的维度和指标。
- runRealtimeReport 此方法可为您的媒体资源返回自定义的实时事件数据报告。事件在发送到 Google Analytics（分析）几秒钟后就会显示在实时报告中。实时报告会显示从现在到 30 分钟前（Google Analytics 360 媒体资源最长为 60 分钟）这段时间的事件和使用情况数据。
- runFunnelReport（早期预览版）此方法会返回 Google Analytics（分析）事件数据的自定义漏斗报告。借助漏斗探索，您可以直观了解用户为完成任务而采取的步骤，并快速查看用户在每个步骤上的状况。
- properties.audienceLists （早期预览版）一组可用于生成受众群体名单的方法，其中包括受众群体中用户的概况。
支持的维度和指标
API 架构文档列出了 Google Analytics（分析）Data API 目前支持的维度和指标。