Creatives: insert

Requires authorization

Inserts a new creative into Google's creative verification pipeline. Try it now.


HTTP request



This request requires authorization with the following scope (read more about authentication and authorization).


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. The value provided must be from 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 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 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 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


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.

Send feedback about...