ad_error.proto 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528
  1. // Copyright 2022 Google LLC
  2. //
  3. // Licensed under the Apache License, Version 2.0 (the "License");
  4. // you may not use this file except in compliance with the License.
  5. // You may obtain a copy of the License at
  6. //
  7. // http://www.apache.org/licenses/LICENSE-2.0
  8. //
  9. // Unless required by applicable law or agreed to in writing, software
  10. // distributed under the License is distributed on an "AS IS" BASIS,
  11. // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12. // See the License for the specific language governing permissions and
  13. // limitations under the License.
  14. syntax = "proto3";
  15. package google.ads.googleads.v12.errors;
  16. option csharp_namespace = "Google.Ads.GoogleAds.V12.Errors";
  17. option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v12/errors;errors";
  18. option java_multiple_files = true;
  19. option java_outer_classname = "AdErrorProto";
  20. option java_package = "com.google.ads.googleads.v12.errors";
  21. option objc_class_prefix = "GAA";
  22. option php_namespace = "Google\\Ads\\GoogleAds\\V12\\Errors";
  23. option ruby_package = "Google::Ads::GoogleAds::V12::Errors";
  24. // Proto file describing ad errors.
  25. // Container for enum describing possible ad errors.
  26. message AdErrorEnum {
  27. // Enum describing possible ad errors.
  28. enum AdError {
  29. // Enum unspecified.
  30. UNSPECIFIED = 0;
  31. // The received error code is not known in this version.
  32. UNKNOWN = 1;
  33. // Ad customizers are not supported for ad type.
  34. AD_CUSTOMIZERS_NOT_SUPPORTED_FOR_AD_TYPE = 2;
  35. // Estimating character sizes the string is too long.
  36. APPROXIMATELY_TOO_LONG = 3;
  37. // Estimating character sizes the string is too short.
  38. APPROXIMATELY_TOO_SHORT = 4;
  39. // There is a problem with the snippet.
  40. BAD_SNIPPET = 5;
  41. // Cannot modify an ad.
  42. CANNOT_MODIFY_AD = 6;
  43. // business name and url cannot be set at the same time
  44. CANNOT_SET_BUSINESS_NAME_IF_URL_SET = 7;
  45. // The specified field is incompatible with this ad's type or settings.
  46. CANNOT_SET_FIELD = 8;
  47. // Cannot set field when originAdId is set.
  48. CANNOT_SET_FIELD_WITH_ORIGIN_AD_ID_SET = 9;
  49. // Cannot set field when an existing ad id is set for sharing.
  50. CANNOT_SET_FIELD_WITH_AD_ID_SET_FOR_SHARING = 10;
  51. // Cannot set allowFlexibleColor false if no color is provided by user.
  52. CANNOT_SET_ALLOW_FLEXIBLE_COLOR_FALSE = 11;
  53. // When user select native, no color control is allowed because we will
  54. // always respect publisher color for native format serving.
  55. CANNOT_SET_COLOR_CONTROL_WHEN_NATIVE_FORMAT_SETTING = 12;
  56. // Cannot specify a url for the ad type
  57. CANNOT_SET_URL = 13;
  58. // Cannot specify a tracking or mobile url without also setting final urls
  59. CANNOT_SET_WITHOUT_FINAL_URLS = 14;
  60. // Cannot specify a legacy url and a final url simultaneously
  61. CANNOT_SET_WITH_FINAL_URLS = 15;
  62. // Cannot specify a urls in UrlData and in template fields simultaneously.
  63. CANNOT_SET_WITH_URL_DATA = 17;
  64. // This operator cannot be used with a subclass of Ad.
  65. CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR = 18;
  66. // Customer is not approved for mobile ads.
  67. CUSTOMER_NOT_APPROVED_MOBILEADS = 19;
  68. // Customer is not approved for 3PAS richmedia ads.
  69. CUSTOMER_NOT_APPROVED_THIRDPARTY_ADS = 20;
  70. // Customer is not approved for 3PAS redirect richmedia (Ad Exchange) ads.
  71. CUSTOMER_NOT_APPROVED_THIRDPARTY_REDIRECT_ADS = 21;
  72. // Not an eligible customer
  73. CUSTOMER_NOT_ELIGIBLE = 22;
  74. // Customer is not eligible for updating beacon url
  75. CUSTOMER_NOT_ELIGIBLE_FOR_UPDATING_BEACON_URL = 23;
  76. // There already exists an ad with the same dimensions in the union.
  77. DIMENSION_ALREADY_IN_UNION = 24;
  78. // Ad's dimension must be set before setting union dimension.
  79. DIMENSION_MUST_BE_SET = 25;
  80. // Ad's dimension must be included in the union dimensions.
  81. DIMENSION_NOT_IN_UNION = 26;
  82. // Display Url cannot be specified (applies to Ad Exchange Ads)
  83. DISPLAY_URL_CANNOT_BE_SPECIFIED = 27;
  84. // Telephone number contains invalid characters or invalid format.
  85. // Re-enter your number using digits (0-9), dashes (-), and parentheses
  86. // only.
  87. DOMESTIC_PHONE_NUMBER_FORMAT = 28;
  88. // Emergency telephone numbers are not allowed. Enter a valid
  89. // domestic phone number to connect customers to your business.
  90. EMERGENCY_PHONE_NUMBER = 29;
  91. // A required field was not specified or is an empty string.
  92. EMPTY_FIELD = 30;
  93. // A feed attribute referenced in an ad customizer tag is not in the ad
  94. // customizer mapping for the feed.
  95. FEED_ATTRIBUTE_MUST_HAVE_MAPPING_FOR_TYPE_ID = 31;
  96. // The ad customizer field mapping for the feed attribute does not match the
  97. // expected field type.
  98. FEED_ATTRIBUTE_MAPPING_TYPE_MISMATCH = 32;
  99. // The use of ad customizer tags in the ad text is disallowed. Details in
  100. // trigger.
  101. ILLEGAL_AD_CUSTOMIZER_TAG_USE = 33;
  102. // Tags of the form {PH_x}, where x is a number, are disallowed in ad text.
  103. ILLEGAL_TAG_USE = 34;
  104. // The dimensions of the ad are specified or derived in multiple ways and
  105. // are not consistent.
  106. INCONSISTENT_DIMENSIONS = 35;
  107. // The status cannot differ among template ads of the same union.
  108. INCONSISTENT_STATUS_IN_TEMPLATE_UNION = 36;
  109. // The length of the string is not valid.
  110. INCORRECT_LENGTH = 37;
  111. // The ad is ineligible for upgrade.
  112. INELIGIBLE_FOR_UPGRADE = 38;
  113. // User cannot create mobile ad for countries targeted in specified
  114. // campaign.
  115. INVALID_AD_ADDRESS_CAMPAIGN_TARGET = 39;
  116. // Invalid Ad type. A specific type of Ad is required.
  117. INVALID_AD_TYPE = 40;
  118. // Headline, description or phone cannot be present when creating mobile
  119. // image ad.
  120. INVALID_ATTRIBUTES_FOR_MOBILE_IMAGE = 41;
  121. // Image cannot be present when creating mobile text ad.
  122. INVALID_ATTRIBUTES_FOR_MOBILE_TEXT = 42;
  123. // Invalid call to action text.
  124. INVALID_CALL_TO_ACTION_TEXT = 43;
  125. // Invalid character in URL.
  126. INVALID_CHARACTER_FOR_URL = 44;
  127. // Creative's country code is not valid.
  128. INVALID_COUNTRY_CODE = 45;
  129. // Invalid use of Expanded Dynamic Search Ads tags ({lpurl} etc.)
  130. INVALID_EXPANDED_DYNAMIC_SEARCH_AD_TAG = 47;
  131. // An input error whose real reason was not properly mapped (should not
  132. // happen).
  133. INVALID_INPUT = 48;
  134. // An invalid markup language was entered.
  135. INVALID_MARKUP_LANGUAGE = 49;
  136. // An invalid mobile carrier was entered.
  137. INVALID_MOBILE_CARRIER = 50;
  138. // Specified mobile carriers target a country not targeted by the campaign.
  139. INVALID_MOBILE_CARRIER_TARGET = 51;
  140. // Wrong number of elements for given element type
  141. INVALID_NUMBER_OF_ELEMENTS = 52;
  142. // The format of the telephone number is incorrect. Re-enter the
  143. // number using the correct format.
  144. INVALID_PHONE_NUMBER_FORMAT = 53;
  145. // The certified vendor format id is incorrect.
  146. INVALID_RICH_MEDIA_CERTIFIED_VENDOR_FORMAT_ID = 54;
  147. // The template ad data contains validation errors.
  148. INVALID_TEMPLATE_DATA = 55;
  149. // The template field doesn't have have the correct type.
  150. INVALID_TEMPLATE_ELEMENT_FIELD_TYPE = 56;
  151. // Invalid template id.
  152. INVALID_TEMPLATE_ID = 57;
  153. // After substituting replacement strings, the line is too wide.
  154. LINE_TOO_WIDE = 58;
  155. // The feed referenced must have ad customizer mapping to be used in a
  156. // customizer tag.
  157. MISSING_AD_CUSTOMIZER_MAPPING = 59;
  158. // Missing address component in template element address field.
  159. MISSING_ADDRESS_COMPONENT = 60;
  160. // An ad name must be entered.
  161. MISSING_ADVERTISEMENT_NAME = 61;
  162. // Business name must be entered.
  163. MISSING_BUSINESS_NAME = 62;
  164. // Description (line 2) must be entered.
  165. MISSING_DESCRIPTION1 = 63;
  166. // Description (line 3) must be entered.
  167. MISSING_DESCRIPTION2 = 64;
  168. // The destination url must contain at least one tag (for example, {lpurl})
  169. MISSING_DESTINATION_URL_TAG = 65;
  170. // The tracking url template of ExpandedDynamicSearchAd must contain at
  171. // least one tag. (for example, {lpurl})
  172. MISSING_LANDING_PAGE_URL_TAG = 66;
  173. // A valid dimension must be specified for this ad.
  174. MISSING_DIMENSION = 67;
  175. // A display URL must be entered.
  176. MISSING_DISPLAY_URL = 68;
  177. // Headline must be entered.
  178. MISSING_HEADLINE = 69;
  179. // A height must be entered.
  180. MISSING_HEIGHT = 70;
  181. // An image must be entered.
  182. MISSING_IMAGE = 71;
  183. // Marketing image or product videos are required.
  184. MISSING_MARKETING_IMAGE_OR_PRODUCT_VIDEOS = 72;
  185. // The markup language in which your site is written must be entered.
  186. MISSING_MARKUP_LANGUAGES = 73;
  187. // A mobile carrier must be entered.
  188. MISSING_MOBILE_CARRIER = 74;
  189. // Phone number must be entered.
  190. MISSING_PHONE = 75;
  191. // Missing required template fields
  192. MISSING_REQUIRED_TEMPLATE_FIELDS = 76;
  193. // Missing a required field value
  194. MISSING_TEMPLATE_FIELD_VALUE = 77;
  195. // The ad must have text.
  196. MISSING_TEXT = 78;
  197. // A visible URL must be entered.
  198. MISSING_VISIBLE_URL = 79;
  199. // A width must be entered.
  200. MISSING_WIDTH = 80;
  201. // Only 1 feed can be used as the source of ad customizer substitutions in a
  202. // single ad.
  203. MULTIPLE_DISTINCT_FEEDS_UNSUPPORTED = 81;
  204. // TempAdUnionId must be use when adding template ads.
  205. MUST_USE_TEMP_AD_UNION_ID_ON_ADD = 82;
  206. // The string has too many characters.
  207. TOO_LONG = 83;
  208. // The string has too few characters.
  209. TOO_SHORT = 84;
  210. // Ad union dimensions cannot change for saved ads.
  211. UNION_DIMENSIONS_CANNOT_CHANGE = 85;
  212. // Address component is not {country, lat, lng}.
  213. UNKNOWN_ADDRESS_COMPONENT = 86;
  214. // Unknown unique field name
  215. UNKNOWN_FIELD_NAME = 87;
  216. // Unknown unique name (template element type specifier)
  217. UNKNOWN_UNIQUE_NAME = 88;
  218. // Unsupported ad dimension
  219. UNSUPPORTED_DIMENSIONS = 89;
  220. // URL starts with an invalid scheme.
  221. URL_INVALID_SCHEME = 90;
  222. // URL ends with an invalid top-level domain name.
  223. URL_INVALID_TOP_LEVEL_DOMAIN = 91;
  224. // URL contains illegal characters.
  225. URL_MALFORMED = 92;
  226. // URL must contain a host name.
  227. URL_NO_HOST = 93;
  228. // URL not equivalent during upgrade.
  229. URL_NOT_EQUIVALENT = 94;
  230. // URL host name too long to be stored as visible URL (applies to Ad
  231. // Exchange ads)
  232. URL_HOST_NAME_TOO_LONG = 95;
  233. // URL must start with a scheme.
  234. URL_NO_SCHEME = 96;
  235. // URL should end in a valid domain extension, such as .com or .net.
  236. URL_NO_TOP_LEVEL_DOMAIN = 97;
  237. // URL must not end with a path.
  238. URL_PATH_NOT_ALLOWED = 98;
  239. // URL must not specify a port.
  240. URL_PORT_NOT_ALLOWED = 99;
  241. // URL must not contain a query.
  242. URL_QUERY_NOT_ALLOWED = 100;
  243. // A url scheme is not allowed in front of tag in tracking url template
  244. // (for example, http://{lpurl})
  245. URL_SCHEME_BEFORE_EXPANDED_DYNAMIC_SEARCH_AD_TAG = 102;
  246. // The user does not have permissions to create a template ad for the given
  247. // template.
  248. USER_DOES_NOT_HAVE_ACCESS_TO_TEMPLATE = 103;
  249. // Expandable setting is inconsistent/wrong. For example, an AdX ad is
  250. // invalid if it has a expandable vendor format but no expanding directions
  251. // specified, or expanding directions is specified, but the vendor format is
  252. // not expandable.
  253. INCONSISTENT_EXPANDABLE_SETTINGS = 104;
  254. // Format is invalid
  255. INVALID_FORMAT = 105;
  256. // The text of this field did not match a pattern of allowed values.
  257. INVALID_FIELD_TEXT = 106;
  258. // Template element is mising
  259. ELEMENT_NOT_PRESENT = 107;
  260. // Error occurred during image processing
  261. IMAGE_ERROR = 108;
  262. // The value is not within the valid range
  263. VALUE_NOT_IN_RANGE = 109;
  264. // Template element field is not present
  265. FIELD_NOT_PRESENT = 110;
  266. // Address is incomplete
  267. ADDRESS_NOT_COMPLETE = 111;
  268. // Invalid address
  269. ADDRESS_INVALID = 112;
  270. // Error retrieving specified video
  271. VIDEO_RETRIEVAL_ERROR = 113;
  272. // Error processing audio
  273. AUDIO_ERROR = 114;
  274. // Display URL is incorrect for YouTube PYV ads
  275. INVALID_YOUTUBE_DISPLAY_URL = 115;
  276. // Too many product Images in GmailAd
  277. TOO_MANY_PRODUCT_IMAGES = 116;
  278. // Too many product Videos in GmailAd
  279. TOO_MANY_PRODUCT_VIDEOS = 117;
  280. // The device preference is not compatible with the ad type
  281. INCOMPATIBLE_AD_TYPE_AND_DEVICE_PREFERENCE = 118;
  282. // Call tracking is not supported for specified country.
  283. CALLTRACKING_NOT_SUPPORTED_FOR_COUNTRY = 119;
  284. // Carrier specific short number is not allowed.
  285. CARRIER_SPECIFIC_SHORT_NUMBER_NOT_ALLOWED = 120;
  286. // Specified phone number type is disallowed.
  287. DISALLOWED_NUMBER_TYPE = 121;
  288. // Phone number not supported for country.
  289. PHONE_NUMBER_NOT_SUPPORTED_FOR_COUNTRY = 122;
  290. // Phone number not supported with call tracking enabled for country.
  291. PHONE_NUMBER_NOT_SUPPORTED_WITH_CALLTRACKING_FOR_COUNTRY = 123;
  292. // Premium rate phone number is not allowed.
  293. PREMIUM_RATE_NUMBER_NOT_ALLOWED = 124;
  294. // Vanity phone number is not allowed.
  295. VANITY_PHONE_NUMBER_NOT_ALLOWED = 125;
  296. // Invalid call conversion type id.
  297. INVALID_CALL_CONVERSION_TYPE_ID = 126;
  298. // Cannot disable call conversion and set conversion type id.
  299. CANNOT_DISABLE_CALL_CONVERSION_AND_SET_CONVERSION_TYPE_ID = 127;
  300. // Cannot set path2 without path1.
  301. CANNOT_SET_PATH2_WITHOUT_PATH1 = 128;
  302. // Missing domain name in campaign setting when adding expanded dynamic
  303. // search ad.
  304. MISSING_DYNAMIC_SEARCH_ADS_SETTING_DOMAIN_NAME = 129;
  305. // The associated ad is not compatible with restriction type.
  306. INCOMPATIBLE_WITH_RESTRICTION_TYPE = 130;
  307. // Consent for call recording is required for creating/updating call only
  308. // ads. See https://support.google.com/google-ads/answer/7412639.
  309. CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED = 131;
  310. // Either an image or a media bundle is required in a display upload ad.
  311. MISSING_IMAGE_OR_MEDIA_BUNDLE = 132;
  312. // The display upload product type is not supported in this campaign.
  313. PRODUCT_TYPE_NOT_SUPPORTED_IN_THIS_CAMPAIGN = 133;
  314. // The default value of an ad placeholder can not be the empty string.
  315. PLACEHOLDER_CANNOT_HAVE_EMPTY_DEFAULT_VALUE = 134;
  316. // Ad placeholders with countdown functions must not have a default value.
  317. PLACEHOLDER_COUNTDOWN_FUNCTION_CANNOT_HAVE_DEFAULT_VALUE = 135;
  318. // A previous ad placeholder that had a default value was found which means
  319. // that all (non-countdown) placeholders must have a default value. This
  320. // ad placeholder does not have a default value.
  321. PLACEHOLDER_DEFAULT_VALUE_MISSING = 136;
  322. // A previous ad placeholder that did not have a default value was found
  323. // which means that no placeholders may have a default value. This
  324. // ad placeholder does have a default value.
  325. UNEXPECTED_PLACEHOLDER_DEFAULT_VALUE = 137;
  326. // Two ad customizers may not be directly adjacent in an ad text. They must
  327. // be separated by at least one character.
  328. AD_CUSTOMIZERS_MAY_NOT_BE_ADJACENT = 138;
  329. // The ad is not associated with any enabled AdGroupAd, and cannot be
  330. // updated.
  331. UPDATING_AD_WITH_NO_ENABLED_ASSOCIATION = 139;
  332. // Call Ad verification url and final url don't have same domain.
  333. CALL_AD_VERIFICATION_URL_FINAL_URL_DOES_NOT_HAVE_SAME_DOMAIN = 140;
  334. // Final url and verification url cannot both be empty for call ads.
  335. CALL_AD_FINAL_URL_AND_VERIFICATION_URL_CANNOT_BOTH_BE_EMPTY = 154;
  336. // Too many ad customizers in one asset.
  337. TOO_MANY_AD_CUSTOMIZERS = 141;
  338. // The ad customizer tag is recognized, but the format is invalid.
  339. INVALID_AD_CUSTOMIZER_FORMAT = 142;
  340. // Customizer tags cannot be nested.
  341. NESTED_AD_CUSTOMIZER_SYNTAX = 143;
  342. // The ad customizer syntax used in the ad is not supported.
  343. UNSUPPORTED_AD_CUSTOMIZER_SYNTAX = 144;
  344. // There exists unpaired brace in the ad customizer tag.
  345. UNPAIRED_BRACE_IN_AD_CUSTOMIZER_TAG = 145;
  346. // More than one type of countdown tag exists among all text lines.
  347. MORE_THAN_ONE_COUNTDOWN_TAG_TYPE_EXISTS = 146;
  348. // Date time in the countdown tag is invalid.
  349. DATE_TIME_IN_COUNTDOWN_TAG_IS_INVALID = 147;
  350. // Date time in the countdown tag is in the past.
  351. DATE_TIME_IN_COUNTDOWN_TAG_IS_PAST = 148;
  352. // Cannot recognize the ad customizer tag.
  353. UNRECOGNIZED_AD_CUSTOMIZER_TAG_FOUND = 149;
  354. // Customizer type forbidden for this field.
  355. CUSTOMIZER_TYPE_FORBIDDEN_FOR_FIELD = 150;
  356. // Customizer attribute name is invalid.
  357. INVALID_CUSTOMIZER_ATTRIBUTE_NAME = 151;
  358. // App store value does not match the value of the app store in the app
  359. // specified in the campaign.
  360. STORE_MISMATCH = 152;
  361. // Missing required image aspect ratio.
  362. MISSING_REQUIRED_IMAGE_ASPECT_RATIO = 153;
  363. // Aspect ratios mismatch between different assets.
  364. MISMATCHED_ASPECT_RATIOS = 155;
  365. // Images must be unique between different carousel card assets.
  366. DUPLICATE_IMAGE_ACROSS_CAROUSEL_CARDS = 156;
  367. }
  368. }