Search Ads 360 Reporting API 會對 API 作業強制執行限制，確保所有使用者都能享有最佳系統效能。
定價
使用 Search Ads 360 Reporting API 的費用已計入 Search Ads 360 的整體價格。使用 API 不會產生額外費用。
查詢限制
以下限制適用於透過 Search 或 SearchStream 方法執行的查詢作業。
- 每位使用者每項專案每分鐘 3,000 次查詢
- 每項專案每分鐘 3,000 次查詢
- 每項專案每日 150,000 次查詢
每日 API 作業限制
每日 API 用量限制是根據每個 Google Cloud 專案的 API 作業數而定。
無論結果是透過 SearchAds360Service.SearchStream 串流傳輸，還是從 SearchAds360Service.Search 呼叫分頁，單一查詢或報表都會計為一次作業。瞭解詳情。
下表提供了幾個計算例子：
| API 要求 | 計入每日上限的作業 |
|---|---|
作業：Search
計數：53 個廣告群組 服務： SearchAds360Service
|
1 |
作業：SearchStream
計數：45 個廣告活動 服務： SearchAds360Service
|
1 |
如果要求違反這些限制，系統會拒絕要求並傳回以下錯誤：
RESOURCE_EXHAUSTED。
搜尋要求
Search 或 SearchStream 要求會計為一項作業，並計入使用者的每日作業配額。無論批次數量為何，一項 SearchStream 要求都會計為一項 API 作業。
gRPC 限制
所有 Search Ads 360 Reporting API 用戶端程式庫都會使用 gRPC 產生要求和回應。根據預設，gRPC 的訊息大小為 4 MB。
回覆不得超過這項限制。舉例來說，如果搜尋要求包含大量欄位，產生的回應大小可能會超過 4 MB。如要避免超出這個限制，可以減少選取的欄位數量、縮小網頁大小，或是使用串流。
違反這項限制的要求「不會」產生 SearchAds360Error，但會產生 429 Resource Exhausted gRPC 錯誤。請參閱 gRPC 錯誤代碼和訊息清單。
分頁要求
分頁要求 (例如包含有效 next_page_token 的要求) 不會計入使用者的每日作業配額。不過，如果分頁要求包含過期或無效的頁面符記，系統會產生例外狀況，並計入每日作業配額。
如果要求會分頁顯示 (例如搜尋要求)，也須遵守 Page size cannot exceed 10,000 rows 限制，如果違反這項限制，系統會拒絕要求並顯示以下錯誤：INVALID_PAGE_SIZE。
如要進一步瞭解分頁功能，請參閱「瀏覽結果」。
傳回 API 例外的要求
遭拒的要求 (錯誤代碼為 SearchAds360Failure) 仍會計入使用者的每日操作配額。
如果要求失敗但未傳回 SearchAds360Failure，例如網路層級發生錯誤，由於要求不會傳送至服務，因此不會計入使用者的每日作業配額。例如網路連線失敗。
其他限制類型
如果要求中的重複欄位 (例如作業清單) 項目過多，可能會導致錯誤：
REQUEST_SIZE_LIMIT_EXCEEDED。
其他問題也可能導致出現這則錯誤訊息。
進行 Search Ads 360 查詢語言查詢時，IN 子句中的項目數量上限為 20,000 個。如果超出限制，系統會傳回 FILTER_HAS_TOO_MANY_VALUES 錯誤。