概览

本文档说明了 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：

• 如果您在应用中使用 Core Reporting API v3，将其迁移到 API v4，以利用 v4 的新功能。
• 从 API V3 迁移到 API V4 非常简单，原因是 V4 支持 V3 的细分和过滤条件语法。

继续使用这一 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，请参阅创建报告。