My favorites | English | Sign in

Documentation for the requested version is not available.Documentation for the requested diff is not available.

ImageAd

Link to this version

Data associated with an image ad. Images can be static or animated. This data is used by AdService.

When creating an Image, you need to specify the name and data fields; all other fields are calculated by the AdService. None of the fields can be changed after the Image has been created. To make changes, you need to delete the Image and create a new one.

Note: For statically typed languages, such as Java, create an instance of ImageAd. For dynamically typed languages such as Perl and Python, create an Ad data object. Then either specify the xsi:type attribute as ImageAd or set the adType field to ImageAd.

For the latest details about image format, image size (in pixels), file size, and more, see Editorial Guidelines for Image Ads in the AdWords Help Center. Also see Image Ads FAQ.

Fields

Inherited Fields

adGroupId long
ID of the ad group associated with this ad. This field is not mutable.
adType AdType
Concrete type of this ad. Generally, this field is read-only, but may be set by scripting languages to indicate a concrete type.

Values are:

  • TextAd
  • ImageAd
  • LocalBusinessAd
  • MobileAd
  • CommerceAd
  • VideoAd
  • MobileImageAd  new in v13

destinationUrl string
Destination URL associated with this ad. May be overridden on a per-keyword basis by Keyword.destinationUrl. Must less than 1024 characters (or 200 characters for mobile ads). Must use the http://your-domain-name format (for example, http://www.google.com).
disapproved boolean
True if 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
URL shown in this ad. Must not exceed 35 characters (or 20 characters for mobile ads). Mobile ads targeted to Japan must not exceed 10 Japanese characters. http:// is not required (for examle, www.google.com).
exemptionRequest string
Reason for allowing submission of an ad that violates the ad policies described by Google's AdWords Editorial Guidelines. Must be no longer than 300 characters.

Set this field only if this ad violates policy. Unnecessarily specifying an exemption request will cause any add or update operation to fail.

For more information, see Policy Checking in the Web Services overview.

id long
ID of this ad. This field is set by AdService when the ad is created and it is not mutable.
image Image
The image data.
status AdStatus
Current status of this ad.

Values are:

  • Enabled
  • Disabled
  • Paused