Management API -“AdWords 关联”开发者指南

本文介绍了如何使用 Management API 来管理授权用户的 AdWords 帐户与 Google Analytics(分析)帐户之间的关联。

简介

Management API 中的“AdWords 关联”让您可以获取、列出、创建、更新和删除 Google AdWords 帐户与 Google Analytics(分析)媒体资源之间的关联,并确定哪些数据视图(配置文件)中要出现 AdWords 数据。

要详细了解 AdWords 关联功能的工作原理和好处,请参阅将 Google Analytics(分析)与 AdWords 关联起来(AdWords 帮助中心)以及关联/取消关联 Google Analytics(分析)和 AdWords(Google Analytics(分析)帮助中心)

开始之前

所有 Google Analytics(分析)API 的访问方法都基本相同。在开始使用 Management API 之前,您应该:

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

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

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

如果您未能完成上述步骤,请停止操作,并阅读了解 Google Analytics(分析)API 教程。该教程将为您详细介绍构建 Google Analytics(分析)API 应用的最初几个步骤。完成这些步骤后,您将了解如何访问 Google Analytics(分析)API 以执行实际任务。

使用情形

使用 Management API 的 AdWords 关联功能,以下使用情形将自动得到执行:

列出媒体资源的所有 Google Analytics(分析)与 AdWords 之关联

要列出媒体资源的所有有效的 Analytics/AdWords 关联,请按以下步骤操作:

  1. 使用 Management API 或网络界面获取帐户 Id 和媒体资源 Id。
  2. 执行 entityAdWordsLinks 资源的 list 方法。

请参阅 API 参考,详细了解 entityAdWordsLinks 资源的 list 方法。

创建 Google Analytics(分析)与 AdWords 的新关联

要创建 Google Analytics(分析)媒体资源与 AdWords 帐户之间的关联,请按以下步骤操作:

  1. 使用 AdWords API 或网络界面获取 Customer Id。
  2. 使用 Google Analytics(分析)Management API 或网络界面获取要与 AdWords 帐户关联的帐户及媒体资源的 Id。
  3. 通过执行 entityAdWordsLinks 资源的 insert 方法,创建 AdWords 与 Google Analytics(分析)之间的关联。

请参阅 API 参考,详细了解 entityAdWordsLinks 资源的 insert 方法。

要删除 Google Analytics(分析)媒体资源与 AdWords 帐户之间的关联,请按以下步骤操作:

  1. 使用 Google Analytics(分析)Management API 或网络界面获取要删除关联的帐户及媒体资源的 Id。
  2. 使用 Management API 获取“AdWords 关联”的 Id。
  3. 通过执行 entityAdWordsLinks 资源的 delete 方法,删除该关联。

请参阅 API 参考,详细了解 entityAdWordsLinks 资源的 delete 方法。

将数据视图(配置文件)添加到现有的 Analytics/AdWords 关联

要为数据视图(配置文件)报告启用 AdWords 数据,请按以下步骤操作:

  1. 使用 Google Analytics(分析)Management API 或网络界面获取帐户、媒体资源和数据视图(配置文件)的 Id。
  2. 使用 Management API 获取要关联到数据视图(配置文件)的“AdWords 关联”的 Id。
  3. 通过执行 entityAdWordsLinks 资源的 patch 方法,添加数据视图(配置文件)。

请参阅 API 参考,详细了解 entityAdWordsLinks 资源的 patch 方法。

将数据视图(配置文件)从 Analytics/AdWords 关联中移除

要为数据视图(配置文件)报告取消关联并移除 AdWords 数据,请按以下步骤操作:

  1. 使用 Google Analytics(分析)Management API 或网络界面获取帐户、媒体资源和数据视图(配置文件)的 Id。
  2. 使用 Management API 获取要移除的数据视图(配置文件)所关联的“AdWords 关联”的 Id。
  3. 执行 entityAdWordsLinks 资源的 get 方法,获取“AdWords 关联”的配置文件 Id 列表。
  4. 从上述第 3 步中获取的列表中删除相应的配置文件 Id。
  5. 使用第 4 步中的列表,通过执行 entityAdWordsLinks 资源的 patch 方法,移除数据视图(配置文件)。

请参阅 API 参考,详细了解 entityAdWordsLinks 资源的 get 方法。

代码示例

AdWords Links 资源让授权用户可以列出、获取、删除、更新、修补和插入“AdWords 关联”。要进行这些操作,您首先需要创建一个 Analytics 服务对象,如开始之前部分所述。

要查看代码示例,了解如何使用“AdWords 关联”,请访问下面的方法参考:

管理“AdWords 关联”

  • list — 列出用户可以访问的“AdWords 关联”。
  • get — 获取用户可以访问的“AdWords 关联”。
  • insert — 创建新的“AdWords 关联”。
  • patch — 修补现有的“AdWords 关联”。
  • update - 更新现有的“AdWords 关联”。
  • delete - 删除现有的“AdWords 关联”。