Inserts a new creative into Google's creative verification pipeline. Try it now.
Request
HTTP request
POST https://www.googleapis.com/adexchangebuyer/v1.4/creatives
Authorization
This request requires authorization with the following scope:
| Scope |
|---|
https://www.googleapis.com/auth/adexchange.buyer |
For more information, see the authentication and authorization page.
Request body
In the request body, supply a Creatives resource with the following properties:
| Property name | Value | Description | Notes |
|---|---|---|---|
| Required Properties | |||
accountId |
integer |
Account ID. | |
advertiserName |
string |
The name of the company being advertised in the creative. A list of advertisers is provided in the advertisers.txt file. | |
buyerCreativeId |
string |
A buyer-specific ID identifying the creative in this ad. | |
clickThroughUrl[] |
list |
The set of destination URLs for the snippet. | |
height |
integer |
Ad height in pixels. | |
width |
integer |
Ad width in pixels. | |
| Optional Properties | |||
HTMLSnippet |
string |
The HTML snippet that displays the ad when inserted in the web page. If set, videoURL should not be set. |
writable |
adChoicesDestinationUrl |
string |
The link to the Ad Preferences page. This is only supported for native ads. | writable |
agencyId |
long |
The agency id for this creative. | writable |
attribute[] |
list |
List of buyer selectable attributes for the ads that may be shown from this snippet. Each attribute is represented by an integer as defined in buyer-declarable-creative-attributes.txt. | writable |
impressionTrackingUrl[] |
list |
The set of urls to be called to record an impression. | writable |
nativeAd |
object |
If nativeAd is set, HTMLSnippet, videoVastXML, and the videoURL outside of nativeAd should not be set. (The videoURL inside nativeAd can be set.) | writable |
restrictedCategories[] |
list |
All restricted categories for the ads that may be shown from this snippet. Each category is represented by an integer as defined in the ad-restricted-categories.txt. | writable |
vendorType[] |
list |
List of vendor types for the ads that may be shown from this snippet. Each vendor type is represented by an integer as defined in vendors.txt. | writable |
videoURL |
string |
The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set. Note, this is different from resource.native_ad.video_url above. | writable |
videoVastXML |
string |
The contents of a VAST document for a video ad. This document should conform to the VAST 2.0 or 3.0 standard. If set, HTMLSnippet, videoURL, and nativeAd and should not be set. | writable |
Response
If successful, this method returns a Creatives resource in the response body.
Try it!
Use the APIs Explorer below to call this method on live data and see the response.