Google Ads API 對 API 作業設有限制,例如作業次數 可透過單一 Mutate 請求傳送的顯示內容。下表摘要列出 需特別注意的一些重要限制和配額
要求類型、限制和錯誤代碼 | ||
---|---|---|
具備基本存取權的作業 | 每日 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 (應用程式介面) 作業是 get 請求和 mut 作業的總數。限制 每日 API 作業數視開發人員權杖的存取層級而定。 存取層級和許可使用指南概述 確保每個存取層級都有特定 API 作業限制
違反這些限制的要求會遭到拒絕,並顯示錯誤訊息:
RESOURCE_EXHAUSTED
。
gRPC 限制
所有 Google Ads API 用戶端程式庫都使用 gRPC,用於產生要求和回應。根據預設,gRPC 有 訊息大小上限為 4 MB,但我們的用戶端程式庫將訊息大小上限設為 64 MB 可提高效率。
回應數量不得超過這項限制。例如,如果搜尋要求 包含許多欄位,可能會產生超過 64 MB 的回應。目的地: 即可避免此上限;您可以減少所選欄位的數量,或使用 streaming。如果是 變動,請減少傳送的作業數量 每個要求。
違反這項限制的要求不會
GoogleAdsError
,但會產生
429 Resource Exhausted
gRPC 錯誤。請參閱 gRPC 錯誤代碼清單和
訊息。
更改要求
除了計入使用者的每日作業配額外,AML 檔案 每個要求最多只能包含 10,000 個作業。
違反這項限制的要求會遭到拒絕,並顯示以下錯誤:
TOO_MANY_MUTATE_OPERATIONS
。
特定服務和要求類型的其他限制和注意事項 接下來將介紹
搜尋要求
系統會將 Search
或 SearchStream
要求計為使用者的一次作業
每日作業配額系統會將一項 SearchStream
要求計為一次 API 作業
無論批次數量為何
分頁要求
已分頁的要求 (例如包含有效
next_page_token
) 不會計入使用者的每日作業配額。
但包含過期或無效網頁符記的分頁要求
來產生例外狀況,並會計入每日作業配額。
如要進一步瞭解分頁,請參閱分頁後的分頁 結果。
其他類型的要求
非 Get
、Mutate
、Search
或 SearchStream
要求
只會計為使用者每日作業配額中的一次作業。
以下列舉幾個這類要求:
BatchJobService.ListMutateJobResults
ConversionUploadService.UploadCallConversions
ConversionUploadService.UploadClickConversions
OfflineUserDataJobService.AddOfflineUserDataJobOperations
OfflineUserDataJobService.CreateOfflineUserDataJob
UserDataService.UploadUserData
傳回 API 例外狀況的要求
以含有
GoogleAdsFailure
仍會計入
執行使用者日常作業配額
如果要求失敗但未傳回
GoogleAdsFailure
,例如:
網路層級,不會計入使用者的每日作業配額
因為要求一律不會傳送至服務舉例來說
網路連線失敗。
規劃服務
下列 Planning 服務方法的成本和複雜性較高 符合與其他類型的要求不同
每個客戶 ID 每秒最多可要求 1 個要求:
KeywordPlanIdeaService.GenerateKeywordIdeas
KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
系統會拒絕違反這些限制的要求,並顯示以下錯誤訊息:
RESOURCE_EXHAUSTED
。1 QPS 是以每 60 秒 60 個要求來計算。
每個客戶 ID 每秒最多為 2 個要求:
建立關鍵字企劃書時,請留意這些限制。
關鍵字企劃書物件 | 數量上限 |
---|---|
每個帳戶 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
組合
專屬於單一使用者
為了強制執行這項限制
OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS
或
UserDataError.TOO_MANY_USER_IDENTIFIERS
如果單一查詢中有超過 20 個 user_identifiers
時,系統會傳回這個錯誤。
已設定UserData
。
其他限制類型
重複欄位 (例如運算清單) 中含有太多項目。
要求可能導致下列錯誤:
REQUEST_SIZE_LIMIT_EXCEEDED
。
出現這則錯誤訊息也可能是其他問題造成。
如果您達到這項限制,並發出使用 來嘗試部署 Transform 請求中的作業清單。
執行 GAQL 查詢時,項目數量上限
IN
子句中的 20,000 個值如果超過上限
FILTER_HAS_TOO_MANY_VALUES
敬上
錯誤。