AdError
Page Summary
This document lists possible error types for ads.
Errors can relate to formatting, content, dimensions, customer eligibility, or various invalid inputs like URLs or phone numbers.
Issues with ad customizers, templates, images, videos, and other assets are also covered.
Some errors are specific to certain ad types, campaigns, or geographic targeting.
Enum describing possible ad errors.
| Enums | |
|---|---|
| Invalid address |
| Address is incomplete |
| Two ad customizers may not be directly adjacent in an ad text. They must be separated by at least one character. |
| Ad customizers are not supported for ad type. |
| Estimating character sizes the string is too long. |
| Estimating character sizes the string is too short. |
| Error processing audio |
| There is a problem with the snippet. |
| Call tracking is not supported for specified country. |
| Final url and verification url cannot both be empty for call ads. |
| Call Ad verification url and final url don't have same domain. |
| Cannot disable call conversion and set conversion type id. |
| Cannot modify an ad. |
| Cannot set allowFlexibleColor false if no color is provided by user. |
| business name and url cannot be set at the same time |
| When user select native, no color control is allowed because we will always respect publisher color for native format serving. |
| The specified field is incompatible with this ad's type or settings. |
| Cannot set field when an existing ad id is set for sharing. |
| Cannot set field when originAdId is set. |
| Cannot set path2 without path1. |
| Cannot specify a url for the ad type |
| Cannot specify a tracking or mobile url without also setting final urls |
| Cannot specify a legacy url and a final url simultaneously |
| Cannot specify a urls in UrlData and in template fields simultaneously. |
| This operator cannot be used with a subclass of Ad. |
| Carrier specific short number is not allowed. |
| Consent for call recording is required for creating/updating call only ads. Seehttps://support.google.com/google-ads/answer/7412639. |
| Customer is not approved for mobile ads. |
| Customer is not approved for 3PAS richmedia ads. |
| Customer is not approved for 3PAS redirect richmedia (Ad Exchange) ads. |
| Not an eligible customer |
| Customer is not eligible for updating beacon url |
| Customizer type forbidden for this field. |
| Date time in the countdown tag is invalid. |
| Date time in the countdown tag is in the past. |
| There already exists an ad with the same dimensions in the union. |
| Ad's dimension must be set before setting union dimension. |
| Ad's dimension must be included in the union dimensions. |
| Specified phone number type is disallowed. |
| Display Url cannot be specified (applies to Ad Exchange Ads) |
| Telephone number contains invalid characters or invalid format. Re-enter your number using digits (0-9), dashes (-), and parentheses only. |
| Images must be unique between different carousel card assets. |
| Template element is mising |
| Emergency telephone numbers are not allowed. Enter a valid domestic phone number to connect customers to your business. |
| A required field was not specified or is an empty string. |
| The ad customizer field mapping for the feed attribute does not match the expected field type. |
| A feed attribute referenced in an ad customizer tag is not in the ad customizer mapping for the feed. |
| Template element field is not present |
| The use of ad customizer tags in the ad text is disallowed. Details in trigger. |
| Tags of the form {PH_x}, where x is a number, are disallowed in ad text. |
| Error occurred during image processing |
| The device preference is not compatible with the ad type |
| The associated ad is not compatible with restriction type. |
| The dimensions of the ad are specified or derived in multiple ways and are not consistent. |
| Expandable setting is inconsistent/wrong. For example, an AdX ad is invalid if it has a expandable vendor format but no expanding directions specified, or expanding directions is specified, but the vendor format is not expandable. |
| The status cannot differ among template ads of the same union. |
| The length of the string is not valid. |
| The ad is ineligible for upgrade. |
| User cannot create mobile ad for countries targeted in specified campaign. |
| The ad customizer tag is recognized, but the format is invalid. |
| Invalid Ad type. A specific type of Ad is required. |
| Headline, description or phone cannot be present when creating mobile image ad. |
| Image cannot be present when creating mobile text ad. |
| Invalid call conversion type id. |
| Invalid call to action text. |
| Invalid character in URL. |
| Creative's country code is not valid. |
| Customizer attribute name is invalid. |
| Invalid use of Expanded Dynamic Search Ads tags ({lpurl} etc.) |
| The text of this field did not match a pattern of allowed values. |
| Format is invalid |
| An input error whose real reason was not properly mapped (should not happen). |
| An invalid markup language was entered. |
| An invalid mobile carrier was entered. |
| Specified mobile carriers target a country not targeted by the campaign. |
| Wrong number of elements for given element type |
| The format of the telephone number is incorrect. Re-enter the number using the correct format. |
| The certified vendor format id is incorrect. |
| The template ad data contains validation errors. |
| The template field doesn't have have the correct type. |
| Invalid template id. |
| Display URL is incorrect for YouTube PYV ads |
| For video ads sequencing, YouTube video asset ID has to be defined incampaign.video_campaign_settings.video_ad_sequence.steps.asset_id. |
| After substituting replacement strings, the line is too wide. |
| Aspect ratios mismatch between different assets. |
| Missing address component in template element address field. |
| An ad name must be entered. |
| The feed referenced must have ad customizer mapping to be used in a customizer tag. |
| Business name must be entered. |
| Description (line 2) must be entered. |
| Description (line 3) must be entered. |
| The destination url must contain at least one tag (for example, {lpurl}) |
| A valid dimension must be specified for this ad. |
| A display URL must be entered. |
| Missing domain name in campaign setting when adding expanded dynamic search ad. |
| Headline must be entered. |
| A height must be entered. |
| An image must be entered. |
| Either an image or a media bundle is required in a display upload ad. |
| The tracking url template of ExpandedDynamicSearchAd must contain at least one tag. (for example, {lpurl}) |
| Marketing image or product videos are required. |
| The markup language in which your site is written must be entered. |
| A mobile carrier must be entered. |
| Phone number must be entered. |
| Missing required image aspect ratio. |
| Missing required template fields |
| Missing a required field value |
| The ad must have text. |
| A visible URL must be entered. |
| A width must be entered. |
| More than one type of countdown tag exists among all text lines. |
| Only 1 feed can be used as the source of ad customizer substitutions in a single ad. |
| TempAdUnionId must be use when adding template ads. |
| Customizer tags cannot be nested. |
| Phone number not supported for country. |
| Phone number not supported with call tracking enabled for country. |
| The default value of an ad placeholder can not be the empty string. |
| Ad placeholders with countdown functions must not have a default value. |
| A previous ad placeholder that had a default value was found which means that all (non-countdown) placeholders must have a default value. This ad placeholder does not have a default value. |
| Premium rate phone number is not allowed. |
| The display upload product type is not supported in this campaign. |
| App store value does not match the value of the app store in the app specified in the campaign. |
| The string has too many characters. |
| Too many ad customizers in one asset. |
| Too many product Images in GmailAd |
| Too many product Videos in GmailAd |
| The string has too few characters. |
| A previous ad placeholder that did not have a default value was found which means that no placeholders may have a default value. This ad placeholder does have a default value. |
| Ad union dimensions cannot change for saved ads. |
| The received error code is not known in this version. |
| Address component is not {country, lat, lng}. |
| Unknown unique field name |
| Unknown unique name (template element type specifier) |
| There exists unpaired brace in the ad customizer tag. |
| Cannot recognize the ad customizer tag. |
| Enum unspecified. |
| The ad customizer syntax used in the ad is not supported. |
| Unsupported ad dimension |
| The ad is not associated with any enabled AdGroupAd, and cannot be updated. |
| URL host name too long to be stored as visible URL (applies to Ad Exchange ads) |
| URL starts with an invalid scheme. |
| URL ends with an invalid top-level domain name. |
| URL contains illegal characters. |
| URL not equivalent during upgrade. |
| URL must contain a host name. |
| URL must start with a scheme. |
| URL should end in a valid domain extension, such as .com or .net. |
| URL must not end with a path. |
| URL must not specify a port. |
| URL must not contain a query. |
| A url scheme is not allowed in front of tag in tracking url template (for example,http://{lpurl}) |
| The user does not have permissions to create a template ad for the given template. |
| The value is not within the valid range |
| Vanity phone number is not allowed. |
| Error retrieving specified video |
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-12 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-12-12 UTC."],[],[]]