您可以使用 Data API 以 编程方式访问 Google Analytics（分析）报告数据。此 API 与旧版 Universal Analytics 媒体资源不兼容。
以下是您可以使用 Google Analytics Data API v1 报告的一些示例：
- 您的 Android 应用上周的日活跃用户数是多少。
- 过去 28 天内，您的网站内排名前 10 的网页获得了多少网页浏览量。
- 过去 30 分钟内，您的 iOS 应用在每个国家/地区有多少活跃用户。
您还可以使用 Google Analytics Data API v1 执行以下操作：
- 构建自定义信息中心，以展示 Google Analytics 数据。
- 自动完成复杂的报告任务，从而节约时间。
- 将 Google Analytics 数据与其他业务应用集成。
数据一致性和在报告中使用的 ID
Google Analytics Data API v1 访问的报告数据与 Google Analytics 界面相同。API 返回的数据完全遵循为您的 Google Analytics 媒体资源配置的报告身份 设置，因此用户数、重复数据排除和数据建模与您在媒体资源设置中选择的身份空间（例如混合型、观察型或基于设备的身份空间）保持一致。
如需详细了解不同的身份空间如何影响在报告中使用的 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 架构文档。