1 <html><body> 2 <style> 3 4 body, h1, h2, h3, div, span, p, pre, a { 5 margin: 0; 6 padding: 0; 7 border: 0; 8 font-weight: inherit; 9 font-style: inherit; 10 font-size: 100%; 11 font-family: inherit; 12 vertical-align: baseline; 13 } 14 15 body { 16 font-size: 13px; 17 padding: 1em; 18 } 19 20 h1 { 21 font-size: 26px; 22 margin-bottom: 1em; 23 } 24 25 h2 { 26 font-size: 24px; 27 margin-bottom: 1em; 28 } 29 30 h3 { 31 font-size: 20px; 32 margin-bottom: 1em; 33 margin-top: 1em; 34 } 35 36 pre, code { 37 line-height: 1.5; 38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; 39 } 40 41 pre { 42 margin-top: 0.5em; 43 } 44 45 h1, h2, h3, p { 46 font-family: Arial, sans serif; 47 } 48 49 h1, h2, h3 { 50 border-bottom: solid #CCC 1px; 51 } 52 53 .toc_element { 54 margin-top: 0.5em; 55 } 56 57 .firstline { 58 margin-left: 2 em; 59 } 60 61 .method { 62 margin-top: 1em; 63 border: solid 1px #CCC; 64 padding: 1em; 65 background: #EEE; 66 } 67 68 .details { 69 font-weight: bold; 70 font-size: 14px; 71 } 72 73 </style> 74 75 <h1><a href="adexchangebuyer_v1_4.html">Ad Exchange Buyer API</a> . <a href="adexchangebuyer_v1_4.creatives.html">creatives</a></h1> 76 <h2>Instance Methods</h2> 77 <p class="toc_element"> 78 <code><a href="#addDeal">addDeal(accountId, buyerCreativeId, dealId)</a></code></p> 79 <p class="firstline">Add a deal id association for the creative.</p> 80 <p class="toc_element"> 81 <code><a href="#get">get(accountId, buyerCreativeId)</a></code></p> 82 <p class="firstline">Gets the status for a single creative. A creative will be available 30-40 minutes after submission.</p> 83 <p class="toc_element"> 84 <code><a href="#insert">insert(body)</a></code></p> 85 <p class="firstline">Submit a new creative.</p> 86 <p class="toc_element"> 87 <code><a href="#list">list(dealsStatusFilter=None, openAuctionStatusFilter=None, pageToken=None, maxResults=None, buyerCreativeId=None, accountId=None)</a></code></p> 88 <p class="firstline">Retrieves a list of the authenticated user's active creatives. A creative will be available 30-40 minutes after submission.</p> 89 <p class="toc_element"> 90 <code><a href="#listDeals">listDeals(accountId, buyerCreativeId)</a></code></p> 91 <p class="firstline">Lists the external deal ids associated with the creative.</p> 92 <p class="toc_element"> 93 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> 94 <p class="firstline">Retrieves the next page of results.</p> 95 <p class="toc_element"> 96 <code><a href="#removeDeal">removeDeal(accountId, buyerCreativeId, dealId)</a></code></p> 97 <p class="firstline">Remove a deal id associated with the creative.</p> 98 <h3>Method Details</h3> 99 <div class="method"> 100 <code class="details" id="addDeal">addDeal(accountId, buyerCreativeId, dealId)</code> 101 <pre>Add a deal id association for the creative. 102 103 Args: 104 accountId: integer, The id for the account that will serve this creative. (required) 105 buyerCreativeId: string, The buyer-specific id for this creative. (required) 106 dealId: string, The id of the deal id to associate with this creative. (required) 107 </pre> 108 </div> 109 110 <div class="method"> 111 <code class="details" id="get">get(accountId, buyerCreativeId)</code> 112 <pre>Gets the status for a single creative. A creative will be available 30-40 minutes after submission. 113 114 Args: 115 accountId: integer, The id for the account that will serve this creative. (required) 116 buyerCreativeId: string, The buyer-specific id for this creative. (required) 117 118 Returns: 119 An object of the form: 120 121 { # A creative and its classification data. 122 "attribute": [ # 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. 123 42, 124 ], 125 "height": 42, # Ad height. 126 "advertiserName": "A String", # The name of the company being advertised in the creative. The value provided must exist in the advertisers.txt file. 127 "HTMLSnippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. If set, videoURL should not be set. 128 "openAuctionStatus": "A String", # Top-level open auction status. Read-only. This field should not be set in requests. If disapproved, an entry for auctionType=OPEN_AUCTION (or ALL) in servingRestrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case it may be preferable to read from ServingRestrictions directly. 129 "buyerCreativeId": "A String", # A buyer-specific id identifying the creative in this ad. 130 "adChoicesDestinationUrl": "A String", # The link to the Ad Preferences page. This is only supported for native ads. 131 "impressionTrackingUrl": [ # The set of urls to be called to record an impression. 132 "A String", 133 ], 134 "accountId": 42, # Account id. 135 "videoURL": "A 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. 136 "clickThroughUrl": [ # The set of destination urls for the snippet. 137 "A String", 138 ], 139 "languages": [ # Detected languages for this creative. Read-only. This field should not be set in requests. 140 "A String", 141 ], 142 "width": 42, # Ad width. 143 "nativeAd": { # If nativeAd is set, HTMLSnippet and the videoURL outside of nativeAd should not be set. (The videoURL inside nativeAd can be set.) 144 "body": "A String", # A long description of the ad. 145 "advertiser": "A String", 146 "store": "A String", # The URL to the app store to purchase/download the promoted app. 147 "videoURL": "A String", # The URL of the XML VAST for a native ad. Note this is a separate field from resource.video_url. 148 "headline": "A String", # A short title for the ad. 149 "image": { # A large image. 150 "url": "A String", 151 "width": 42, 152 "height": 42, 153 }, 154 "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5]. 155 "callToAction": "A String", # A label for the button that the user is supposed to click. 156 "logo": { # A smaller image, for the advertiser logo. 157 "url": "A String", 158 "width": 42, 159 "height": 42, 160 }, 161 "appIcon": { # The app icon, for app download ads. 162 "url": "A String", 163 "width": 42, 164 "height": 42, 165 }, 166 "impressionTrackingUrl": [ # The URLs are called when the impression is rendered. 167 "A String", 168 ], 169 "price": "A String", # The price of the promoted app including the currency info. 170 "clickTrackingUrl": "A String", # The URL to use for click tracking. 171 "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad. 172 }, 173 "version": 42, # The version for this creative. Read-only. This field should not be set in requests. 174 "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). 175 "vendorType": [ # 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. 176 42, 177 ], 178 "sensitiveCategories": [ # Detected sensitive categories, if any. Each category is represented by an integer as defined in ad-sensitive-categories.txt. Read-only. This field should not be set in requests. 179 42, 180 ], 181 "productCategories": [ # Detected product categories, if any. Each category is represented by an integer as defined in ad-product-categories.txt. Read-only. This field should not be set in requests. 182 42, 183 ], 184 "agencyId": "A String", # The agency id for this creative. 185 "detectedDomains": [ # Detected domains for this creative. Read-only. This field should not be set in requests. 186 "A String", 187 ], 188 "dealsStatus": "A String", # Top-level deals status. Read-only. This field should not be set in requests. If disapproved, an entry for auctionType=DIRECT_DEALS (or ALL) in servingRestrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case it may be preferable to read from servingRestrictions directly. 189 "advertiserId": [ # Detected advertiser id, if any. Read-only. This field should not be set in requests. 190 "A String", 191 ], 192 "kind": "adexchangebuyer#creative", # Resource type. 193 "servingRestrictions": [ # The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction). Read-only. This field should not be set in requests. See the examples in the Creatives guide for more details. 194 { 195 "contexts": [ # All known contexts/restrictions. 196 { 197 "platform": [ # Only set when contextType=PLATFORM. Represents the platforms this restriction applies to. 198 "A String", 199 ], 200 "contextType": "A String", # The type of context (e.g., location, platform, auction type, SSL-ness). 201 "auctionType": [ # Only set when contextType=AUCTION_TYPE. Represents the auction types this restriction applies to. 202 "A String", 203 ], 204 "geoCriteriaId": [ # Only set when contextType=LOCATION. Represents the geo criterias this restriction applies to. Impressions are considered to match a context if either the user location or publisher location matches a given geoCriteriaId. 205 42, 206 ], 207 }, 208 ], 209 "disapprovalReasons": [ # The reasons for disapproval within this restriction, if any. Note that not all disapproval reasons may be categorized, so it is possible for the creative to have a status of DISAPPROVED or CONDITIONALLY_APPROVED with an empty list for disapproval_reasons. In this case, please reach out to your TAM to help debug the issue. 210 { 211 "reason": "A String", # The categorized reason for disapproval. 212 "details": [ # Additional details about the reason for disapproval. 213 "A String", 214 ], 215 }, 216 ], 217 "reason": "A String", # Why the creative is ineligible to serve in this context (e.g., it has been explicitly disapproved or is pending review). 218 }, 219 ], 220 "restrictedCategories": [ # 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. 221 42, 222 ], 223 "corrections": [ # Shows any corrections that were applied to this creative. Read-only. This field should not be set in requests. 224 { 225 "contexts": [ # All known serving contexts containing serving status information. 226 { 227 "platform": [ # Only set when contextType=PLATFORM. Represents the platforms this correction applies to. 228 "A String", 229 ], 230 "contextType": "A String", # The type of context (e.g., location, platform, auction type, SSL-ness). 231 "auctionType": [ # Only set when contextType=AUCTION_TYPE. Represents the auction types this correction applies to. 232 "A String", 233 ], 234 "geoCriteriaId": [ # Only set when contextType=LOCATION. Represents the geo criterias this correction applies to. 235 42, 236 ], 237 }, 238 ], 239 "reason": "A String", # The type of correction that was applied to the creative. 240 "details": [ # Additional details about the correction. 241 "A String", 242 ], 243 }, 244 ], 245 "filteringReasons": { # The filtering reasons for the creative. Read-only. This field should not be set in requests. 246 "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. 247 "reasons": [ # The filtering reasons. 248 { 249 "filteringCount": "A String", # The number of times the creative was filtered for the status. The count is aggregated across all publishers on the exchange. 250 "filteringStatus": 42, # The filtering status code as defined in creative-status-codes.txt. 251 }, 252 ], 253 }, 254 }</pre> 255 </div> 256 257 <div class="method"> 258 <code class="details" id="insert">insert(body)</code> 259 <pre>Submit a new creative. 260 261 Args: 262 body: object, The request body. (required) 263 The object takes the form of: 264 265 { # A creative and its classification data. 266 "attribute": [ # 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. 267 42, 268 ], 269 "height": 42, # Ad height. 270 "advertiserName": "A String", # The name of the company being advertised in the creative. The value provided must exist in the advertisers.txt file. 271 "HTMLSnippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. If set, videoURL should not be set. 272 "openAuctionStatus": "A String", # Top-level open auction status. Read-only. This field should not be set in requests. If disapproved, an entry for auctionType=OPEN_AUCTION (or ALL) in servingRestrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case it may be preferable to read from ServingRestrictions directly. 273 "buyerCreativeId": "A String", # A buyer-specific id identifying the creative in this ad. 274 "adChoicesDestinationUrl": "A String", # The link to the Ad Preferences page. This is only supported for native ads. 275 "impressionTrackingUrl": [ # The set of urls to be called to record an impression. 276 "A String", 277 ], 278 "accountId": 42, # Account id. 279 "videoURL": "A 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. 280 "clickThroughUrl": [ # The set of destination urls for the snippet. 281 "A String", 282 ], 283 "languages": [ # Detected languages for this creative. Read-only. This field should not be set in requests. 284 "A String", 285 ], 286 "width": 42, # Ad width. 287 "nativeAd": { # If nativeAd is set, HTMLSnippet and the videoURL outside of nativeAd should not be set. (The videoURL inside nativeAd can be set.) 288 "body": "A String", # A long description of the ad. 289 "advertiser": "A String", 290 "store": "A String", # The URL to the app store to purchase/download the promoted app. 291 "videoURL": "A String", # The URL of the XML VAST for a native ad. Note this is a separate field from resource.video_url. 292 "headline": "A String", # A short title for the ad. 293 "image": { # A large image. 294 "url": "A String", 295 "width": 42, 296 "height": 42, 297 }, 298 "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5]. 299 "callToAction": "A String", # A label for the button that the user is supposed to click. 300 "logo": { # A smaller image, for the advertiser logo. 301 "url": "A String", 302 "width": 42, 303 "height": 42, 304 }, 305 "appIcon": { # The app icon, for app download ads. 306 "url": "A String", 307 "width": 42, 308 "height": 42, 309 }, 310 "impressionTrackingUrl": [ # The URLs are called when the impression is rendered. 311 "A String", 312 ], 313 "price": "A String", # The price of the promoted app including the currency info. 314 "clickTrackingUrl": "A String", # The URL to use for click tracking. 315 "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad. 316 }, 317 "version": 42, # The version for this creative. Read-only. This field should not be set in requests. 318 "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). 319 "vendorType": [ # 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. 320 42, 321 ], 322 "sensitiveCategories": [ # Detected sensitive categories, if any. Each category is represented by an integer as defined in ad-sensitive-categories.txt. Read-only. This field should not be set in requests. 323 42, 324 ], 325 "productCategories": [ # Detected product categories, if any. Each category is represented by an integer as defined in ad-product-categories.txt. Read-only. This field should not be set in requests. 326 42, 327 ], 328 "agencyId": "A String", # The agency id for this creative. 329 "detectedDomains": [ # Detected domains for this creative. Read-only. This field should not be set in requests. 330 "A String", 331 ], 332 "dealsStatus": "A String", # Top-level deals status. Read-only. This field should not be set in requests. If disapproved, an entry for auctionType=DIRECT_DEALS (or ALL) in servingRestrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case it may be preferable to read from servingRestrictions directly. 333 "advertiserId": [ # Detected advertiser id, if any. Read-only. This field should not be set in requests. 334 "A String", 335 ], 336 "kind": "adexchangebuyer#creative", # Resource type. 337 "servingRestrictions": [ # The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction). Read-only. This field should not be set in requests. See the examples in the Creatives guide for more details. 338 { 339 "contexts": [ # All known contexts/restrictions. 340 { 341 "platform": [ # Only set when contextType=PLATFORM. Represents the platforms this restriction applies to. 342 "A String", 343 ], 344 "contextType": "A String", # The type of context (e.g., location, platform, auction type, SSL-ness). 345 "auctionType": [ # Only set when contextType=AUCTION_TYPE. Represents the auction types this restriction applies to. 346 "A String", 347 ], 348 "geoCriteriaId": [ # Only set when contextType=LOCATION. Represents the geo criterias this restriction applies to. Impressions are considered to match a context if either the user location or publisher location matches a given geoCriteriaId. 349 42, 350 ], 351 }, 352 ], 353 "disapprovalReasons": [ # The reasons for disapproval within this restriction, if any. Note that not all disapproval reasons may be categorized, so it is possible for the creative to have a status of DISAPPROVED or CONDITIONALLY_APPROVED with an empty list for disapproval_reasons. In this case, please reach out to your TAM to help debug the issue. 354 { 355 "reason": "A String", # The categorized reason for disapproval. 356 "details": [ # Additional details about the reason for disapproval. 357 "A String", 358 ], 359 }, 360 ], 361 "reason": "A String", # Why the creative is ineligible to serve in this context (e.g., it has been explicitly disapproved or is pending review). 362 }, 363 ], 364 "restrictedCategories": [ # 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. 365 42, 366 ], 367 "corrections": [ # Shows any corrections that were applied to this creative. Read-only. This field should not be set in requests. 368 { 369 "contexts": [ # All known serving contexts containing serving status information. 370 { 371 "platform": [ # Only set when contextType=PLATFORM. Represents the platforms this correction applies to. 372 "A String", 373 ], 374 "contextType": "A String", # The type of context (e.g., location, platform, auction type, SSL-ness). 375 "auctionType": [ # Only set when contextType=AUCTION_TYPE. Represents the auction types this correction applies to. 376 "A String", 377 ], 378 "geoCriteriaId": [ # Only set when contextType=LOCATION. Represents the geo criterias this correction applies to. 379 42, 380 ], 381 }, 382 ], 383 "reason": "A String", # The type of correction that was applied to the creative. 384 "details": [ # Additional details about the correction. 385 "A String", 386 ], 387 }, 388 ], 389 "filteringReasons": { # The filtering reasons for the creative. Read-only. This field should not be set in requests. 390 "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. 391 "reasons": [ # The filtering reasons. 392 { 393 "filteringCount": "A String", # The number of times the creative was filtered for the status. The count is aggregated across all publishers on the exchange. 394 "filteringStatus": 42, # The filtering status code as defined in creative-status-codes.txt. 395 }, 396 ], 397 }, 398 } 399 400 401 Returns: 402 An object of the form: 403 404 { # A creative and its classification data. 405 "attribute": [ # 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. 406 42, 407 ], 408 "height": 42, # Ad height. 409 "advertiserName": "A String", # The name of the company being advertised in the creative. The value provided must exist in the advertisers.txt file. 410 "HTMLSnippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. If set, videoURL should not be set. 411 "openAuctionStatus": "A String", # Top-level open auction status. Read-only. This field should not be set in requests. If disapproved, an entry for auctionType=OPEN_AUCTION (or ALL) in servingRestrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case it may be preferable to read from ServingRestrictions directly. 412 "buyerCreativeId": "A String", # A buyer-specific id identifying the creative in this ad. 413 "adChoicesDestinationUrl": "A String", # The link to the Ad Preferences page. This is only supported for native ads. 414 "impressionTrackingUrl": [ # The set of urls to be called to record an impression. 415 "A String", 416 ], 417 "accountId": 42, # Account id. 418 "videoURL": "A 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. 419 "clickThroughUrl": [ # The set of destination urls for the snippet. 420 "A String", 421 ], 422 "languages": [ # Detected languages for this creative. Read-only. This field should not be set in requests. 423 "A String", 424 ], 425 "width": 42, # Ad width. 426 "nativeAd": { # If nativeAd is set, HTMLSnippet and the videoURL outside of nativeAd should not be set. (The videoURL inside nativeAd can be set.) 427 "body": "A String", # A long description of the ad. 428 "advertiser": "A String", 429 "store": "A String", # The URL to the app store to purchase/download the promoted app. 430 "videoURL": "A String", # The URL of the XML VAST for a native ad. Note this is a separate field from resource.video_url. 431 "headline": "A String", # A short title for the ad. 432 "image": { # A large image. 433 "url": "A String", 434 "width": 42, 435 "height": 42, 436 }, 437 "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5]. 438 "callToAction": "A String", # A label for the button that the user is supposed to click. 439 "logo": { # A smaller image, for the advertiser logo. 440 "url": "A String", 441 "width": 42, 442 "height": 42, 443 }, 444 "appIcon": { # The app icon, for app download ads. 445 "url": "A String", 446 "width": 42, 447 "height": 42, 448 }, 449 "impressionTrackingUrl": [ # The URLs are called when the impression is rendered. 450 "A String", 451 ], 452 "price": "A String", # The price of the promoted app including the currency info. 453 "clickTrackingUrl": "A String", # The URL to use for click tracking. 454 "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad. 455 }, 456 "version": 42, # The version for this creative. Read-only. This field should not be set in requests. 457 "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). 458 "vendorType": [ # 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. 459 42, 460 ], 461 "sensitiveCategories": [ # Detected sensitive categories, if any. Each category is represented by an integer as defined in ad-sensitive-categories.txt. Read-only. This field should not be set in requests. 462 42, 463 ], 464 "productCategories": [ # Detected product categories, if any. Each category is represented by an integer as defined in ad-product-categories.txt. Read-only. This field should not be set in requests. 465 42, 466 ], 467 "agencyId": "A String", # The agency id for this creative. 468 "detectedDomains": [ # Detected domains for this creative. Read-only. This field should not be set in requests. 469 "A String", 470 ], 471 "dealsStatus": "A String", # Top-level deals status. Read-only. This field should not be set in requests. If disapproved, an entry for auctionType=DIRECT_DEALS (or ALL) in servingRestrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case it may be preferable to read from servingRestrictions directly. 472 "advertiserId": [ # Detected advertiser id, if any. Read-only. This field should not be set in requests. 473 "A String", 474 ], 475 "kind": "adexchangebuyer#creative", # Resource type. 476 "servingRestrictions": [ # The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction). Read-only. This field should not be set in requests. See the examples in the Creatives guide for more details. 477 { 478 "contexts": [ # All known contexts/restrictions. 479 { 480 "platform": [ # Only set when contextType=PLATFORM. Represents the platforms this restriction applies to. 481 "A String", 482 ], 483 "contextType": "A String", # The type of context (e.g., location, platform, auction type, SSL-ness). 484 "auctionType": [ # Only set when contextType=AUCTION_TYPE. Represents the auction types this restriction applies to. 485 "A String", 486 ], 487 "geoCriteriaId": [ # Only set when contextType=LOCATION. Represents the geo criterias this restriction applies to. Impressions are considered to match a context if either the user location or publisher location matches a given geoCriteriaId. 488 42, 489 ], 490 }, 491 ], 492 "disapprovalReasons": [ # The reasons for disapproval within this restriction, if any. Note that not all disapproval reasons may be categorized, so it is possible for the creative to have a status of DISAPPROVED or CONDITIONALLY_APPROVED with an empty list for disapproval_reasons. In this case, please reach out to your TAM to help debug the issue. 493 { 494 "reason": "A String", # The categorized reason for disapproval. 495 "details": [ # Additional details about the reason for disapproval. 496 "A String", 497 ], 498 }, 499 ], 500 "reason": "A String", # Why the creative is ineligible to serve in this context (e.g., it has been explicitly disapproved or is pending review). 501 }, 502 ], 503 "restrictedCategories": [ # 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. 504 42, 505 ], 506 "corrections": [ # Shows any corrections that were applied to this creative. Read-only. This field should not be set in requests. 507 { 508 "contexts": [ # All known serving contexts containing serving status information. 509 { 510 "platform": [ # Only set when contextType=PLATFORM. Represents the platforms this correction applies to. 511 "A String", 512 ], 513 "contextType": "A String", # The type of context (e.g., location, platform, auction type, SSL-ness). 514 "auctionType": [ # Only set when contextType=AUCTION_TYPE. Represents the auction types this correction applies to. 515 "A String", 516 ], 517 "geoCriteriaId": [ # Only set when contextType=LOCATION. Represents the geo criterias this correction applies to. 518 42, 519 ], 520 }, 521 ], 522 "reason": "A String", # The type of correction that was applied to the creative. 523 "details": [ # Additional details about the correction. 524 "A String", 525 ], 526 }, 527 ], 528 "filteringReasons": { # The filtering reasons for the creative. Read-only. This field should not be set in requests. 529 "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. 530 "reasons": [ # The filtering reasons. 531 { 532 "filteringCount": "A String", # The number of times the creative was filtered for the status. The count is aggregated across all publishers on the exchange. 533 "filteringStatus": 42, # The filtering status code as defined in creative-status-codes.txt. 534 }, 535 ], 536 }, 537 }</pre> 538 </div> 539 540 <div class="method"> 541 <code class="details" id="list">list(dealsStatusFilter=None, openAuctionStatusFilter=None, pageToken=None, maxResults=None, buyerCreativeId=None, accountId=None)</code> 542 <pre>Retrieves a list of the authenticated user's active creatives. A creative will be available 30-40 minutes after submission. 543 544 Args: 545 dealsStatusFilter: string, When specified, only creatives having the given deals status are returned. 546 Allowed values 547 approved - Creatives which have been approved for serving on deals. 548 conditionally_approved - Creatives which have been conditionally approved for serving on deals. 549 disapproved - Creatives which have been disapproved for serving on deals. 550 not_checked - Creatives whose deals status is not yet checked. 551 openAuctionStatusFilter: string, When specified, only creatives having the given open auction status are returned. 552 Allowed values 553 approved - Creatives which have been approved for serving on the open auction. 554 conditionally_approved - Creatives which have been conditionally approved for serving on the open auction. 555 disapproved - Creatives which have been disapproved for serving on the open auction. 556 not_checked - Creatives whose open auction status is not yet checked. 557 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. 558 maxResults: integer, Maximum number of entries returned on one result page. If not set, the default is 100. Optional. 559 buyerCreativeId: string, When specified, only creatives for the given buyer creative ids are returned. (repeated) 560 accountId: integer, When specified, only creatives for the given account ids are returned. (repeated) 561 562 Returns: 563 An object of the form: 564 565 { # 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. 566 "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. 567 "items": [ # A list of creatives. 568 { # A creative and its classification data. 569 "attribute": [ # 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. 570 42, 571 ], 572 "height": 42, # Ad height. 573 "advertiserName": "A String", # The name of the company being advertised in the creative. The value provided must exist in the advertisers.txt file. 574 "HTMLSnippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. If set, videoURL should not be set. 575 "openAuctionStatus": "A String", # Top-level open auction status. Read-only. This field should not be set in requests. If disapproved, an entry for auctionType=OPEN_AUCTION (or ALL) in servingRestrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case it may be preferable to read from ServingRestrictions directly. 576 "buyerCreativeId": "A String", # A buyer-specific id identifying the creative in this ad. 577 "adChoicesDestinationUrl": "A String", # The link to the Ad Preferences page. This is only supported for native ads. 578 "impressionTrackingUrl": [ # The set of urls to be called to record an impression. 579 "A String", 580 ], 581 "accountId": 42, # Account id. 582 "videoURL": "A 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. 583 "clickThroughUrl": [ # The set of destination urls for the snippet. 584 "A String", 585 ], 586 "languages": [ # Detected languages for this creative. Read-only. This field should not be set in requests. 587 "A String", 588 ], 589 "width": 42, # Ad width. 590 "nativeAd": { # If nativeAd is set, HTMLSnippet and the videoURL outside of nativeAd should not be set. (The videoURL inside nativeAd can be set.) 591 "body": "A String", # A long description of the ad. 592 "advertiser": "A String", 593 "store": "A String", # The URL to the app store to purchase/download the promoted app. 594 "videoURL": "A String", # The URL of the XML VAST for a native ad. Note this is a separate field from resource.video_url. 595 "headline": "A String", # A short title for the ad. 596 "image": { # A large image. 597 "url": "A String", 598 "width": 42, 599 "height": 42, 600 }, 601 "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5]. 602 "callToAction": "A String", # A label for the button that the user is supposed to click. 603 "logo": { # A smaller image, for the advertiser logo. 604 "url": "A String", 605 "width": 42, 606 "height": 42, 607 }, 608 "appIcon": { # The app icon, for app download ads. 609 "url": "A String", 610 "width": 42, 611 "height": 42, 612 }, 613 "impressionTrackingUrl": [ # The URLs are called when the impression is rendered. 614 "A String", 615 ], 616 "price": "A String", # The price of the promoted app including the currency info. 617 "clickTrackingUrl": "A String", # The URL to use for click tracking. 618 "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad. 619 }, 620 "version": 42, # The version for this creative. Read-only. This field should not be set in requests. 621 "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). 622 "vendorType": [ # 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. 623 42, 624 ], 625 "sensitiveCategories": [ # Detected sensitive categories, if any. Each category is represented by an integer as defined in ad-sensitive-categories.txt. Read-only. This field should not be set in requests. 626 42, 627 ], 628 "productCategories": [ # Detected product categories, if any. Each category is represented by an integer as defined in ad-product-categories.txt. Read-only. This field should not be set in requests. 629 42, 630 ], 631 "agencyId": "A String", # The agency id for this creative. 632 "detectedDomains": [ # Detected domains for this creative. Read-only. This field should not be set in requests. 633 "A String", 634 ], 635 "dealsStatus": "A String", # Top-level deals status. Read-only. This field should not be set in requests. If disapproved, an entry for auctionType=DIRECT_DEALS (or ALL) in servingRestrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case it may be preferable to read from servingRestrictions directly. 636 "advertiserId": [ # Detected advertiser id, if any. Read-only. This field should not be set in requests. 637 "A String", 638 ], 639 "kind": "adexchangebuyer#creative", # Resource type. 640 "servingRestrictions": [ # The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction). Read-only. This field should not be set in requests. See the examples in the Creatives guide for more details. 641 { 642 "contexts": [ # All known contexts/restrictions. 643 { 644 "platform": [ # Only set when contextType=PLATFORM. Represents the platforms this restriction applies to. 645 "A String", 646 ], 647 "contextType": "A String", # The type of context (e.g., location, platform, auction type, SSL-ness). 648 "auctionType": [ # Only set when contextType=AUCTION_TYPE. Represents the auction types this restriction applies to. 649 "A String", 650 ], 651 "geoCriteriaId": [ # Only set when contextType=LOCATION. Represents the geo criterias this restriction applies to. Impressions are considered to match a context if either the user location or publisher location matches a given geoCriteriaId. 652 42, 653 ], 654 }, 655 ], 656 "disapprovalReasons": [ # The reasons for disapproval within this restriction, if any. Note that not all disapproval reasons may be categorized, so it is possible for the creative to have a status of DISAPPROVED or CONDITIONALLY_APPROVED with an empty list for disapproval_reasons. In this case, please reach out to your TAM to help debug the issue. 657 { 658 "reason": "A String", # The categorized reason for disapproval. 659 "details": [ # Additional details about the reason for disapproval. 660 "A String", 661 ], 662 }, 663 ], 664 "reason": "A String", # Why the creative is ineligible to serve in this context (e.g., it has been explicitly disapproved or is pending review). 665 }, 666 ], 667 "restrictedCategories": [ # 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. 668 42, 669 ], 670 "corrections": [ # Shows any corrections that were applied to this creative. Read-only. This field should not be set in requests. 671 { 672 "contexts": [ # All known serving contexts containing serving status information. 673 { 674 "platform": [ # Only set when contextType=PLATFORM. Represents the platforms this correction applies to. 675 "A String", 676 ], 677 "contextType": "A String", # The type of context (e.g., location, platform, auction type, SSL-ness). 678 "auctionType": [ # Only set when contextType=AUCTION_TYPE. Represents the auction types this correction applies to. 679 "A String", 680 ], 681 "geoCriteriaId": [ # Only set when contextType=LOCATION. Represents the geo criterias this correction applies to. 682 42, 683 ], 684 }, 685 ], 686 "reason": "A String", # The type of correction that was applied to the creative. 687 "details": [ # Additional details about the correction. 688 "A String", 689 ], 690 }, 691 ], 692 "filteringReasons": { # The filtering reasons for the creative. Read-only. This field should not be set in requests. 693 "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. 694 "reasons": [ # The filtering reasons. 695 { 696 "filteringCount": "A String", # The number of times the creative was filtered for the status. The count is aggregated across all publishers on the exchange. 697 "filteringStatus": 42, # The filtering status code as defined in creative-status-codes.txt. 698 }, 699 ], 700 }, 701 }, 702 ], 703 "kind": "adexchangebuyer#creativesList", # Resource type. 704 }</pre> 705 </div> 706 707 <div class="method"> 708 <code class="details" id="listDeals">listDeals(accountId, buyerCreativeId)</code> 709 <pre>Lists the external deal ids associated with the creative. 710 711 Args: 712 accountId: integer, The id for the account that will serve this creative. (required) 713 buyerCreativeId: string, The buyer-specific id for this creative. (required) 714 715 Returns: 716 An object of the form: 717 718 { # The external deal ids associated with a creative. 719 "dealStatuses": [ # A list of external deal ids and ARC approval status. 720 { 721 "webPropertyId": 42, # Publisher ID. 722 "dealId": "A String", # External deal ID. 723 "arcStatus": "A String", # ARC approval status. 724 }, 725 ], 726 "kind": "adexchangebuyer#creativeDealIds", # Resource type. 727 }</pre> 728 </div> 729 730 <div class="method"> 731 <code class="details" id="list_next">list_next(previous_request, previous_response)</code> 732 <pre>Retrieves the next page of results. 733 734 Args: 735 previous_request: The request for the previous page. (required) 736 previous_response: The response from the request for the previous page. (required) 737 738 Returns: 739 A request object that you can call 'execute()' on to request the next 740 page. Returns None if there are no more items in the collection. 741 </pre> 742 </div> 743 744 <div class="method"> 745 <code class="details" id="removeDeal">removeDeal(accountId, buyerCreativeId, dealId)</code> 746 <pre>Remove a deal id associated with the creative. 747 748 Args: 749 accountId: integer, The id for the account that will serve this creative. (required) 750 buyerCreativeId: string, The buyer-specific id for this creative. (required) 751 dealId: string, The id of the deal id to disassociate with this creative. (required) 752 </pre> 753 </div> 754 755 </body></html>
