Image
Data associated with an image for an image ad. Images can be static
or animated.
When creating an Image, you need to specify the data field.
For image ads, you must also specify the name field.
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
| Field name | Field type | Field description |
|---|
data |
base64Binary[] |
The 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 of the toolkits take a string
and do the encoding for you. Check with your toolkit for details of how to specify
this kind of datatype in your own situation. |
height |
int |
The 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 |
The mime type of this image.
This field is determined by the AdService and
cannot be changed. |
name |
string |
The 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
new in v11 |
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 CreativeService and the URL to it
cannot be changed.
This field will be null if a thumbnail image cannot be generated. |
type |
ImageType |
The type of this image.
Values are:
- image -- any static image
- dynamicImage -- an animated gif image
- flash -- a flash image
|
width |
int |
The width of the image in pixels. This field is calculated by
AdService and cannot be changed. |
API Reference
