You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
522 lines
24 KiB
522 lines
24 KiB
<html><body>
|
|
<style>
|
|
|
|
body, h1, h2, h3, div, span, p, pre, a {
|
|
margin: 0;
|
|
padding: 0;
|
|
border: 0;
|
|
font-weight: inherit;
|
|
font-style: inherit;
|
|
font-size: 100%;
|
|
font-family: inherit;
|
|
vertical-align: baseline;
|
|
}
|
|
|
|
body {
|
|
font-size: 13px;
|
|
padding: 1em;
|
|
}
|
|
|
|
h1 {
|
|
font-size: 26px;
|
|
margin-bottom: 1em;
|
|
}
|
|
|
|
h2 {
|
|
font-size: 24px;
|
|
margin-bottom: 1em;
|
|
}
|
|
|
|
h3 {
|
|
font-size: 20px;
|
|
margin-bottom: 1em;
|
|
margin-top: 1em;
|
|
}
|
|
|
|
pre, code {
|
|
line-height: 1.5;
|
|
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
|
|
}
|
|
|
|
pre {
|
|
margin-top: 0.5em;
|
|
}
|
|
|
|
h1, h2, h3, p {
|
|
font-family: Arial, sans serif;
|
|
}
|
|
|
|
h1, h2, h3 {
|
|
border-bottom: solid #CCC 1px;
|
|
}
|
|
|
|
.toc_element {
|
|
margin-top: 0.5em;
|
|
}
|
|
|
|
.firstline {
|
|
margin-left: 2 em;
|
|
}
|
|
|
|
.method {
|
|
margin-top: 1em;
|
|
border: solid 1px #CCC;
|
|
padding: 1em;
|
|
background: #EEE;
|
|
}
|
|
|
|
.details {
|
|
font-weight: bold;
|
|
font-size: 14px;
|
|
}
|
|
|
|
</style>
|
|
|
|
<h1><a href="adexchangebuyer_v1_3.html">Ad Exchange Buyer API</a> . <a href="adexchangebuyer_v1_3.creatives.html">creatives</a></h1>
|
|
<h2>Instance Methods</h2>
|
|
<p class="toc_element">
|
|
<code><a href="#get">get(accountId, buyerCreativeId)</a></code></p>
|
|
<p class="firstline">Gets the status for a single creative. A creative will be available 30-40 minutes after submission.</p>
|
|
<p class="toc_element">
|
|
<code><a href="#insert">insert(body)</a></code></p>
|
|
<p class="firstline">Submit a new creative.</p>
|
|
<p class="toc_element">
|
|
<code><a href="#list">list(pageToken=None, maxResults=None, statusFilter=None, buyerCreativeId=None, accountId=None)</a></code></p>
|
|
<p class="firstline">Retrieves a list of the authenticated user's active creatives. A creative will be available 30-40 minutes after submission.</p>
|
|
<p class="toc_element">
|
|
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
|
|
<p class="firstline">Retrieves the next page of results.</p>
|
|
<h3>Method Details</h3>
|
|
<div class="method">
|
|
<code class="details" id="get">get(accountId, buyerCreativeId)</code>
|
|
<pre>Gets the status for a single creative. A creative will be available 30-40 minutes after submission.
|
|
|
|
Args:
|
|
accountId: integer, The id for the account that will serve this creative. (required)
|
|
buyerCreativeId: string, The buyer-specific id for this creative. (required)
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # A creative and its classification data.
|
|
"status": "A String", # Creative serving status. Read-only. This field should not be set in requests.
|
|
"attribute": [ # All attributes for the ads that may be shown from this snippet.
|
|
42,
|
|
],
|
|
"height": 42, # Ad height.
|
|
"advertiserName": "A String", # The name of the company being advertised in the creative.
|
|
"HTMLSnippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. If set, videoURL should not be set.
|
|
"buyerCreativeId": "A String", # A buyer-specific id identifying the creative in this ad.
|
|
"impressionTrackingUrl": [ # The set of urls to be called to record an impression.
|
|
"A String",
|
|
],
|
|
"accountId": 42, # Account id.
|
|
"videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set.
|
|
"clickThroughUrl": [ # The set of destination urls for the snippet.
|
|
"A String",
|
|
],
|
|
"width": 42, # Ad width.
|
|
"nativeAd": { # If nativeAd is set, HTMLSnippet and videoURL should not be set.
|
|
"body": "A String", # A long description of the ad.
|
|
"advertiser": "A String",
|
|
"store": "A String", # The URL to the app store to purchase/download the promoted app.
|
|
"headline": "A String", # A short title for the ad.
|
|
"image": { # A large image.
|
|
"url": "A String",
|
|
"width": 42,
|
|
"height": 42,
|
|
},
|
|
"starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
|
|
"callToAction": "A String", # A label for the button that the user is supposed to click.
|
|
"logo": { # A smaller image, for the advertiser logo.
|
|
"url": "A String",
|
|
"width": 42,
|
|
"height": 42,
|
|
},
|
|
"appIcon": { # The app icon, for app download ads.
|
|
"url": "A String",
|
|
"width": 42,
|
|
"height": 42,
|
|
},
|
|
"impressionTrackingUrl": [ # The URLs are called when the impression is rendered.
|
|
"A String",
|
|
],
|
|
"price": "A String", # The price of the promoted app including the currency info.
|
|
"clickTrackingUrl": "A String", # The URL to use for click tracking.
|
|
},
|
|
"version": 42, # The version for this creative. Read-only. This field should not be set in requests.
|
|
"apiUploadTimestamp": "A String", # The last upload timestamp of this creative if it was uploaded via API. Read-only. The value of this field is generated, and will be ignored for uploads. (formatted RFC 3339 timestamp).
|
|
"vendorType": [ # All vendor types for the ads that may be shown from this snippet.
|
|
42,
|
|
],
|
|
"disapprovalReasons": [ # The reasons for disapproval, if any. Note that not all disapproval reasons may be categorized, so it is possible for the creative to have a status of DISAPPROVED with an empty list for disapproval_reasons. In this case, please reach out to your TAM to help debug the issue. Read-only. This field should not be set in requests.
|
|
{
|
|
"reason": "A String", # The categorized reason for disapproval.
|
|
"details": [ # Additional details about the reason for disapproval.
|
|
"A String",
|
|
],
|
|
},
|
|
],
|
|
"sensitiveCategories": [ # Detected sensitive categories, if any. Read-only. This field should not be set in requests.
|
|
42,
|
|
],
|
|
"productCategories": [ # Detected product categories, if any. Read-only. This field should not be set in requests.
|
|
42,
|
|
],
|
|
"agencyId": "A String", # The agency id for this creative.
|
|
"advertiserId": [ # Detected advertiser id, if any. Read-only. This field should not be set in requests.
|
|
"A String",
|
|
],
|
|
"kind": "adexchangebuyer#creative", # Resource type.
|
|
"restrictedCategories": [ # All restricted categories for the ads that may be shown from this snippet.
|
|
42,
|
|
],
|
|
"corrections": [ # Shows any corrections that were applied to this creative. Read-only. This field should not be set in requests.
|
|
{
|
|
"reason": "A String", # The type of correction that was applied to the creative.
|
|
"details": [ # Additional details about the correction.
|
|
"A String",
|
|
],
|
|
},
|
|
],
|
|
"filteringReasons": { # The filtering reasons for the creative. Read-only. This field should not be set in requests.
|
|
"date": "A String", # The date in ISO 8601 format for the data. The data is collected from 00:00:00 to 23:59:59 in PST.
|
|
"reasons": [ # The filtering reasons.
|
|
{
|
|
"filteringCount": "A String", # The number of times the creative was filtered for the status. The count is aggregated across all publishers on the exchange.
|
|
"filteringStatus": 42, # The filtering status code. Please refer to the creative-status-codes.txt file for different statuses.
|
|
},
|
|
],
|
|
},
|
|
}</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="insert">insert(body)</code>
|
|
<pre>Submit a new creative.
|
|
|
|
Args:
|
|
body: object, The request body. (required)
|
|
The object takes the form of:
|
|
|
|
{ # A creative and its classification data.
|
|
"status": "A String", # Creative serving status. Read-only. This field should not be set in requests.
|
|
"attribute": [ # All attributes for the ads that may be shown from this snippet.
|
|
42,
|
|
],
|
|
"height": 42, # Ad height.
|
|
"advertiserName": "A String", # The name of the company being advertised in the creative.
|
|
"HTMLSnippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. If set, videoURL should not be set.
|
|
"buyerCreativeId": "A String", # A buyer-specific id identifying the creative in this ad.
|
|
"impressionTrackingUrl": [ # The set of urls to be called to record an impression.
|
|
"A String",
|
|
],
|
|
"accountId": 42, # Account id.
|
|
"videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set.
|
|
"clickThroughUrl": [ # The set of destination urls for the snippet.
|
|
"A String",
|
|
],
|
|
"width": 42, # Ad width.
|
|
"nativeAd": { # If nativeAd is set, HTMLSnippet and videoURL should not be set.
|
|
"body": "A String", # A long description of the ad.
|
|
"advertiser": "A String",
|
|
"store": "A String", # The URL to the app store to purchase/download the promoted app.
|
|
"headline": "A String", # A short title for the ad.
|
|
"image": { # A large image.
|
|
"url": "A String",
|
|
"width": 42,
|
|
"height": 42,
|
|
},
|
|
"starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
|
|
"callToAction": "A String", # A label for the button that the user is supposed to click.
|
|
"logo": { # A smaller image, for the advertiser logo.
|
|
"url": "A String",
|
|
"width": 42,
|
|
"height": 42,
|
|
},
|
|
"appIcon": { # The app icon, for app download ads.
|
|
"url": "A String",
|
|
"width": 42,
|
|
"height": 42,
|
|
},
|
|
"impressionTrackingUrl": [ # The URLs are called when the impression is rendered.
|
|
"A String",
|
|
],
|
|
"price": "A String", # The price of the promoted app including the currency info.
|
|
"clickTrackingUrl": "A String", # The URL to use for click tracking.
|
|
},
|
|
"version": 42, # The version for this creative. Read-only. This field should not be set in requests.
|
|
"apiUploadTimestamp": "A String", # The last upload timestamp of this creative if it was uploaded via API. Read-only. The value of this field is generated, and will be ignored for uploads. (formatted RFC 3339 timestamp).
|
|
"vendorType": [ # All vendor types for the ads that may be shown from this snippet.
|
|
42,
|
|
],
|
|
"disapprovalReasons": [ # The reasons for disapproval, if any. Note that not all disapproval reasons may be categorized, so it is possible for the creative to have a status of DISAPPROVED with an empty list for disapproval_reasons. In this case, please reach out to your TAM to help debug the issue. Read-only. This field should not be set in requests.
|
|
{
|
|
"reason": "A String", # The categorized reason for disapproval.
|
|
"details": [ # Additional details about the reason for disapproval.
|
|
"A String",
|
|
],
|
|
},
|
|
],
|
|
"sensitiveCategories": [ # Detected sensitive categories, if any. Read-only. This field should not be set in requests.
|
|
42,
|
|
],
|
|
"productCategories": [ # Detected product categories, if any. Read-only. This field should not be set in requests.
|
|
42,
|
|
],
|
|
"agencyId": "A String", # The agency id for this creative.
|
|
"advertiserId": [ # Detected advertiser id, if any. Read-only. This field should not be set in requests.
|
|
"A String",
|
|
],
|
|
"kind": "adexchangebuyer#creative", # Resource type.
|
|
"restrictedCategories": [ # All restricted categories for the ads that may be shown from this snippet.
|
|
42,
|
|
],
|
|
"corrections": [ # Shows any corrections that were applied to this creative. Read-only. This field should not be set in requests.
|
|
{
|
|
"reason": "A String", # The type of correction that was applied to the creative.
|
|
"details": [ # Additional details about the correction.
|
|
"A String",
|
|
],
|
|
},
|
|
],
|
|
"filteringReasons": { # The filtering reasons for the creative. Read-only. This field should not be set in requests.
|
|
"date": "A String", # The date in ISO 8601 format for the data. The data is collected from 00:00:00 to 23:59:59 in PST.
|
|
"reasons": [ # The filtering reasons.
|
|
{
|
|
"filteringCount": "A String", # The number of times the creative was filtered for the status. The count is aggregated across all publishers on the exchange.
|
|
"filteringStatus": 42, # The filtering status code. Please refer to the creative-status-codes.txt file for different statuses.
|
|
},
|
|
],
|
|
},
|
|
}
|
|
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # A creative and its classification data.
|
|
"status": "A String", # Creative serving status. Read-only. This field should not be set in requests.
|
|
"attribute": [ # All attributes for the ads that may be shown from this snippet.
|
|
42,
|
|
],
|
|
"height": 42, # Ad height.
|
|
"advertiserName": "A String", # The name of the company being advertised in the creative.
|
|
"HTMLSnippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. If set, videoURL should not be set.
|
|
"buyerCreativeId": "A String", # A buyer-specific id identifying the creative in this ad.
|
|
"impressionTrackingUrl": [ # The set of urls to be called to record an impression.
|
|
"A String",
|
|
],
|
|
"accountId": 42, # Account id.
|
|
"videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set.
|
|
"clickThroughUrl": [ # The set of destination urls for the snippet.
|
|
"A String",
|
|
],
|
|
"width": 42, # Ad width.
|
|
"nativeAd": { # If nativeAd is set, HTMLSnippet and videoURL should not be set.
|
|
"body": "A String", # A long description of the ad.
|
|
"advertiser": "A String",
|
|
"store": "A String", # The URL to the app store to purchase/download the promoted app.
|
|
"headline": "A String", # A short title for the ad.
|
|
"image": { # A large image.
|
|
"url": "A String",
|
|
"width": 42,
|
|
"height": 42,
|
|
},
|
|
"starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
|
|
"callToAction": "A String", # A label for the button that the user is supposed to click.
|
|
"logo": { # A smaller image, for the advertiser logo.
|
|
"url": "A String",
|
|
"width": 42,
|
|
"height": 42,
|
|
},
|
|
"appIcon": { # The app icon, for app download ads.
|
|
"url": "A String",
|
|
"width": 42,
|
|
"height": 42,
|
|
},
|
|
"impressionTrackingUrl": [ # The URLs are called when the impression is rendered.
|
|
"A String",
|
|
],
|
|
"price": "A String", # The price of the promoted app including the currency info.
|
|
"clickTrackingUrl": "A String", # The URL to use for click tracking.
|
|
},
|
|
"version": 42, # The version for this creative. Read-only. This field should not be set in requests.
|
|
"apiUploadTimestamp": "A String", # The last upload timestamp of this creative if it was uploaded via API. Read-only. The value of this field is generated, and will be ignored for uploads. (formatted RFC 3339 timestamp).
|
|
"vendorType": [ # All vendor types for the ads that may be shown from this snippet.
|
|
42,
|
|
],
|
|
"disapprovalReasons": [ # The reasons for disapproval, if any. Note that not all disapproval reasons may be categorized, so it is possible for the creative to have a status of DISAPPROVED with an empty list for disapproval_reasons. In this case, please reach out to your TAM to help debug the issue. Read-only. This field should not be set in requests.
|
|
{
|
|
"reason": "A String", # The categorized reason for disapproval.
|
|
"details": [ # Additional details about the reason for disapproval.
|
|
"A String",
|
|
],
|
|
},
|
|
],
|
|
"sensitiveCategories": [ # Detected sensitive categories, if any. Read-only. This field should not be set in requests.
|
|
42,
|
|
],
|
|
"productCategories": [ # Detected product categories, if any. Read-only. This field should not be set in requests.
|
|
42,
|
|
],
|
|
"agencyId": "A String", # The agency id for this creative.
|
|
"advertiserId": [ # Detected advertiser id, if any. Read-only. This field should not be set in requests.
|
|
"A String",
|
|
],
|
|
"kind": "adexchangebuyer#creative", # Resource type.
|
|
"restrictedCategories": [ # All restricted categories for the ads that may be shown from this snippet.
|
|
42,
|
|
],
|
|
"corrections": [ # Shows any corrections that were applied to this creative. Read-only. This field should not be set in requests.
|
|
{
|
|
"reason": "A String", # The type of correction that was applied to the creative.
|
|
"details": [ # Additional details about the correction.
|
|
"A String",
|
|
],
|
|
},
|
|
],
|
|
"filteringReasons": { # The filtering reasons for the creative. Read-only. This field should not be set in requests.
|
|
"date": "A String", # The date in ISO 8601 format for the data. The data is collected from 00:00:00 to 23:59:59 in PST.
|
|
"reasons": [ # The filtering reasons.
|
|
{
|
|
"filteringCount": "A String", # The number of times the creative was filtered for the status. The count is aggregated across all publishers on the exchange.
|
|
"filteringStatus": 42, # The filtering status code. Please refer to the creative-status-codes.txt file for different statuses.
|
|
},
|
|
],
|
|
},
|
|
}</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="list">list(pageToken=None, maxResults=None, statusFilter=None, buyerCreativeId=None, accountId=None)</code>
|
|
<pre>Retrieves a list of the authenticated user's active creatives. A creative will be available 30-40 minutes after submission.
|
|
|
|
Args:
|
|
pageToken: string, A continuation token, used to page through ad clients. To retrieve the next page, set this parameter to the value of "nextPageToken" from the previous response. Optional.
|
|
maxResults: integer, Maximum number of entries returned on one result page. If not set, the default is 100. Optional.
|
|
statusFilter: string, When specified, only creatives having the given status are returned.
|
|
Allowed values
|
|
approved - Creatives which have been approved.
|
|
disapproved - Creatives which have been disapproved.
|
|
not_checked - Creatives whose status is not yet checked.
|
|
buyerCreativeId: string, When specified, only creatives for the given buyer creative ids are returned. (repeated)
|
|
accountId: integer, When specified, only creatives for the given account ids are returned. (repeated)
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # The creatives feed lists the active creatives for the Ad Exchange buyer accounts that the user has access to. Each entry in the feed corresponds to a single creative.
|
|
"nextPageToken": "A String", # Continuation token used to page through creatives. To retrieve the next page of results, set the next request's "pageToken" value to this.
|
|
"items": [ # A list of creatives.
|
|
{ # A creative and its classification data.
|
|
"status": "A String", # Creative serving status. Read-only. This field should not be set in requests.
|
|
"attribute": [ # All attributes for the ads that may be shown from this snippet.
|
|
42,
|
|
],
|
|
"height": 42, # Ad height.
|
|
"advertiserName": "A String", # The name of the company being advertised in the creative.
|
|
"HTMLSnippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. If set, videoURL should not be set.
|
|
"buyerCreativeId": "A String", # A buyer-specific id identifying the creative in this ad.
|
|
"impressionTrackingUrl": [ # The set of urls to be called to record an impression.
|
|
"A String",
|
|
],
|
|
"accountId": 42, # Account id.
|
|
"videoURL": "A String", # The URL to fetch a video ad. If set, HTMLSnippet and the nativeAd should not be set.
|
|
"clickThroughUrl": [ # The set of destination urls for the snippet.
|
|
"A String",
|
|
],
|
|
"width": 42, # Ad width.
|
|
"nativeAd": { # If nativeAd is set, HTMLSnippet and videoURL should not be set.
|
|
"body": "A String", # A long description of the ad.
|
|
"advertiser": "A String",
|
|
"store": "A String", # The URL to the app store to purchase/download the promoted app.
|
|
"headline": "A String", # A short title for the ad.
|
|
"image": { # A large image.
|
|
"url": "A String",
|
|
"width": 42,
|
|
"height": 42,
|
|
},
|
|
"starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
|
|
"callToAction": "A String", # A label for the button that the user is supposed to click.
|
|
"logo": { # A smaller image, for the advertiser logo.
|
|
"url": "A String",
|
|
"width": 42,
|
|
"height": 42,
|
|
},
|
|
"appIcon": { # The app icon, for app download ads.
|
|
"url": "A String",
|
|
"width": 42,
|
|
"height": 42,
|
|
},
|
|
"impressionTrackingUrl": [ # The URLs are called when the impression is rendered.
|
|
"A String",
|
|
],
|
|
"price": "A String", # The price of the promoted app including the currency info.
|
|
"clickTrackingUrl": "A String", # The URL to use for click tracking.
|
|
},
|
|
"version": 42, # The version for this creative. Read-only. This field should not be set in requests.
|
|
"apiUploadTimestamp": "A String", # The last upload timestamp of this creative if it was uploaded via API. Read-only. The value of this field is generated, and will be ignored for uploads. (formatted RFC 3339 timestamp).
|
|
"vendorType": [ # All vendor types for the ads that may be shown from this snippet.
|
|
42,
|
|
],
|
|
"disapprovalReasons": [ # The reasons for disapproval, if any. Note that not all disapproval reasons may be categorized, so it is possible for the creative to have a status of DISAPPROVED with an empty list for disapproval_reasons. In this case, please reach out to your TAM to help debug the issue. Read-only. This field should not be set in requests.
|
|
{
|
|
"reason": "A String", # The categorized reason for disapproval.
|
|
"details": [ # Additional details about the reason for disapproval.
|
|
"A String",
|
|
],
|
|
},
|
|
],
|
|
"sensitiveCategories": [ # Detected sensitive categories, if any. Read-only. This field should not be set in requests.
|
|
42,
|
|
],
|
|
"productCategories": [ # Detected product categories, if any. Read-only. This field should not be set in requests.
|
|
42,
|
|
],
|
|
"agencyId": "A String", # The agency id for this creative.
|
|
"advertiserId": [ # Detected advertiser id, if any. Read-only. This field should not be set in requests.
|
|
"A String",
|
|
],
|
|
"kind": "adexchangebuyer#creative", # Resource type.
|
|
"restrictedCategories": [ # All restricted categories for the ads that may be shown from this snippet.
|
|
42,
|
|
],
|
|
"corrections": [ # Shows any corrections that were applied to this creative. Read-only. This field should not be set in requests.
|
|
{
|
|
"reason": "A String", # The type of correction that was applied to the creative.
|
|
"details": [ # Additional details about the correction.
|
|
"A String",
|
|
],
|
|
},
|
|
],
|
|
"filteringReasons": { # The filtering reasons for the creative. Read-only. This field should not be set in requests.
|
|
"date": "A String", # The date in ISO 8601 format for the data. The data is collected from 00:00:00 to 23:59:59 in PST.
|
|
"reasons": [ # The filtering reasons.
|
|
{
|
|
"filteringCount": "A String", # The number of times the creative was filtered for the status. The count is aggregated across all publishers on the exchange.
|
|
"filteringStatus": 42, # The filtering status code. Please refer to the creative-status-codes.txt file for different statuses.
|
|
},
|
|
],
|
|
},
|
|
},
|
|
],
|
|
"kind": "adexchangebuyer#creativesList", # Resource type.
|
|
}</pre>
|
|
</div>
|
|
|
|
<div class="method">
|
|
<code class="details" id="list_next">list_next(previous_request, previous_response)</code>
|
|
<pre>Retrieves the next page of results.
|
|
|
|
Args:
|
|
previous_request: The request for the previous page. (required)
|
|
previous_response: The response from the request for the previous page. (required)
|
|
|
|
Returns:
|
|
A request object that you can call 'execute()' on to request the next
|
|
page. Returns None if there are no more items in the collection.
|
|
</pre>
|
|
</div>
|
|
|
|
</body></html> |