ImageAd
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
| 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
|
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. |
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. |
image |
Image |
The image data. |
status |
AdStatus |
The current status of this ad.
Values are:
|
API Reference
