Google Ads API 資源使用政策更新

2024 年 5 月 1 日，星期三

異動內容

我們將更新 Google Ads API 資源用量政策，限制消耗過多 API 資源的 GoogleAdsService.Search 和 GoogleAdsService.SearchStream 查詢模式。如果特定查詢模式受到節流，其他服務、方法和查詢模式仍會繼續運作，不受影響。

自 2024 年 6 月 17 日當週起，只有受限的查詢模式會受到影響，具體情況如下：

  • 如果您使用 v17 或更早版本的 API，則會收到 QuotaError.RESOURCE_EXHAUSTED 錯誤。
  • 如果您使用的是 API 18 以上版本，則會收到 QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION 或 QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION，具體取決於資源消耗過多的情況是發生在短時間內 (幾分鐘)，還是長時間內。

為協助您找出並監控高成本報表，我們也會傳回個別報表的費用指標。如要查看成功報表的費用，請參閱下列欄位：

異動原因

這項異動是為了確保 API 的可靠性和穩定性。

我需要做些什麼？

請在 2024 年 6 月 17 日前更新應用程式，完成下列事項：

  • 在發出 GoogleAdsService::Search or GoogleAdsService::SearchStream 呼叫時處理新的錯誤代碼
    • 如果您使用的是 Google Ads API 第 17 版或更早版本，請處理 QuotaError.RESOURCE_EXHAUSTED 錯誤。
    • 如果您使用 API 的 v18 以上版本，請處理 QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION 和 QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION 錯誤。
  • 如果有一或多個報表查詢模式受到限制，請檢查並修正查詢模式。以下是提升查詢效能的方法：
    • 降低查詢執行頻率。
    • 使用費用較低的查詢模式或檢視表。

如要進一步瞭解如何最佳化查詢，請參閱「管理資料效率」。

  • [選用] 將新的 query_resource_consumption 指標納入監控系統，偵測及處理新的高成本查詢。

如何取得協助

如果對這項異動有任何疑問，或是需要調整特定查詢模式的協助，請前往 Google Ads API 支援頁面查看相關選項。

- Google Ads API 產品經理 David Stevens

標籤： google-ads-api