Common Errors

This page lists common errors and provides tips on preventing and handling them. For a complete list of errors, please review the error references. For further support, visit our forum.

AdError

CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR

SummaryThis operator cannot be used with a subclass of Ad.
Common causesYou've tried to modify attributes other than status of the ad.
Recommended handling tipsN/A
Prevention tipsOnce an ad is created, it cannot be modified. If you would like to modify the ad, you must make a new ad and then remove the old one. The status of the ad is, however, modifiable via AdGroupAdService.MutateAdGroupAds

INVALID_INPUT

SummaryOne of the fields in an ad contains invalid characters.
Common causesUsing special characters in URLs
Recommended handling tipsN/A
Prevention tipsValidate URLs in your application before making a request to the API.

LINE_TOO_WIDE

SummaryOne of the lines in an ad was longer than the maximum allowed length. The length limits are documented in the AdWords Help Center.
Common causesIncorrectly specifying empty default text in an ad parameter tag. Use {param1}, not {param1:}.
Recommended handling tipsN/A
Prevention tipsValidate the length of the line before making the request.

AdGroupAdError

AD_GROUP_AD_LABEL_ALREADY_EXISTS

SummaryThis label is already associated with some of these ads.
Common causesYou’ve tried to associate the label with ads that already have them associated.
Recommended handling tipsN/A
Prevention tipsCheck first to see if the label to be added is already associated with the ads.

CANNOT_OPERATE_ON_REMOVED_ADGROUPAD

SummaryAn operation attempted to update a removed ad.
Common causesOnce an ad is removed, it can no longer be updated (including changes to its status).
Recommended handling tipsN/A
Prevention tipsEnsure that your code does not attempt to update removed ads.

AdGroupCriterionError

INVALID_KEYWORD_TEXT

SummaryThe keyword text contains invalid characters. A list of valid characters is available on the AdWords Help Center.
Common causesThe keyword text contains invalid characters.
Recommended handling tipsN/A
Prevention tipsValidate the keyword text in your application before making a request to the API.

AdGroupError

DUPLICATE_ADGROUP_NAME

SummaryAn ad group is being added or renamed, but the name is already being used by another ad group.
Common causesCreating a new ad group with the name of an existing active or paused ad group.
Recommended handling tipsLog the error and/or present an error message to the user, optionally suggesting a unique ad group name or showing the list of names in use.
Prevention tipsN/A

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID

SummaryClient customer ID is not a number.
Common causesYou've specified your client customer ID incorrectly.
Recommended handling tipsN/A
Prevention tips123-456-7890 should be 1234567890. See this page for details.

CLIENT_CUSTOMER_ID_IS_REQUIRED

SummaryClient customer ID was not specified in the HTTP header.
Common causesYou've not specified your client customer ID in the HTTP header.
Recommended handling tipsN/A
Prevention tipsClient customer ID is required for all cases except for when using CustomerService.GetCustomer. Therefore, make sure you've specified it in the HTTP header. Consider using our client libraries, as they handle this for you.

CUSTOMER_NOT_FOUND

SummaryNo account found for the customer ID provided in the header.
Common causesTrying to access an account that was just created before the account is established in the backend.
Recommended handling tipsWait an initial five minutes, then retry every 30 seconds.
Prevention tipsWait a few minutes after the account is created before issuing requests against it.
SummaryThe access token in the request header is either invalid or has expired.
Common causesThe access token has been invalidated.
Recommended handling tipsRequest a new token following these guidelines. If you're using one of our client libraries, consult its documentation on how to refresh the token.
Prevention tipsStore and reuse access tokens until they expire.

NOT_ADS_USER

SummaryThe login used to generate the access token is not associated with any AdWords account.
Common causesThe login information provided corresponds to a Google account that does not have AdWords enabled.
Recommended handling tipsMake sure to log in with a valid AdWords account (typically your manager account) for the OAuth flow.
Prevention tipsN/A

OAUTH_TOKEN_INVALID

