System Limits

This page lists various limits in the Google Ads API along with the corresponding error that is thrown when the limit is exceeded. General product limits, such as the number of campaigns per account, is listed in the Google Ads Help Center.

Please note that UTF-8 encoding is used when calculating byte limits for string values.

Account

Maximum number of Google Ads accounts in a manager account hierarchy
Value Varies
Error ManagerLinkError.TOO_MANY_ACCOUNTS
Notes See About maximum account limits for manager accounts for more details.
Maximum number of test accounts in a manager account hierarchy
Value 50
Error ManagerLinkError.TOO_MANY_ACCOUNTS
Notes N/A
Maximum number of manager accounts a Google Ads account can be managed by
Value 5
Error ManagerLinkError.TOO_MANY_MANAGERS
Notes See About manager linking errors for more details.
Maximum number of levels in a hierarchy, from top-level manager account to bottom-most Google Ads account
Value 6
Error ManagerLinkError.MAX_DEPTH_EXCEEDED
Notes See About manager linking errors for more details.
Maximum number of pending manager account invitations in the same hierarchy
Value 20
Error ManagerLinkError.TOO_MANY_INVITES
Notes See About manager linking errors for more details.
Name length
Value 255 characters
Error StringLengthError.TOO_LONG
Notes N/A

Ads

Headline length
Value 30 characters
Error AdError.LINE_TOO_WIDE
Notes See About text ads for more details.
Description1 or description2 length
Value 90 characters
Error AdError.LINE_TOO_WIDE
Notes See above.
Path1 or path2 length
Value 15 characters
Error AdError.LINE_TOO_WIDE
Notes See above.
Final URL length
Value 2,084 bytes
Error StringLengthError.TOO_LONG
Notes A protocol prefix (such as "https://") is required for final URLs and is counted against this limit.

Ad group

Name length
Value 255 bytes
Error AdGroupError.INVALID_ADGROUP_NAME
Notes N/A

Campaign budget

Maximum number of shared budgets in an account
Value 11,000
Error ResourceCountLimitExceededError.ACCOUNT_LIMIT
Notes The budgets limit is 1,000 more than the number of campaigns limit to allow for some room in reassigning budgets if needed. There is no restriction on the number of campaigns that can share a budget.
Maximum number of unshared budgets in an account
Value 20,000
Error ResourceCountLimitExceededError.ACCOUNT_LIMIT
Notes These are budgets that are associated with a specific campaign, and cannot be shared between campaigns.

Campaign

Maximum number of bidding strategies attached to ad groups per campaign
Value 1,000
Error ResourceCountLimitExceededError.CAMPAIGN_LIMIT
Notes N/A
Name length
Value 128 bytes
Error StringLengthError.TOO_LONG
Notes N/A

Conversion upload

Maximum number of offline click conversions that can be uploaded per API call
Value 2,000
Error ConversionUploadError.TOO_MANY_CONVERSIONS_IN_REQUEST
Notes For performance reasons, we limit the number of conversions that can be uploaded per API request to 2,000.

Criterion

Keyword length
Value 80 characters
Error CriterionError.KEYWORD_TEXT_TOO_LONG
Notes N/A
Placement URL length
Value 250 characters
Error CriterionError.PLACEMENT_URL_IS_TOO_LONG
Notes Protocol prefixes (such as "http://") are stripped from placement URLs and are not counted towards this limit.
Final URL length
Value 2,047 bytes
Error StringLengthError.TOO_LONG
Notes The protocol prefix (such as "http://") is counted towards this limit.
Proximity radius
Value 800 km / 500 mi
Error CriterionError.INVALID_PROXIMITY_RADIUS
Notes N/A
Maximum number of Shopping ad groups in a single request that modifies the structure of the ProductPartition tree.
Value 2
Error AdGroupCriterionError.OPERATIONS_FOR_TOO_MANY_SHOPPING_ADGROUPS
Notes This limit does not apply to operations on ProductPartition criteria changes that do not modify the structure of the tree. For example, a request that only modifies the bids of existing partitions can contain operations for more than two Shopping ad groups.If you want to modify the structure of the ProductPartition tree for more than two Shopping ad groups, consider using batch jobs, where this restriction does not apply.
Excluded IP blocks per campaign
Value 500
Error ResourceCountLimitExceededError.CAMPAIGN_LIMIT
Notes N/A

Feed

Feeds per account
Value 100
Error ResourceCountLimitExceededError.ACCOUNT_LIMIT
Notes We recommend using only one feed per extension type whenever possible.
Feed items per account
Value 5,000,000
Error ResourceCountLimitExceededError.ACCOUNT_LIMIT
Notes N/A
Feed attributes per feed
Value 30
Error ResourceCountLimitExceededError.ACCOUNT_LIMIT
Notes N/A
Feed items per matching function
Value 20
Error ResourceCountLimitExceededError.ACCOUNT_LIMIT
Notes N/A

Label

Maximum number of labels that can be applied to accounts by a manager account
Value 200
Error ResourceCountLimitExceededError.ACCOUNT_LIMIT
Notes N/A
Maximum number of accounts a label can be applied to
Value 1,000
Error ResourceCountLimitExceededError.ACCOUNT_LIMIT
Notes N/A
Maximum number of labels that can be applied to entities (campaigns, ad groups, etc.) per account
Value 100,000
Error ResourceCountLimitExceededError.CAMPAIGN_LIMIT, ADGROUP_LIMIT, etc.
Notes Labels for all entity types count towards the same limit.
Maximum number of labels that can be applied to a single entity (campaign, ad group, etc.)
Value 50
Error ResourceCountLimitExceededError.CAMPAIGN_LIMIT, ADGROUP_LIMIT, etc.
Notes N/A

Payments account

Maximum number of billing setups that can be linked to a payments account
Value 75,000
Error BillingSetupError.PAYMENTS_ACCOUNT_INELIGIBLE
Notes N/A