什么是 Core Reporting API - 概览

本文档简要介绍 Google Analytics(分析)Core Reporting API 版本 3.0 的相关信息。如需该 API 的详细参考,请参阅参考指南

简介

通过 Google Analytics(分析)Core Reporting API,您可以访问 Google Analytics(分析)中的多数报告数据。使用 Core Reporting API,您可以执行以下操作:

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

选择版本

我们最近发布了新版 Core Reporting API。

  • 要创建新应用?– 我们建议您使用最新的 3.0 版本。
  • 使用的是旧版本 2.3?– 参阅迁移指南,详细了解如何将您的应用更新为新版本。

使用入门

要立即开始使用?请参阅 Google Analytics(分析)API 入门教程

使用该 API 的每个应用都必须完成几个步骤,以完成注册、向用户授权和 API 方面的处理工作。该教程将指导您完成每个步骤,最终助您创建一个可正常运行且可自定义的应用。

概念概览

Core Reporting API 返回的报告数据源于对 Google Analytics(分析)跟踪代码收集到的数据的统计。每个报告均按维度和指标进行整理。您可以使用 Core Reporting API 查询维度和指标,以创建自定义报告。

Core Reporting API 包含 3 个基本概念:

  1. 报告与用户和数据视图(配置文件)之间的联系
  2. 报告的结构以及创建查询的方法
  3. 处理 API 响应

报告、用户和数据视图(配置文件)

要请求用户的报告数据,您的应用必须能识别此用户,并指定要从哪个数据视图(配置文件)提取数据。识别用户的方式是,获取授权凭证,并在每个 API 请求中传递授权凭证。数据视图(配置文件)是 Google Analytics(分析)配置层次结构的组成部分,可根据数据视图(配置文件)ID 进行识别。

您可以通过以下几种方式查找自己的数据视图(配置文件)ID。

  • 您的应用可以使用管理 API 遍历管理配置层次结构,以获取数据视图(配置文件)ID。
  • 在 Google Analytics(分析)每个报告的网址中。
  • Google Analytics(分析)中,点击菜单栏上的管理。选择数据视图所属的帐户和媒体资源。在数据视图列中,点击数据视图设置获取数据视图 ID。

查询维度和指标

您可以通过 API 查询由维度和指标组成的 Google Analytics(分析)报告数据。指标是对媒体资源上的用户活动进行衡量的具体元素,例如会话数和网页浏览量。维度可按一些常见的标准(例如国家/地区或浏览器)对指标进行细分。创建查询时,您需要指定要在报告数据中体现的维度和指标。

查看互动式维度和指标参考指南,了解能通过 API 获取的所有维度和指标。另请参阅 Core Reporting API 参考指南,了解如何在 API 查询中指定维度和指标。

使用报告

从 API 中返回的数据可被视为包含标题和行列表的表格。每个 API 响应均包含一个说明每列名称和数据类型的标题。响应还包含行的列表,其中每一行均是包含数据的单元格的列表(这些单元格的顺序与标题的顺序相同)。您可根据标题中的信息确定每个单元格中的数据的类型。

参阅 Core Reporting API 参考指南,详细了解 API 响应。

返回页首

配额和弃用政策

Google Analytics(分析)API 需要处理数以百万计的操作。为避免系统操作量超出其处理能力,并确保平均分配系统资源,我们需要采用配额机制。参阅限制和配额指南,了解具体限制。

如需详细了解如何处理对 Core Reporting API 列(即维度和指标)所做的更改,请参阅数据弃用政策。要了解如何使用 Metadata API 检查弃用的列,请参阅 Metadata API 开发指南

后续步骤

您现在已经了解了 API 的工作原理,接下来可以利用我们提供的大量资源开始使用 API:

  • 参阅开发者指南,了解如何使用 API。
  • 使用互动式查询浏览器工具直观地利用 API 创建查询并查看响应。
  • 参阅常用查询一文,了解 Core Reporting API 的一些最常见查询。
  • 查看维度和指标参考,了解可通过 API 获取的所有数据。
  • 访问库和示例页面,查看可与此 API 一起使用的客户端库的列表。

返回页首