使用 GoogleAdsService 回報串流

如要擷取 Google Ads API 實體和報表資料,請使用下列任一方法:

以下是這兩種方法的大致差異:

GoogleAdsService.SearchStream GoogleAdsService.Search
適合正式版程式碼
服務 GoogleAdsService GoogleAdsService
情境 擷取物件和報表 擷取物件和報表
回應 GoogleAdsRow 物件的串流 GoogleAdsRow 物件的頁面
回應的欄位 僅限查詢中指定的項目 僅限查詢中指定的項目
每日上限 根據存取層級設定每日限制 根據存取層級設定每日限制

雖然 Search 可以傳送多個分頁要求來下載整份報表,但 SearchStream 會傳送單一要求,並與 Google Ads API 建立持續連線,不受報表大小影響。

對於 SearchStream,資料封包會立即開始下載,並將整個結果快取到資料緩衝區。程式碼可以開始讀取緩衝資料,而無須等待整個串流完成。

SearchStream 可根據您的應用程式,消除要求 Search 回應的每個個別頁面所需的網路往返時間,因此比分頁提供更佳的效能,尤其是針對較大的報表。

範例

本例會查看包含 100,000 列的報表。下表列出這兩種方法之間的會計差異。

SearchStream 搜尋
頁面大小 不適用 每頁 10,000 列
API 要求數量 1 項要求 10 項要求
API 回應數量 1 個連續串流 10 則回覆

效能因素

就大多數用途而言,我們建議使用 SearchStream 而非 Search,原因如下:

  • 單頁報表 (10,000 列以下):兩種方法之間沒有明顯的效能差異。

  • 針對多頁報表:SearchStream 通常會更快,因為可避免多次來回,且從磁碟快取讀取或寫入的因素較少。

頻率限制

這兩種方法的每日限制都遵循開發人員憑證的標準限制和存取層級。無論結果是分頁或串流,單一查詢或報表都會計為一項作業。