Google Ads API 會強制執行 API 作業的限制，例如在單一 Variant 要求中傳送的作業數量。下表概略說明幾項需要注意的重要限制和配額。
| 要求類型、限制和錯誤代碼 | |||
|---|---|---|---|
| 分頁要求 | 每頁 10,000 列 |
INVALID_PAGE_SIZE
|
|
| 具備基本存取權的作業 | 每日 15,000 次 API 作業 |
RESOURCE_EXHAUSTED
|
|
| 異動要求 | 每項要求 10,000 次作業 |
TOO_MANY_MUTATE_OPERATIONS
|
|
| Planning 服務要求 | 每秒查詢 1 次 |
RESOURCE_EXHAUSTED
|
|
| 轉換上傳服務要求 | 每次要求 2,000 次轉換 |
TOO_MANY_CONVERSIONS_IN_REQUEST
|
|
| 帳單和帳戶預算服務要求 | 每個變更的請求有 1 個作業 |
TOO_MANY_MUTATE_OPERATIONS
|
|
每日 API 作業限制
每日 API 用量限制是以每個開發人員權杖執行的 API 作業數量而定。API 作業是取得要求和 Variant 作業的總和。每日 API 作業的限制取決於開發人員權杖的存取層級。存取層級和許可使用指南列出了各個存取層級的特定 API 操作限制。
違反這些限制的要求會遭到拒絕，並傳回下列錯誤訊息：RESOURCE_EXHAUSTED。
gRPC 限制
所有 Google Ads API 用戶端程式庫都使用 gRPC 產生要求和回應。根據預設，gRPC 的訊息大小為 4 MB，但我們的用戶端程式庫會將訊息大小上限設為 64 MB，藉此提高效率。
回應不得超過此上限。例如，包含許多欄位的搜尋要求可能會產生大小超過 64 MB 的回應。如要避免超過此限制，您可以減少所選欄位的數量、縮減頁面大小，或使用「串流」。如果是 異動，請針對每個要求傳送較少作業。
違反此限制的要求不會產生 GoogleAdsError，但會產生 429 Resource Exhausted gRPC 錯誤。請參閱 gRPC 錯誤代碼和訊息清單。
異動要求
除了可計入使用者每日作業配額外，每個要求的 nofollow 要求最多只能包含 10,000 個作業。
違反這項限制的要求會遭到拒絕，並傳回下列錯誤訊息：TOO_MANY_MUTATE_OPERATIONS。
下方列出了特定服務和要求類型的額外限制和注意事項。
搜尋要求
Search 或 SearchStream 要求計為使用者每日作業配額一次的作業。無論批次數量為何，一項 SearchStream 要求只會計為一項 API 作業。
分頁要求
分頁總數的要求 (例如包含有效 next_page_token 的要求) 不會計入使用者的每日作業配額。不過，包含過期或無效網頁憑證的分頁要求會產生例外狀況，並計入每日作業配額。
分頁後的要求 (例如搜尋要求) 也必須遵守 Page size cannot exceed 10,000 rows 的限制，如果違反此限制，就會遭到拒絕，並顯示以下錯誤訊息：INVALID_PAGE_SIZE。
如要進一步瞭解分頁，請參閱分頁結果分頁。
其他類型的要求
但如果是 Get、Mutate、Search 或 SearchStream 要求，則只會計為一次使用者每日作業配額一次作業。
這類要求包括：
BatchJobService.ListMutateJobResultsConversionUploadService.UploadCallConversionsConversionUploadService.UploadClickConversionsOfflineUserDataJobService.AddOfflineUserDataJobOperationsOfflineUserDataJobService.CreateOfflineUserDataJobUserDataService.UploadUserData
傳回 API 例外狀況的要求
使用 GoogleAdsFailure 拒絕的要求仍會計入使用者的每日作業配額。
失敗但未傳回 GoogleAdsFailure 的要求 (例如，在網路層級發生錯誤時) 不計入使用者的每日作業配額，因為這類要求一律無法存取服務。網路連線故障就是一個例子。
Planning 服務
下列的 Planning 服務方法可能會因成本和複雜性而受到其他類型的要求限制。
每個客戶 ID 或開發人員權杖僅限每秒 1 次要求：
KeywordPlanService.GetKeywordPlanKeywordPlanService.GenerateHistoricalMetricsKeywordPlanService.GenerateForecastMetrics
違反這些限制的要求會遭到拒絕，並傳回下列錯誤訊息：
RESOURCE_EXHAUSTED。1 QPS 的計算方式為每 60 秒 60 個要求。
建立關鍵字企劃書時，請注意這些限制。
| 關鍵字企劃書物件 | 數量上限 |
|---|---|
每個帳戶 KeywordPlan |
10,000 |
每個KeywordPlanKeywordPlanAdGroup |
200 |
每個KeywordPlanKeywordPlanAdGroupKeyword |
10,000 |
KeywordPlanCampaignKeyword (排除關鍵字) |
1,000 |
每個KeywordPlanKeywordPlanCampaign |
1 |
轉換上傳服務
每次要求僅限 2,000 次來電或點擊轉換：
違反這些限制的要求會遭到拒絕，並傳回下列錯誤訊息：
TOO_MANY_CONVERSIONS_IN_REQUEST。
轉換調整項上傳服務
每項請求最多只能有 2,000 次轉換調整項：
違反這些限制的要求會遭到拒絕，並傳回下列錯誤訊息：
TOO_MANY_ADJUSTMENTS_IN_REQUEST。
帳單和帳戶預算服務
只能針對採用月結的帳戶設定轉換。
違反這項限制的要求會遭到拒絕，並傳回下列錯誤訊息：
MUTATE_NOT_ALLOWED。只有更改 1 操作是更改的。
違反這項限制的要求會遭到拒絕，並傳回下列錯誤訊息：
TOO_MANY_MUTATE_OPERATIONS。預算委刊單變更後，您應該至少等待 12 小時，才能對同一個帳戶進行變更。在 12 個小時過後進行變更可能會導致無法恢復的故障情形，因此只能由您的 Google Ads 帳戶代表解決。
客戶帳戶的邀請
新使用者可透過 CustomerUserAccessService 邀請至現有的客戶帳戶。由於這項功能會傳送電子郵件給其他使用者，因此可能會濫用，因此對其行為設有限制：
同一個客戶帳戶無法收到多個待處理的邀請。如果後續要求傳送邀請函給已接受邀請的使用者，系統會傳回以下錯誤訊息：
ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION。客戶帳戶一次最多只能有 70 則待回應的邀請。 如果傳送的要求導致超過這個值，系統會傳回這項錯誤：
ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED。
使用者資料
使用者資料是透過 UserDataService 和 OfflineUserDataJobService 管理。在特定的建立/移除 UserData 作業中，每組 user_identifiers 都必須對單一使用者專用。
為了強制執行此規則，如果 UserData 組合中有超過 20 個 user_identifiers，就會傳回 OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS 或 UserDataError.TOO_MANY_USER_IDENTIFIERS 錯誤。
其他類型的限制
要求中包含太多項目 (例如作業清單) 的重複欄位可能會導致錯誤：REQUEST_SIZE_LIMIT_EXCEEDED。相同錯誤訊息也可能是其他問題所造成。
如果您遇到這項限制，且發出使用重複欄位的要求，請嘗試在 var 要求中部署作業清單，減少重複欄位中的項目數量。
執行 GAQL 查詢時，IN 子句中的項目數量上限為 20,000。如果您超過該上限，系統會傳回 FILTER_HAS_TOO_MANY_VALUES 錯誤。