CommerceAd (AdWords API Developer's Guide)

CommerceAd

Data associated with a commerce ad. This data is used by AdService.

CommerceAd Available in Sandbox Only
This feature currently functions only in the sandbox, not the live web services. Using it in the live web services will throw exceptions.

Fields

description1
description2
headline
postPriceAnnotation
prePriceAnnotation
priceString
productImage

Inherited Fields

adGroupId
adType
destinationUrl
disapproved
displayUrl
exemptionRequest
id
status

Field name	Field type	Field description
`adGroupId`	`long`	The id of the AdGroup associated with this Ad. This field is not mutable.
`adType`	`AdType`	The concrete type of this ad. Generally, this attribute is read only, but may be set by scripting languages to indicate a concrete type. Values are: TextAd ImageAd LocalBusinessAd MobileAd CommerceAd VideoAd
`description1`	`string`	The first line of description text in the commerce ad. Must not exceed 35 characters.
`description2`	`string`	The second line of description text in the commerce ad. Must not exceed 35 characters.
`destinationUrl`	`string`	The destination URL associated with this Ad. May be overridden on a per-keyword basis by `Keyword.destinationUrl`. Must not exceed 1024 characters, or 200 characters for mobile ads. Must be in the full "http://" URL format. Example: http://www.google.com
`disapproved`	`boolean`	Whether this Ad has been disapproved by Google. Disapproved Ads will not be served. Ads might be disapproved for a variety of reasons, see the AdWords Help Center for more information about disapproved ads.
`displayUrl`	`string`	The URL shown in an Ad. Must not exceed 35 characters, or 20 characters for mobile ads. Mobile ads targeted to Japan must not exceed 10 Japanese characters. The full "http://" URL format is not required. Example: www.google.com
`exemptionRequest`	`string`	(Optional) Specifies a reason for allowing submission of an Ad or Keyword that violates the ad policies described by Google's AdWords Editorial Guidelines. Maximum length of the `exemptionRequest` string is 300 characters. If you want to submit an Ad or Keyword that violates an ad policy, you can specify a string explaining why you want an exemption to the policy in question. For example, if the headline of an Ad violates the policy for excessive punctuation, you might request an exemption such as "Ad for a board game that teaches correct punctuation." Specifying an `exemptionRequest` prevents an operation that adds a policy-violating Keyword or Ad from throwing an exception, but does not guarantee that the ad will ultimately be approved. For more information about Ad Violation policies, see the Google AdWords Editorial Guidelines.
`headline`	`string`	The headline of the commerce ad. Must not exceed 25 characters.
`id`	`long`	The numeric ID associated with this Ad. This is set by the AdService when the ad is created and it is not mutable.
`postPriceAnnotation`	`string`	(Optional) The post-price annotation shown after the price string. The text should not exceed 20 characters.
`prePriceAnnotation`	`string`	(Optional) The pre-price annotation shown before the price string. The text should not exceed 20 characters.
`priceString`	`string`	The price string of the product in the image. Must not exceed 9 characters.
`productImage`	`Image`	The product image. The image should meet the following conditions: The maximum dimension should fall between 180 and 360, inclusive. The aspect ratio should be between 0.5 and 2, inclusive.
`status`	`AdStatus`	The current status of this ad. Values are: Enabled Disabled Paused