My favorites | English | Sign in

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

Image

Link to this version

Data associated with an image for an image ad. Images can be static or animated.

When creating an Image, you must set the data field. For image ads, you must also set the name field. For mobile image ads, height and width must also be set. All other fields are calculated by 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.

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

data base64Binary[]
Raw image data. This field is required at creation time, but cannot be changed afterwards.

The value is an xsd:base64Binary, which is a base 64-encoded string. Java Axis clients take this value as a byte[]. Some SOAP toolkits take a string and perform encoding for you. Read your SOAP toolkit documentation for details of how to specify this kind of datatype.

This field is not set on read operations. Instead, use imageUrl to retrieve the image.

height int
Height of this image in pixels. This field is calculated by the AdService and cannot be changed.
imageUrl string
After you have created an image ad, you can use this URL to fetch the image or to link to it. This field is determined by AdService and cannot be changed.
mimeType string
MIME type of this image. This field is determined by the AdService and cannot be changed.
name string
Name of this image. This field is required for image ads and is optional for all other ad types. Once set, it cannot be changed.
shrunkenUrl string
After you have created an image ad, you can use this URL to fetch or link to a shrunken version of the image. The shrunken image is created by the AdService and the URL to it cannot be changed. This field will be null if a shrunken image cannot be generated.
thumbnailUrl string
After you have created an image ad, you can use this URL to fetch or link to a thumbnail version of the image. The thumbnail image is created by the AdService and the URL to it cannot be changed. This field will be null if a thumbnail image cannot be generated.
type ImageType
Type of this image.

Values are:

  • image -- any static image
  • dynamicImage -- an animated gif image
  • flash -- a flash image

width int
Width of the image in pixels. This field is calculated by AdService and cannot be changed.