您可以使用 Data API 以编程方式访问 Google Analytics（Google Analytics）报告数据。此 API 与旧版 Universal Analytics 媒体资源不兼容。
API 返回的数据与 Google Analytics 用户界面中显示的数据一致，并且完全遵循为 Google Analytics 媒体资源配置的报告身份设置（例如混合、观测或基于设备的身份）。
以下是一些您可以使用 Google Analytics Data API v1 生成的报告示例：
- 您的 Android 应用上周的日活跃用户数是多少。
- 您网站上排名前 10 的网页在过去 28 天内的网页浏览量。
- 过去 30 分钟内，您的 iOS 应用在每个国家/地区的活跃用户数。
您还可以使用 Google Analytics Data API v1 执行以下操作：
- 构建自定义信息中心，以展示 Google Analytics 数据。
- 自动完成复杂的报告任务，从而节约时间。
- 将 Google Analytics 数据与其他业务应用集成。
数据一致性和在报告中使用的 ID
Google Analytics Data API v1 访问的报告数据与 Google Analytics 界面相同。API 返回的数据完全遵循为 Google Analytics 媒体资源配置的报告中使用的 ID 设置，因此用户数、去重和数据建模与媒体资源设置中选择的身份空间（例如混合型、观测型或基于设备的 ID）保持一致。
如需详细了解不同的身份空间可能会对报告产生怎样的影响，请参阅在报告中使用的 ID。
开始使用
如需开始使用，请参阅客户端库快速入门。我们提供了 Java、Python、Node.js 和其他语言版本的客户端库，可简化您的实现。
可用的方法
以下是 Data API 方法的列表。如需了解详情，请参阅参考文档。
runReport：此方法会返回包含 Google Analytics 事件数据的自定义报告，是简单报告查询的首选方法。batchRunReports：此方法是 runReport 方法的批处理版本，可让您使用单个 API 调用生成多个报告。runPivotReport此方法会返回包含 Google Analytics 事件数据的自定义数据透视报告。透视报告是一种比常规报告更高级、更具表现力的格式。各个数据透视描述了报告响应中的可见维度列和行。batchRunPivotReports：此方法是 runPivotReport 方法的批处理版本，可让您使用单个 API 调用生成多个报告。getMetadata此方法会返回报告方法中提供的维度和指标的元数据。用于探索维度和指标。此方法的响应还包括可用于指定 Google Analytics 媒体资源的自定义维度和指标。checkCompatibility此方法会列出可添加到报告请求中并保持兼容性的维度和指标。runRealtimeReport此方法会返回您媒体资源的实时事件数据报告。事件在发送到 Google Analytics 后几秒钟内就会显示在实时报告中。实时报告会显示从当前时刻到 30 分钟前（对于 Google Analytics 360 版媒体资源，最长为 60 分钟）的时间段内的事件和使用情况数据。properties.audienceExports一组可让您生成受众群体导出数据的方法，其中包含受众群体中用户的快照。properties.recurringAudienceLists（早期预览版）一组可用于管理定期受众群体导出的方法。定期受众群体导出每天都会生成新的受众群体名单。runFunnelReport（抢先预览版）此方法会返回包含 Google Analytics 事件数据的自定义漏斗报告。借助漏斗探索，您可以直观了解用户为完成任务而采取的步骤，并能迅速查看用户在每个步骤的表现。
支持的维度和指标
如需查看 Data API 支持的所有维度和指标的列表，请参阅 API 架构文档。