Search Ads 360 Reporting API 會強制執行 API 作業限制，確保所有使用者都能獲得最佳的系統效能。
定價
Search Ads 360 的整體定價中已包含 Search Ads 360 Reporting API 的使用費。使用 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 錯誤。