准备客户帐号

在此步骤中,您需要确定要进行 API 调用的 Google Ads 帐号。您需要使用其电子邮件地址来生成 OAuth 2.0 刷新令牌。该帐号可以是生产(实时)帐号,也可以是测试帐号。每种方法都有自己的优缺点。

生产账号
测试账号
优点
  • 更轻松地编写和测试适用于特定帐号内容的代码。
  • 更轻松地编写和测试处理实时报告数据的代码。
  • 测试帐号不会投放广告,因此编程错误不会影响您的已投放广告系列。
  • 适用于具有测试访问权限级别的开发者令牌。
缺点
  • 开发阶段的编程错误可能会影响广告系列的实际投放,导致广告系列效果不佳、投放错误或财务损失等问题。
  • 开发者令牌至少应具有基本访问权限级别,才能进行 API 调用。
  • 您需要在测试帐号中重构广告系列,以测试适用于特定帐号内容的代码。
  • 由于测试帐号不投放广告,因此与实时投放相关的功能(例如报告统计信息、违反政策错误或处理线下转化数据导入)也不受支持,因此很难测试这些功能。

我们建议您在开发应用时尽可能使用测试帐号。有关说明,请参阅创建测试帐号和广告系列

另一种方法是为测试帐号不支持的功能明确设置一个帐号预算较低(如 1 美元/天)的生产帐号。

特征集选择

选择用于进行 API 调用的帐号时,还需要考虑您希望通过 API 使用哪些功能。即使您选择使用生产帐号,一些功能还是特定于帐号的,例如:

  • 要使用结算功能,您需要一个采用按月账单结算方式的账号。
  • 部分新功能可能只有列入许可名单的账号才能使用。

在最终确定用于发出 API 调用的帐号之前,请查看特定功能的文档,以确保该功能没有其他限制。

用户访问权限、登录客户 ID 和客户 ID

如需对 Google Ads 客户进行 API 调用,您需要直接或通过关联的经理帐号访问该客户。您还需要适当的权限,具体取决于特定 API 调用。

登录 Google Ads 时,您可能有多个客户账号可供选择。您选择的帐号会建立登录客户 ID(某些 API 调用的必需标头)以及您的访问权限级别。

在确定要向其发出 API 调用的 Google Ads 客户后,请注意以下详细信息:

  • 您计划对其发出 API 调用的客户帐号的 10 位数客户 ID。有时也称为操作客户。

  • 您所登录的客户帐号的电子邮件地址。生成 OAuth 2.0 刷新令牌时需要使用此文件。

  • 您所登录的客户帐号的 10 位数登录客户 ID。 如果您登录的是运营客户,则登录客户 ID 与客户 ID 相同。