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 個廣告群組
服務： |
1 |
作業：SearchStream計數：45 個廣告活動
服務： |
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 錯誤。