Google Ads API 资源使用政策更新

2024 年 5 月 1 日，星期三

有何变化？

我们将更新 Google Ads API 资源使用政策，以限制消耗过多 API 资源的 GoogleAdsService.Search 和 GoogleAdsService.SearchStream 查询句式。如果特定查询句式受到限制，其他服务、方法和查询句式将继续正常运行，不受影响。

从 2024 年 6 月 17 日这一周开始，仅针对受限的查询句式，请求将受到以下影响：

• 如果您使用的是 v17 或更早版本的 API，则会收到 QuotaError.RESOURCE_EXHAUSTED 错误。
• 如果您使用的是 v18 或更高版本的 API，则会收到 QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION 或 QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION，具体取决于资源消耗过多的情况是持续了很短的时间（几分钟）还是持续了很长的时间。

为了帮助您识别和监控费用高昂的报告，我们还会返回单个报告的费用指标。如需查看成功生成的报告的费用，请参阅以下字段：

• SearchGoogleAdsResponse.query_resource_consumption 字段。GoogleAdsService.Search
• SearchGoogleAdsStreamResponse.query_resource_consumption 字段。GoogleAdsService.SearchStream

此次变更的原因是什么？

我们做出这一更改是为了维护 API 的可靠性和稳定性。

我需要做什么？

在 2024 年 6 月 17 日之前，请更新您的应用，使其执行以下操作：

• 在进行 GoogleAdsService::Search or GoogleAdsService::SearchStream 调用时处理新的错误代码
  • 如果您使用的是 Google Ads API v17 或更早版本，请处理 QuotaError.RESOURCE_EXHAUSTED 错误。
  • 如果您使用的是 v18 或更高版本的 API，请处理 QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION 和 QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION 错误。
• 如果您的一个或多个报告查询句式受到限制，您应检查并修正查询句式。以下是一些提高查询性能的方法：
  • 降低查询运行频率。
  • 使用费用较低的查询句式或视图。

如需详细了解如何优化查询，请参阅管理数据效率。

• [可选] 将新的 query_resource_consumption 指标纳入监控系统，以检测和处理新的高开销查询。

如何获取帮助

如果您对本次变更有任何疑问，或者需要我们帮忙优化特定查询句式，请查看 Google Ads API 支持页面，了解可用的支持选项。

- David Stevens，Google Ads API 产品经理

标签： google-ads-api