Requires authorization
Inserts a new creative into Google's creative verification pipeline. Try it now.
Request
HTTP request
POST https://www.googleapis.com/adexchangebuyer/v1.3/creatives
Authorization
This request requires authorization with the following scope (read more about authentication and authorization).
| Scope |
|---|
https://www.googleapis.com/auth/adexchange.buyer |
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. | |
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 |
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 the buyer-declarable-creative-attributes.txt file. |
writable |
impressionTrackingUrl[] |
list |
The set of urls to be called to record an impression. | writable |
nativeAd |
object |
If nativeAd is set, HTMLSnippet and videoURL should not 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 file. | 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 the vendors.txt file. |
writable |
videoURL |
string |
The URL from which a video ad loads; that is, the URL to use to fetch that video ad. The resource at this URL is usually an XML document that contains a standard format for loading the video, plus tracking information. This is not the same as an HTML snippet, which is only for non-video ads. If set, HTMLSnippet 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.