概览

本文档说明了 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 API、Metadata API 等等），且需要单独的客户端库。如果您所构建的应用（即移动应用）空间有限，这可能会成为继续使用 API v3 的一个因素。
  • 我们将继续支持早期版本的 API，但新功能将面向 API v4 进行开发。
  • 对 API v3 支持进行的所有更改都将在变更日志中发布。

后续步骤

快速入门指南

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

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

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