Management API -“网络媒体资源”开发者指南

本文介绍了如何使用 Management API 来访问“网络媒体资源”数据。

简介

Google Analytics（分析）的“网络媒体资源”处于帐户层级结构的第二级；每个“网络媒体资源”有一个“帐户”资源作为父级，并且可以有一个子级，该子级是一个包含一个或多个“数据视图（配置文件）”资源的集合。

Google Analytics（分析）的“网络媒体资源”很重要，因为所有数据收集都在这一层级完成。例如，您在将跟踪代码添加到网站或移动应用时，必须包含一个采用 UA-xxxxx-y 格式的 ID。此 ID 称为“网络媒体资源 ID”，用来区分 Google Analytics（分析）帐户数据的存储位置。

开始之前

本指南说明了如何使用以下编程语言来访问 Google Analytics（分析）API：
  • Java
  • Python
  • PHP

  • 请阅读客户端库页面，查看与 Management API 配合使用的编程语言客户端库的完整列表。
  • 请阅读参考指南，了解如何在没有客户端库的情况下访问该 API

每个客户端库提供单个 Analytics 服务对象来访问所有的 Management API 数据。要创建服务对象，您通常需要完成以下步骤：

  1. 在 Google Developers Console 中注册您的应用。
  2. 授予访问 Google Analytics（分析）数据的权限。
  3. 创建一个 Analytics 服务对象。

如果您未能完成上述步骤，请停止操作，并阅读 Google Analytics（分析）API 入门教程。该教程将为您详细介绍构建 Google Analytics（分析）API 应用的最初几个步骤。完成这些步骤后，您就可以使用本指南执行实际任务了。

以下代码段从第 3 步（创建一个 Analytics 服务对象）继续，包含一个用来存储已获授权的服务对象的变量。

Java

Analytics analytics = // Read Hello Analytics Tutorial for details.

Python

analytics = # Read Hello Analytics Tutorial for details.

PHP

$client = // Read Hello Analytics Tutorial for details.

// Return results as objects.
$client->setUseObjects(true);

$analytics = new apiAnalyticsService($client);

PHP 库会将所有 API 结果作为一个关联数组来返回。要返回真正的对象，您可以调用客户端 useObject 方法，如上例所示。

创建了 Analytics 服务对象后，您就可以对 Management API 发出请求了。

注意：同一个 Analytics 服务对象也可以用来访问 Core Reporting API。

使用测试帐户

如果您打算使用 Management API 来创建和/或配置媒体资源，我们建议您通过测试帐户实现和验证您的代码。使用测试帐户可帮助您避免对某个有效的媒体资源做出意外更改。在使用测试帐户和媒体资源测试了您的代码，并确认这些代码运行正常后，您就可以开始在您的真实帐户中使用该代码了。

您可以在 Google Analytics（分析）网络界面的“管理”部分创建一个测试帐户。

代码示例

Management API 让您可以为授权用户列出、获取、插入、更新和修补媒体资源。要使用其中的任意一种方法，您首先需要创建一个 Analytics 服务对象，如开始之前部分所述。

要查看代码示例，了解如何使用“网络媒体资源”资源，请访问下面的方法参考：

  • list — 列出用户有访问权限的网络媒体资源。
  • get — 获取用户有访问权限的网络媒体资源。
  • insert — 创建新的网络媒体资源。
  • patch — 更新现有的网络媒体资源。此方法支持修补语义。
  • update — 更新现有的网络媒体资源。

示例应用

请查看“Management API 参考示例”中列举的操作示例，了解如何遍历和访问 Management API 中的所有数据。

Java


Google Analytics（分析）API Java 客户端库示例

Python


Google Analytics（分析）API Python 客户端库示例

PHP


Google Analytics（分析）API PHP 客户端库示例