SummaryOAuth access token in the header is not valid.
Common causesYour access token passed with the HTTP header was not correct.
Recommended handling tipsN/A
Prevention tipsMake sure you've passed the correct access token associated with your account. It's sometimes confused with refresh tokens and authorization codes. If you would like to get a credential that can access all client accounts under a manager account, make sure you get the refresh token for the manager account. Review our guide for details about access token and refresh token. For more details, see the OAuth2 Authentication guide.

BiddingError

BID_TOO_MANY_FRACTIONAL_DIGITS

SummaryThe bid value is not an exact multiple of the minimum unit of the account's currency. For example, US$0.015 (15000 in micros) is not a valid bid.
Common causesN/A
Recommended handling tipsN/A
Prevention tipsVerify that bids are multiples of the minimum unit for the account's currency.

BID_TOO_BIG

SummaryThe error is returned even though the bid is within the campaign budget.
Common causesN/A
Recommended handling tipsN/A
Prevention tipsCheck if the account is participating in Google Grants for AdWords. If so, restrict CPC bids to the maximum prescribed by the program.

CampaignBudgetError

MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC

SummaryThe budget amount is too small.
Common causesN/A
Recommended handling tipsN/A
Prevention tipsVerify that budget amount is greater than or equal to the minimum unit for the account's currency.

NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT

SummaryThe budget amount will have too many significant decimal places when converted from a micro amount to an amount in the account's currency.
Common causesN/A
Recommended handling tipsN/A
Prevention tipsVerify that budget amount is divisible by the minimum unit for the account's currency.

CampaignError

DUPLICATE_CAMPAIGN_NAME

SummaryA campaign is being added or renamed, but the name is already being used by another campaign.
Common causesCreating a new campaign with the name of an existing active or paused campaign.
Recommended handling tipsLog the error and/or present an error message to the user, optionally suggesting a unique campaign name or showing the list of names in use.
Prevention tipsN/A

CriterionError

KEYWORD_HAS_INVALID_CHARS

SummaryAdding / editing keywords that contain invalid characters.
Common causesUse special characters like ! @ % * in the keywords.
Recommended handling tipsN/A
Prevention tipsMake sure you don’t use any unallowed characters in the keywords. See the Add keywords Help Center article for more information.

DistinctError

DUPLICATE_ELEMENT

SummaryThe request contains two parameters that are identical and redundant.
Common causesN/A
Recommended handling tipsN/A
Prevention tipsRemove duplicates (operations, parameters, list elements) before making the request. Look for fields that have the DistinctElements constraint.

InternalApiError

NTERNAL_ERROR

SummarySomething unexpected happened while processing the request.
Common causesThe API isn't functioning correctly due to a bug.
Recommended handling tipsWait for about 30 seconds, then retry the request. If this error occurs frequently, post the details to the forum for further troubleshooting.
Prevention tipsN/A

NotEmptyError

EMPTY_LIST

SummaryA required list is empty.
Common causesPassing in an empty list of operations to a mutate method.
Recommended handling tipsN/A
Prevention tipsN/A

QuotaCheckError

RESOURCE_EXHAUSTED

SummaryA system frequency limit has been exceeded.
Common causesSending too many requests in a short period of time.
Recommended handling tipsN/A
Prevention tipsSet up short delays between requests or combine more operations in fewer requests.

RangeError

TOO_LOW

SummaryA value was lower than the minimum allowed.
Common causesForgetting to specify an ID, which results in a value of 0 being passed in.
Recommended handling tipsN/A
Prevention tipsNote any range limitations documented in the API reference.

RequestError

INVALID_INPUT

SummaryThe request is malformed.
Common causesThe URL is malformed or the contents of the request are malformed.
Recommended handling tipsN/A
Prevention tipsN/A

RequiredError

REQUIRED_FIELD_MISSING

SummaryThe request is missing required information.
Common causesMissing required fields when attempting to add an entity.
Recommended handling tipsLog the error and/or present an error message to the user. The fieldPath attribute of the error indicates which field is missing.
Prevention tipsRead the API reference to find out which fields are required.

Send feedback about...

Google Ads API Beta
Google Ads API Beta
Need help? Visit our support page.