Google Ads API 中的 Search 和 SearchStream 响应即将发生变化

2025 年 7 月 1 日，星期二

具体变化

去年，我们引入了 query_resource_consumption 指标，用于衡量 Google Ads API 查询的费用。不过，如果查询结果为空，则不会返回此费用。

自 2025 年 8 月 4 日这一周起，我们将修改所有 API 版本中 GoogleAdsService 的 Search 和 SearchStream 方法的行为，以便在查询结果为空时也返回 query_resource_consumption 指标和 field_mask 字段。空查询结果的响应将发生如下变化：

方法 旧回答 获取新回复
搜索 
{
    "fieldMask": "..."
}
 
{
    "fieldMask": "...",
    "query_resource_consumption": 123
}
SearchStream 
[]
 
{
    "fieldMask": "...",
    "queryResourceConsumption": 206
}

我需要做什么？

如果您使用 Search 和 SearchStream 方法下载 Google Ads API 报告，请确保您的应用可以处理修改后的响应。

如果您有任何疑问或需要帮助，请查看 Google Ads API 支持页面，了解各种支持选项。

如有任何与账号政策相关的问题，请与 Google Ads 产品支持团队联系。

作者肖像 - Google Ads API 团队 Oommen

标签： google-ads-api、 reporting