迁移核对清单

视频库:2021 年研讨会

下面是一份可帮助您顺利开始迁移的核对清单:

  1. 查看从 AdWords API 到 Google Ads API 的映射:

  2. 查看以下工具:

  3. 请在 API 中心接受更新后的条款及条件并更新您的联系信息。

    • 登录您获得了开发者令牌的经理帐号的 API 中心ads.google.com/aw/apicenter
    • 向下滚动到 API 联系电子邮件地址并更新。
    • 向下滚动到主要营业地点,接受新条件,然后点击保存
  4. 在 Google Cloud 项目中启用 Google Ads API。

    • 在 Google API 控制台中打开 API 库。如果出现提示,请选择您的项目或创建一个新项目。 API 库中列出了所有可用的 API(按产品系列和热门程度分组)。
    • 使用 Google Ads API 查找列表中未显示的 Google Ads API。
    • 选择 Google Ads API,然后点击启用按钮。
  5. 如果您已经用过 AdWords API,则您之前使用的凭据仍可用于 Google Ads API。请勿请求新的开发者令牌或创建新的 OAuth2 clientIdclientSecret 对。

  6. 选择一个客户端库。

  7. 浏览快速入门指南,进行首次调用。

使用客户端库

如果您使用的是 AdWords API 客户端库,则可以下载我们的某个 Google Ads API 客户端库,并立即开始使用。如需了解如何设置配置文件,请参阅客户端库的 README 文件。

在大多数情况下,从 AdWords API 客户端库迁移到 Google Ads API 客户端库时,可以重复使用现有的配置。其中一个主要区别是新的 login-customer-id我们的指南提供了关于何时需在配置中添加此配置的信息。

Java 配置示例

对于 Java 客户端库,您只需复制 ads.properties 文件中指定凭据的行,并将每个键中的 api.adwords 前缀更改为 api.googleads

api.adwords.clientId       --> api.googleads.clientId
api.adwords.clientSecret   --> api.googleads.clientSecret
api.adwords.refreshToken   --> api.googleads.refreshToken
api.adwords.developerToken --> api.googleads.developerToken

更新配置文件后,您可以继续发出首次调用:

Java

  1. 在 IDE 中,打开并执行 GetCampaigns.java
  2. 控制台应输出您帐号中的广告系列的列表。

C#

  1. 在 IDE 中,打开并执行 GetCampaigns.cs
  2. 控制台应输出您帐号中的广告系列的列表。

PHP

  1. 执行 GetCampaigns.php
  2. 控制台应输出您帐号中的广告系列的列表。

Python

  1. 在 IDE 中,打开并执行 get_campaigns.py
  2. 控制台应输出您帐号中的广告系列的列表。

Ruby

  1. 在命令行上,键入以下命令以执行 get_campaigns.rb
    ruby get_campaigns.rb
  2. 控制台应输出您帐号中的广告系列的列表。

Perl

  1. 执行 get_campaigns.pl
  2. 控制台应输出您帐号中的广告系列的列表。

代码示例

客户端库还提供分步代码示例,展示如何从 AdWords API 迁移到 Google Ads API。

Java

迁移示例

C#

迁移示例

PHP

迁移示例

Python

迁移示例

Ruby

迁移示例

Perl

迁移示例

客户端库的替代方案

如果您在使用 AdWords API 时未使用客户端库,并且也希望以此方式使用 Google Ads API,则仍然可以使用原来的凭据。

参阅 REST 指南,了解如何使用凭据通过 REST 通过 HTTP 对 Google Ads API 发出请求。