Google Ads API 中的 CustomerService 即将发生变化

2025 年 2 月 27 日,星期四

我们将对 CustomerService.CreateCustomerClient 方法进行几项更改,以使 Google Ads API 与 Google Ads 界面处理新账号创建功能的方式保持一致。这些变更将于 2025 年 3 月 17 日生效。

政策强制执行方面的新错误代码
为了限制滥用行为,Google Ads API 在 v19 版本中引入了两个新的错误代码,用于政策强制执行。

  1. 如果 Google Ads 经理账号未达到特定支出阈值,或没有政策问题(例如,未因违反政策而被中止或关闭)的有效子账号数量未达到特定数量,则无法在其下创建子账号。在即将发布的 Google Ads API v19 版本中,开发者将收到 CustomerError.CREATION_DENIED_INELIGIBLE_MCC 错误代码。如需解决此问题,请关联一个符合 Google 政策且达到经理账号下支出水平最低限额的 Google Ads 账号。
  2. 如果 Google Ads 经理账号因违反与账号创建相关的政策而被标记,则无法再在其下创建子账号。在即将发布的 Google Ads API v19 中,开发者将收到 CustomerError.CREATION_DENIED_FOR_POLICY_VIOLATION 错误代码。

在这两种情况下,现有 API 版本(v18 及更早版本)都会抛出 ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT 错误。

账号创建配额限制
Google Ads API 将对新 Google Ads 账号的创建实施限制。达到限制后,开发者会收到 QuotaError.RESOURCE_EXHAUSTED 错误。quota_error_details 的 retry_delay 字段包含有关在重试 API 调用之前应等待多长时间的更多详细信息。我们预计大多数开发者不会受到这些限制的影响。

我需要做什么?
如果您的应用使用 Google Ads API 创建新的 Google Ads 账号,您应检查代码,确保应用能够正确处理这些新的错误代码。

如果您有任何疑问或需要帮助,请访问 Google Ads API 支持页面,了解各种支持选项。如有任何与账号政策相关的问题,请与 Google Ads 产品支持团队联系。

标签: authentication、 google-ads-api、 oauth