API 限制與配額

Google Ads API 對 API 作業設有限制，例如作業次數 是否能透過單一 Mutation 請求送出下表摘要列出 需特別注意的重要限制和配額

要求類型、限制和錯誤代碼
分頁要求	每頁 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 作業是 get 請求和 mut 作業的總數。限制 每日 API 作業數視開發人員權杖的存取層級而定。 存取層級和許可使用指南概述 確保每個存取層級都有特定 API 作業限制

違反這些限制的要求會遭到拒絕，並顯示錯誤訊息： RESOURCE_EXHAUSTED.

gRPC 限制

所有 Google Ads API 用戶端程式庫都使用 gRPC，用於產生要求和回應。根據預設，gRPC 有 訊息大小上限為 4 MB，但我們的用戶端程式庫將訊息大小上限設為 64 MB 可提高效率。

回應數量不得超過這項限制。例如，如果搜尋要求 包含許多欄位，可能會產生超過 64 MB 的回應。目的地： 為了避免這個上限，您可以減少所選欄位的數量 大小或使用串流功能。如果是變更，請傳送較少 每個要求的作業數量。

違反這項限制的要求不會 GoogleAdsError，但會產生 429 Resource Exhausted gRPC 錯誤。請參閱 gRPC 錯誤代碼清單和 訊息。

更改要求

除了計入使用者的每日作業配額外，Ace 每個要求最多只能包含 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 個要求：

  • KeywordPlanIdeaService.GenerateKeywordIdeas
  • KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics
  • KeywordPlanIdeaService.GenerateKeywordForecastMetrics

  系統會拒絕違反這些限制的要求，並顯示以下錯誤訊息： RESOURCE_EXHAUSTED.

• 1 QPS 是以每 60 秒 60 個要求來計算。

• 每個客戶 ID 每秒最多為 2 個要求：

  • KeywordPlanIdeaService.GenerateAdGroupTheme

建立關鍵字企劃書時，請留意這些限制。

關鍵字企劃書物件	數量上限
每個帳戶 KeywordPlan	10,000
每 KeywordPlan KeywordPlanAdGroup	200
每 KeywordPlan KeywordPlanAdGroupKeyword	10,000
KeywordPlanCampaignKeyword (排除關鍵字)	1,000
每 KeywordPlan KeywordPlanCampaign	1

轉換上傳服務

• 每次請求僅限 2,000 次來電或點擊轉換：

  • ConversionUploadService.UploadCallConversions
  • ConversionUploadService.UploadClickConversions

  違反這些限制的要求會遭到拒絕，並顯示錯誤訊息： TOO_MANY_CONVERSIONS_IN_REQUEST.

轉換調整項上傳服務

• 每個要求最多為 2,000 次轉換調整項：

  • ConversionAdjustmentUploadService.UploadConversionAdjustments

  違反這些限制的要求會遭到拒絕，並顯示錯誤訊息： 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 錯誤。