概览

本文档说明了 Google Analytics(分析)Reporting API v4。有关这一 API 的详细参考,请参阅参考指南

简介

Google Analytics(分析)Reporting API v4 是访问 Google Analytics(分析)报告数据的最先进程序化方法。借助于 Google Analytics(分析)Reporting API,您可以:

  • 构建自定义信息中心,以展示 Google Analytics(分析)数据。
  • 自动完成复杂的报告任务,从而节约时间。
  • 将 Google Analytics(分析)数据与其他业务应用集成。

功能

Google Analytics(分析)构建在功能强大的数据报告的基础设施上。Google Analytics(分析)Reporting API v4 可供您使用 Google Analytics(分析)平台的强大功能。API 提供以下关键功能:

  • 指标表达式

    该 API 不仅允许您请求内置指标,还有数学运算中表达的指标组合。例如,您可以使用表达式 ga:goal1completions/ga:sessions 请求根据会话次数的目标达成次数。

  • 多个日期范围

    该 API 允许您在一个请求中获得两个日期范围的数据。

  • 同类群组和生命周期价值

    该 API 拥有丰富的词汇来请求同类群组和生命周期价值报告。

  • 多个细分

    该 API 允许您在一个请求中获得多个细分。

选择使用哪个版本的 Analytics Reporting API

构建新的应用:

使用 Analytics Reporting API v4 的原因是:

  • API v4 有丰富得多的功能集,如生命周期价值、同类群组以及高级细分报告。
  • 所有新的功能开发都将使用 API v4。

将现有的应用迁移为使用 API v4:

继续使用这一 API 的 v3 或更早的版本:

  • 该 Analytics Reporting API v4 独立于其他 v3 API(如 Management APIMetadata API 等等),且需要单独的客户端库。如果您所构建的应用(即移动应用)空间有限,这可能会成为继续使用 API v3 的一个因素。
  • 我们将继续支持早期版本的 API,但新功能开发将针对 API v4。
  • 对 API v3 支持的所有更改都将在变更日志中发布。

后续步骤

快速入门指南

下表提供了一套快速入门指南,帮助您快速上手。您需要选择语言和应用类型:

服务应用 安装版应用 网络应用
Java Java
Python Python
PHP PHP
JavaScript

要更好地了解如何使用 Analytics Reporting API v4,请参阅创建报告