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 錯誤。