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 exist 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 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


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...