Google Ads API 對 API 作業設有限制,例如在單一變動要求中可傳送的作業數量。下表摘要說明您必須注意的一些重要限制和配額。
要求類型、限制和錯誤代碼 | |||
---|---|---|---|
分頁要求 | 每頁 10,000 列 |
INVALID_PAGE_SIZE
|
|
具備基本存取權的作業 | 每日 15,000 次 API 作業 |
RESOURCE_EXHAUSTED
|
|
更改要求 | 每個要求 10,000 個作業 |
TOO_MANY_MUTATE_OPERATIONS
|
|
Planning 服務要求 | 1 QPS |
RESOURCE_EXHAUSTED
|
|
轉換上傳服務要求 | 每個要求 2,000 次轉換 |
TOO_MANY_CONVERSIONS_IN_REQUEST
|
|
帳單與帳戶預算服務要求 | 每個 變更 要求 1 項作業 |
TOO_MANY_MUTATE_OPERATIONS
|
每日 API 作業限制
每日 API 用量限制取決於每個開發人員權杖產生的 API 作業數量。API 作業是 get 要求和 mut 作業的總數。每日 API 作業限制取決於開發人員權杖的存取層級。存取層級和許可使用指南概略說明各存取層級的特定 API 作業限制。
違反這些限制的要求會遭到拒絕,並顯示以下錯誤:RESOURCE_EXHAUSTED
。
gRPC 限制
所有的 Google Ads API 用戶端程式庫都使用 gRPC 產生請求和回應。gRPC 的預設訊息大小為 4 MB,但為了提高效率,我們的用戶端程式庫會將訊息大小上限設為 64 MB。
回應數量不得超過這項限制。例如,包含許多欄位的搜尋要求可能會產生超過 64 MB 的回應。如要避免超出上限,請減少所選欄位的數量、縮減頁面大小,或使用串流功能。如果是 muts,每次請求傳送的作業較少。
違反這項限制的要求不會產生 GoogleAdsError
,但會產生 429 Resource Exhausted
gRPC 錯誤。請參閱 gRPC 錯誤代碼和訊息清單。
更改要求
除了計入使用者的每日作業配額外,變更要求每次請求最多只能包含 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.ListMutateJobResults
ConversionUploadService.UploadCallConversions
ConversionUploadService.UploadClickConversions
OfflineUserDataJobService.AddOfflineUserDataJobOperations
OfflineUserDataJobService.CreateOfflineUserDataJob
UserDataService.UploadUserData
傳回 API 例外狀況的要求
但透過 GoogleAdsFailure
遭到拒絕的要求仍會計入使用者的每日作業配額。
如果要求失敗但未傳回 GoogleAdsFailure
(例如網路層級的錯誤),則由於這類要求永遠不會觸及服務,因此不會計入使用者的每日作業配額。例如網路連線失敗的情況。
規劃服務
由於成本與複雜性,下列 Planning 服務方法必須與其他類型的要求分開。
每個客戶 ID 或開發人員權杖每秒最多只能發出 1 個要求:
KeywordPlanService.GetKeywordPlan
KeywordPlanService.GenerateHistoricalMetrics
KeywordPlanService.GenerateForecastMetrics
違反這些限制的要求會遭到拒絕,並顯示以下錯誤:
RESOURCE_EXHAUSTED
。1 QPS 是以每 60 秒 60 個要求來計算。
建立關鍵字企劃書時,請留意這些限制。
關鍵字企劃書物件 | 數量上限 |
---|---|
每個帳戶 KeywordPlan |
10,000 |
每 KeywordPlan KeywordPlanAdGroup |
200 |
每 KeywordPlan KeywordPlanAdGroupKeyword |
10,000 |
KeywordPlanCampaignKeyword (排除關鍵字) |
1,000 |
每 KeywordPlan KeywordPlanCampaign |
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
集內的 user_identifiers
超過 20 個 user_identifiers
,系統會傳回 OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS
或 UserDataError.TOO_MANY_USER_IDENTIFIERS
錯誤。
其他限制類型
如果要求中的重複欄位 (例如作業清單) 含有太多項目,可能會導致錯誤:REQUEST_SIZE_LIMIT_EXCEEDED
。出現這則錯誤訊息也可能是其他問題造成。
如果您遇到這項限制,且提出使用重複欄位的要求,請在 變動要求中部署作業清單,藉此減少重複欄位中的項目數量。
執行 GAQL 查詢時,IN
子句中的項目數量上限為 20,000 個。如果超出此上限,系統會傳回 FILTER_HAS_TOO_MANY_VALUES
錯誤。