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 產品支援團隊聯絡。

作者肖像 - Oommen，Google Ads API 團隊

標籤： google-ads-api、 reporting