Represents Gmail ad.
Caution: Gmail ads do not use url, displayUrl, finalAppUrls, or devicePreference; Setting these fields on a Gmail ad will cause an error.
- Namespace
-
https://adwords.google.com/api/adwords/cm/v201809
Field |
|
|---|---|
Ad (inherited)
|
|
|
ID of this ad. This field is ignored when creating
ads using This field can be selected using the value "Id".
This field can be filtered on.
|
|
Destination URL. Do not set this field if you are using upgraded URLs, as described at: https://developers.google.com/adwords/api/docs/guides/upgraded-urls This field can be selected
using the value "Url".
This field can be filtered on.
|
|
Visible URL. This field can be selected using the value "DisplayUrl".
This field can be filtered on.
|
|
A list of possible final URLs after all cross domain redirects. This field is used for upgraded urls only, as described at: https://developers.google.com/adwords/api/docs/guides/upgraded-urls This field can be selected
using the value "CreativeFinalUrls".
This field can be filtered on.
The maximum size of this
collection is 10.
|
|
A list of possible final mobile URLs after all cross domain redirects. This field is used for upgraded urls only, as described at: https://developers.google.com/adwords/api/docs/guides/upgraded-urls This field can be selected
using the value "CreativeFinalMobileUrls".
This field can be filtered on.
The maximum size of this
collection is 10.
|
|
A list of final app URLs that will be used on mobile if the user has the specific app installed. This field is used for upgraded urls only, as described at: https://developers.google.com/adwords/api/docs/guides/upgraded-urls This field can be selected
using the value "CreativeFinalAppUrls".
This field can be filtered on.
|
|
URL template for constructing a tracking URL. This field is used for upgraded urls only, as described at: https://developers.google.com/adwords/api/docs/guides/upgraded-urls This field can be selected
using the value "CreativeTrackingUrlTemplate".
This field can be filtered on.
|
|
URL template for appending params to Final URL. On update, empty string ("") indicates to clear the field. This field can be selected
using the value "CreativeFinalUrlSuffix".
This field can be filtered on.
|
|
A list of mappings to be used for substituting URL custom parameter tags in the trackingUrlTemplate, finalUrls, and/or finalMobileUrls. This field is used for upgraded urls only, as described at: https://developers.google.com/adwords/api/docs/guides/upgraded-urls This field can be selected
using the value "CreativeUrlCustomParameters".
This field can be filtered on.
|
|
Additional urls for the ad that are tagged with a unique identifier. Currently only used for TemplateAds for specific template IDs. For all other ad types, use finalUrls, finalMobileUrls and finalAppUrls instead. This field can be selected using the value "UrlData".
|
|
Indicates if this ad was added by AdWords. |
|
Type of ad. Indicates that this instance is a subtype of Ad. Although this field is returned in the response, it is ignored on input and cannot be selected. Specify xsi:type instead. Enumerations
This field can be selected using the value "AdType".
This field can be filtered on.
|
|
The device preference for the ad. You can only specify a preference for mobile devices (CriterionId 30001). If unspecified (no device preference), all devices are targeted. |
|
The source of this system-managed ad. Enumerations
This field is read only and will be ignored when sent to the API.
|
|
Indicates that this instance is a subtype of Ad. Although this field is returned in the response, it is ignored on input and cannot be selected. Specify xsi:type instead. |
GmailAd
|
|
|
Gmail teaser info. This field is required and should not be
null when it is contained within Operators : SET. |
|
Header image. An image must first be created using the MediaService, and Image.mediaId must be populated when creating a GmailAd. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x100 and the aspect ratio must be in 3:1 to 5:1 (+-1%). |
|
Marketing image. An image must first be created using the MediaService, and Image.mediaId must be populated when creating a GmailAd.Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 600:314 (+-1%). For square marketing image, the minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). Either productVideos or marketingImage must be specified. |
|
Headline of the marketing image. Maximum display width is 25 characters. This field is required and should not be
null when it is contained within Operators : SET. |
|
Description of the marketing image. Maximum display width is 90 characters. This field is required and should not be
null when it is contained within Operators : SET. |
|
Display-call-to-action of the marketing image. The DisplayCallToAction.urlId field cannot be set when setting this field. |
|
Product images. Support up to 15 product images. |
|
Product Videos. Either productVideoList or marketingImage must be specified. Supports up to 7 product videos. It must be a YouTube hosted video and mediaId must be populated. The YouTube hosted video can be added to AdWords through either the AdWords UI or through AdWords Scripts (https://developers.google.com/adwords/scripts/docs/reference/adwordsapp/adwordsapp_videobuilder). |