VideoAd (AdWords API Developer's Guide)

VideoAd

Data associated with a video ad. This data is used by AdService.

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

Currently, the AdWords API does not support video upload. In order to create a video ad, users must upload their videos through Google AdWords. Once the videos are uploaded, the required video IDs of the uploaded videos can be retrieved via getMyVideos in AdService, which can then be used to create a video ad.

For details about video ads, such as rectangular dimensions, see Editorial Guidelines for Video Ads in the AdWords Help Center. Also see Video Ads FAQ.

Fields

image
name
video

Inherited Fields

adGroupId
adType
destinationUrl
disapproved
displayUrl
exemptionRequest
id
status

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 static, opening image for the video ad. Must be 50KB or smaller. Must be in .JPEG, .PNG, or .GIF format. For allowed rectangular dimensions in pixels, see Editorial Guidelines for Video Ads in the AdWords Help Center. (The ad system may resize some images.)
`name`	`string`	The name of the video ad. Must not exceed 50 characters.
`status`	`AdStatus`	The current status of this ad. Values are: Enabled Disabled Paused
`video`	`Video`	The video for the video ad.