| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 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="adexchangebuyer2_v2beta1.html">Ad Exchange Buyer API II</a> . <a href="adexchangebuyer2_v2beta1.accounts.html">accounts</a> . <a href="adexchangebuyer2_v2beta1.accounts.creatives.html">creatives</a></h1> |
| 76 | <h2>Instance Methods</h2> |
| 77 | <p class="toc_element"> |
| 78 | <code><a href="adexchangebuyer2_v2beta1.accounts.creatives.dealAssociations.html">dealAssociations()</a></code> |
| 79 | </p> |
| 80 | <p class="firstline">Returns the dealAssociations Resource.</p> |
| 81 | |
| 82 | <p class="toc_element"> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 83 | <code><a href="#close">close()</a></code></p> |
| 84 | <p class="firstline">Close httplib2 connections.</p> |
| 85 | <p class="toc_element"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 86 | <code><a href="#create">create(accountId, body=None, duplicateIdMode=None, x__xgafv=None)</a></code></p> |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 87 | <p class="firstline">Creates a creative.</p> |
| 88 | <p class="toc_element"> |
| 89 | <code><a href="#get">get(accountId, creativeId, x__xgafv=None)</a></code></p> |
| 90 | <p class="firstline">Gets a creative.</p> |
| 91 | <p class="toc_element"> |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 92 | <code><a href="#list">list(accountId, query=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p> |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 93 | <p class="firstline">Lists creatives.</p> |
| 94 | <p class="toc_element"> |
| 95 | <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> |
| 96 | <p class="firstline">Retrieves the next page of results.</p> |
| 97 | <p class="toc_element"> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 98 | <code><a href="#stopWatching">stopWatching(accountId, creativeId, body=None, x__xgafv=None)</a></code></p> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 99 | <p class="firstline">Stops watching a creative. Will stop push notifications being sent to the topics when the creative changes status.</p> |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 100 | <p class="toc_element"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 101 | <code><a href="#update">update(accountId, creativeId, body=None, x__xgafv=None)</a></code></p> |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 102 | <p class="firstline">Updates a creative.</p> |
| 103 | <p class="toc_element"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 104 | <code><a href="#watch">watch(accountId, creativeId, body=None, x__xgafv=None)</a></code></p> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 105 | <p class="firstline">Watches a creative. Will result in push notifications being sent to the topic when the creative changes status.</p> |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 106 | <h3>Method Details</h3> |
| 107 | <div class="method"> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 108 | <code class="details" id="close">close()</code> |
| 109 | <pre>Close httplib2 connections.</pre> |
| 110 | </div> |
| 111 | |
| 112 | <div class="method"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 113 | <code class="details" id="create">create(accountId, body=None, duplicateIdMode=None, x__xgafv=None)</code> |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 114 | <pre>Creates a creative. |
| 115 | |
| 116 | Args: |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 117 | accountId: string, The account that this creative belongs to. Can be used to filter the response of the creatives.list method. (required) |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 118 | body: object, The request body. |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 119 | The object takes the form of: |
| 120 | |
| 121 | { # A creative and its classification data. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 122 | "servingRestrictions": [ # Output only. 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). |
| 123 | { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction). |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 124 | "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review). |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 125 | "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead. |
| 126 | { # Output only. The reason and details for a disapproval. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 127 | "details": [ # Additional details about the reason for disapproval. |
| 128 | "A String", |
| 129 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 130 | "reason": "A String", # The categorized reason for disapproval. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 131 | }, |
| 132 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 133 | "contexts": [ # The contexts for the restriction. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 134 | { # The serving context for this restriction. |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 135 | "all": "A String", # Matches all contexts. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 136 | "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform. |
| 137 | "platforms": [ # The platforms this restriction applies to. |
| 138 | "A String", |
| 139 | ], |
| 140 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 141 | "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type. |
| 142 | "appTypes": [ # The app types this restriction applies to. |
| 143 | "A String", |
| 144 | ], |
| 145 | }, |
| 146 | "securityType": { # Output only. A security context. # Matches impressions for a particular security type. |
| 147 | "securities": [ # The security types in this context. |
| 148 | "A String", |
| 149 | ], |
| 150 | }, |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 151 | "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type. |
| 152 | "auctionTypes": [ # The auction types this restriction applies to. |
| 153 | "A String", |
| 154 | ], |
| 155 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 156 | "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location. |
| 157 | "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs. |
| 158 | 42, |
| 159 | ], |
| 160 | }, |
| 161 | }, |
| 162 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 163 | "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. |
| 164 | "details": [ # Additional details about the reason for disapproval. |
| 165 | "A String", |
| 166 | ], |
| 167 | "reason": "A String", # The categorized reason for disapproval. |
| 168 | }, |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 169 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 170 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 171 | "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page. |
| 172 | "version": 42, # Output only. The version of this creative. |
| 173 | "advertiserName": "A String", # The name of the company being advertised in the creative. |
| 174 | "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. |
| 175 | 42, |
| 176 | ], |
| 177 | "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API. |
| 178 | "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids. |
| 179 | 42, |
| 180 | ], |
| 181 | "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. |
| 182 | "A String", |
| 183 | ], |
| 184 | "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative. |
| 185 | "A String", |
| 186 | ], |
| 187 | "detectedDomains": [ # Output only. The detected domains for this creative. |
| 188 | "A String", |
| 189 | ], |
| 190 | "clickThroughUrls": [ # The set of destination URLs for the creative. |
| 191 | "A String", |
| 192 | ], |
| 193 | "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes. |
| 194 | "A String", |
| 195 | ], |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 196 | "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame] | 197 | "A String", |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 198 | ], |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 199 | "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any. |
| 200 | "A String", |
| 201 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 202 | "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 203 | "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers. |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 204 | "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 205 | "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 206 | "A String", |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 207 | ], |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 208 | }, |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 209 | "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method. |
| 210 | "native": { # Native content for a creative. # A native creative. |
| 211 | "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative. |
| 212 | "appIcon": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # The app icon, for app download ads. |
| 213 | "height": 42, # Image height in pixels. |
| 214 | "url": "A String", # The URL of the image. |
| 215 | "width": 42, # Image width in pixels. |
| 216 | }, |
| 217 | "videoUrl": "A String", # The URL to fetch a native video ad. |
| 218 | "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad. |
| 219 | "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app. |
| 220 | "priceDisplayText": "A String", # The price of the promoted app including currency info. |
| 221 | "logo": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A smaller image, for the advertiser's logo. |
| 222 | "height": 42, # Image height in pixels. |
| 223 | "url": "A String", # The URL of the image. |
| 224 | "width": 42, # Image width in pixels. |
| 225 | }, |
| 226 | "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image. |
| 227 | "height": 42, # Image height in pixels. |
| 228 | "url": "A String", # The URL of the image. |
| 229 | "width": 42, # Image width in pixels. |
| 230 | }, |
| 231 | "headline": "A String", # A short title for the ad. |
| 232 | "body": "A String", # A long description of the ad. |
| 233 | "clickTrackingUrl": "A String", # The URL to use for click tracking. |
| 234 | "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5]. |
| 235 | "callToAction": "A String", # A label for the button that the user is supposed to click. |
| 236 | }, |
| 237 | "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method. |
| 238 | "video": { # Video content for a creative. # A video creative. |
| 239 | "videoUrl": "A String", # The URL to fetch a video ad. |
| 240 | "videoVastXml": "A String", # The contents of a VAST document for a video ad. This document should conform to the VAST 2.0 or 3.0 standard. |
| 241 | }, |
| 242 | "corrections": [ # Output only. Shows any corrections that were applied to this creative. |
| 243 | { # Output only. Shows any corrections that were applied to this creative. |
| 244 | "details": [ # Additional details about what was corrected. |
| 245 | "A String", |
| 246 | ], |
| 247 | "type": "A String", # The type of correction that was applied to the creative. |
| 248 | "contexts": [ # The contexts for the correction. |
| 249 | { # The serving context for this restriction. |
| 250 | "all": "A String", # Matches all contexts. |
| 251 | "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform. |
| 252 | "platforms": [ # The platforms this restriction applies to. |
| 253 | "A String", |
| 254 | ], |
| 255 | }, |
| 256 | "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type. |
| 257 | "appTypes": [ # The app types this restriction applies to. |
| 258 | "A String", |
| 259 | ], |
| 260 | }, |
| 261 | "securityType": { # Output only. A security context. # Matches impressions for a particular security type. |
| 262 | "securities": [ # The security types in this context. |
| 263 | "A String", |
| 264 | ], |
| 265 | }, |
| 266 | "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type. |
| 267 | "auctionTypes": [ # The auction types this restriction applies to. |
| 268 | "A String", |
| 269 | ], |
| 270 | }, |
| 271 | "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location. |
| 272 | "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs. |
| 273 | 42, |
| 274 | ], |
| 275 | }, |
| 276 | }, |
| 277 | ], |
| 278 | }, |
| 279 | ], |
| 280 | "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 281 | "impressionTrackingUrls": [ # The set of URLs to be called to record an impression. |
| 282 | "A String", |
| 283 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 284 | "html": { # HTML content for a creative. # An HTML creative. |
| 285 | "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. |
| 286 | "height": 42, # The height of the HTML snippet in pixels. |
| 287 | "width": 42, # The width of the HTML snippet in pixels. |
| 288 | }, |
| 289 | "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 290 | 42, |
| 291 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 292 | "agencyId": "A String", # The agency ID for this creative. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 293 | } |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 294 | |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 295 | duplicateIdMode: string, Indicates if multiple creatives can share an ID or not. Default is NO_DUPLICATES (one ID per creative). |
| 296 | Allowed values |
| 297 | NO_DUPLICATES - Recommended. This means that an ID will be unique to a single creative. Multiple creatives will not share an ID. |
| 298 | FORCE_ENABLE_DUPLICATE_IDS - Not recommended. Using this option will allow multiple creatives to share the same ID. Get and Update requests will not be possible for any ID that has more than one creative associated. (List will still function.) This is only intended for backwards compatibility in cases where a single ID is already shared by multiple creatives from previous APIs. |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 299 | x__xgafv: string, V1 error format. |
| 300 | Allowed values |
| 301 | 1 - v1 error format |
| 302 | 2 - v2 error format |
| 303 | |
| 304 | Returns: |
| 305 | An object of the form: |
| 306 | |
| 307 | { # A creative and its classification data. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 308 | "servingRestrictions": [ # Output only. 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). |
| 309 | { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction). |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 310 | "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review). |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 311 | "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead. |
| 312 | { # Output only. The reason and details for a disapproval. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 313 | "details": [ # Additional details about the reason for disapproval. |
| 314 | "A String", |
| 315 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 316 | "reason": "A String", # The categorized reason for disapproval. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 317 | }, |
| 318 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 319 | "contexts": [ # The contexts for the restriction. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 320 | { # The serving context for this restriction. |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 321 | "all": "A String", # Matches all contexts. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 322 | "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform. |
| 323 | "platforms": [ # The platforms this restriction applies to. |
| 324 | "A String", |
| 325 | ], |
| 326 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 327 | "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type. |
| 328 | "appTypes": [ # The app types this restriction applies to. |
| 329 | "A String", |
| 330 | ], |
| 331 | }, |
| 332 | "securityType": { # Output only. A security context. # Matches impressions for a particular security type. |
| 333 | "securities": [ # The security types in this context. |
| 334 | "A String", |
| 335 | ], |
| 336 | }, |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 337 | "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type. |
| 338 | "auctionTypes": [ # The auction types this restriction applies to. |
| 339 | "A String", |
| 340 | ], |
| 341 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 342 | "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location. |
| 343 | "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs. |
| 344 | 42, |
| 345 | ], |
| 346 | }, |
| 347 | }, |
| 348 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 349 | "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. |
| 350 | "details": [ # Additional details about the reason for disapproval. |
| 351 | "A String", |
| 352 | ], |
| 353 | "reason": "A String", # The categorized reason for disapproval. |
| 354 | }, |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 355 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 356 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 357 | "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page. |
| 358 | "version": 42, # Output only. The version of this creative. |
| 359 | "advertiserName": "A String", # The name of the company being advertised in the creative. |
| 360 | "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. |
| 361 | 42, |
| 362 | ], |
| 363 | "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API. |
| 364 | "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids. |
| 365 | 42, |
| 366 | ], |
| 367 | "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. |
| 368 | "A String", |
| 369 | ], |
| 370 | "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative. |
| 371 | "A String", |
| 372 | ], |
| 373 | "detectedDomains": [ # Output only. The detected domains for this creative. |
| 374 | "A String", |
| 375 | ], |
| 376 | "clickThroughUrls": [ # The set of destination URLs for the creative. |
| 377 | "A String", |
| 378 | ], |
| 379 | "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes. |
| 380 | "A String", |
| 381 | ], |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 382 | "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame] | 383 | "A String", |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 384 | ], |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 385 | "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any. |
| 386 | "A String", |
| 387 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 388 | "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 389 | "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers. |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 390 | "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 391 | "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 392 | "A String", |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 393 | ], |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 394 | }, |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 395 | "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method. |
| 396 | "native": { # Native content for a creative. # A native creative. |
| 397 | "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative. |
| 398 | "appIcon": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # The app icon, for app download ads. |
| 399 | "height": 42, # Image height in pixels. |
| 400 | "url": "A String", # The URL of the image. |
| 401 | "width": 42, # Image width in pixels. |
| 402 | }, |
| 403 | "videoUrl": "A String", # The URL to fetch a native video ad. |
| 404 | "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad. |
| 405 | "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app. |
| 406 | "priceDisplayText": "A String", # The price of the promoted app including currency info. |
| 407 | "logo": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A smaller image, for the advertiser's logo. |
| 408 | "height": 42, # Image height in pixels. |
| 409 | "url": "A String", # The URL of the image. |
| 410 | "width": 42, # Image width in pixels. |
| 411 | }, |
| 412 | "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image. |
| 413 | "height": 42, # Image height in pixels. |
| 414 | "url": "A String", # The URL of the image. |
| 415 | "width": 42, # Image width in pixels. |
| 416 | }, |
| 417 | "headline": "A String", # A short title for the ad. |
| 418 | "body": "A String", # A long description of the ad. |
| 419 | "clickTrackingUrl": "A String", # The URL to use for click tracking. |
| 420 | "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5]. |
| 421 | "callToAction": "A String", # A label for the button that the user is supposed to click. |
| 422 | }, |
| 423 | "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method. |
| 424 | "video": { # Video content for a creative. # A video creative. |
| 425 | "videoUrl": "A String", # The URL to fetch a video ad. |
| 426 | "videoVastXml": "A String", # The contents of a VAST document for a video ad. This document should conform to the VAST 2.0 or 3.0 standard. |
| 427 | }, |
| 428 | "corrections": [ # Output only. Shows any corrections that were applied to this creative. |
| 429 | { # Output only. Shows any corrections that were applied to this creative. |
| 430 | "details": [ # Additional details about what was corrected. |
| 431 | "A String", |
| 432 | ], |
| 433 | "type": "A String", # The type of correction that was applied to the creative. |
| 434 | "contexts": [ # The contexts for the correction. |
| 435 | { # The serving context for this restriction. |
| 436 | "all": "A String", # Matches all contexts. |
| 437 | "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform. |
| 438 | "platforms": [ # The platforms this restriction applies to. |
| 439 | "A String", |
| 440 | ], |
| 441 | }, |
| 442 | "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type. |
| 443 | "appTypes": [ # The app types this restriction applies to. |
| 444 | "A String", |
| 445 | ], |
| 446 | }, |
| 447 | "securityType": { # Output only. A security context. # Matches impressions for a particular security type. |
| 448 | "securities": [ # The security types in this context. |
| 449 | "A String", |
| 450 | ], |
| 451 | }, |
| 452 | "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type. |
| 453 | "auctionTypes": [ # The auction types this restriction applies to. |
| 454 | "A String", |
| 455 | ], |
| 456 | }, |
| 457 | "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location. |
| 458 | "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs. |
| 459 | 42, |
| 460 | ], |
| 461 | }, |
| 462 | }, |
| 463 | ], |
| 464 | }, |
| 465 | ], |
| 466 | "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 467 | "impressionTrackingUrls": [ # The set of URLs to be called to record an impression. |
| 468 | "A String", |
| 469 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 470 | "html": { # HTML content for a creative. # An HTML creative. |
| 471 | "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. |
| 472 | "height": 42, # The height of the HTML snippet in pixels. |
| 473 | "width": 42, # The width of the HTML snippet in pixels. |
| 474 | }, |
| 475 | "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 476 | 42, |
| 477 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 478 | "agencyId": "A String", # The agency ID for this creative. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 479 | }</pre> |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 480 | </div> |
| 481 | |
| 482 | <div class="method"> |
| 483 | <code class="details" id="get">get(accountId, creativeId, x__xgafv=None)</code> |
| 484 | <pre>Gets a creative. |
| 485 | |
| 486 | Args: |
| 487 | accountId: string, The account the creative belongs to. (required) |
| 488 | creativeId: string, The ID of the creative to retrieve. (required) |
| 489 | x__xgafv: string, V1 error format. |
| 490 | Allowed values |
| 491 | 1 - v1 error format |
| 492 | 2 - v2 error format |
| 493 | |
| 494 | Returns: |
| 495 | An object of the form: |
| 496 | |
| 497 | { # A creative and its classification data. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 498 | "servingRestrictions": [ # Output only. 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). |
| 499 | { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction). |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 500 | "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review). |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 501 | "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead. |
| 502 | { # Output only. The reason and details for a disapproval. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 503 | "details": [ # Additional details about the reason for disapproval. |
| 504 | "A String", |
| 505 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 506 | "reason": "A String", # The categorized reason for disapproval. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 507 | }, |
| 508 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 509 | "contexts": [ # The contexts for the restriction. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 510 | { # The serving context for this restriction. |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 511 | "all": "A String", # Matches all contexts. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 512 | "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform. |
| 513 | "platforms": [ # The platforms this restriction applies to. |
| 514 | "A String", |
| 515 | ], |
| 516 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 517 | "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type. |
| 518 | "appTypes": [ # The app types this restriction applies to. |
| 519 | "A String", |
| 520 | ], |
| 521 | }, |
| 522 | "securityType": { # Output only. A security context. # Matches impressions for a particular security type. |
| 523 | "securities": [ # The security types in this context. |
| 524 | "A String", |
| 525 | ], |
| 526 | }, |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 527 | "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type. |
| 528 | "auctionTypes": [ # The auction types this restriction applies to. |
| 529 | "A String", |
| 530 | ], |
| 531 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 532 | "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location. |
| 533 | "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs. |
| 534 | 42, |
| 535 | ], |
| 536 | }, |
| 537 | }, |
| 538 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 539 | "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. |
| 540 | "details": [ # Additional details about the reason for disapproval. |
| 541 | "A String", |
| 542 | ], |
| 543 | "reason": "A String", # The categorized reason for disapproval. |
| 544 | }, |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 545 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 546 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 547 | "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page. |
| 548 | "version": 42, # Output only. The version of this creative. |
| 549 | "advertiserName": "A String", # The name of the company being advertised in the creative. |
| 550 | "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. |
| 551 | 42, |
| 552 | ], |
| 553 | "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API. |
| 554 | "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids. |
| 555 | 42, |
| 556 | ], |
| 557 | "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. |
| 558 | "A String", |
| 559 | ], |
| 560 | "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative. |
| 561 | "A String", |
| 562 | ], |
| 563 | "detectedDomains": [ # Output only. The detected domains for this creative. |
| 564 | "A String", |
| 565 | ], |
| 566 | "clickThroughUrls": [ # The set of destination URLs for the creative. |
| 567 | "A String", |
| 568 | ], |
| 569 | "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes. |
| 570 | "A String", |
| 571 | ], |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 572 | "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame] | 573 | "A String", |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 574 | ], |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 575 | "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any. |
| 576 | "A String", |
| 577 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 578 | "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 579 | "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers. |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 580 | "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 581 | "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 582 | "A String", |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 583 | ], |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 584 | }, |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 585 | "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method. |
| 586 | "native": { # Native content for a creative. # A native creative. |
| 587 | "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative. |
| 588 | "appIcon": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # The app icon, for app download ads. |
| 589 | "height": 42, # Image height in pixels. |
| 590 | "url": "A String", # The URL of the image. |
| 591 | "width": 42, # Image width in pixels. |
| 592 | }, |
| 593 | "videoUrl": "A String", # The URL to fetch a native video ad. |
| 594 | "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad. |
| 595 | "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app. |
| 596 | "priceDisplayText": "A String", # The price of the promoted app including currency info. |
| 597 | "logo": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A smaller image, for the advertiser's logo. |
| 598 | "height": 42, # Image height in pixels. |
| 599 | "url": "A String", # The URL of the image. |
| 600 | "width": 42, # Image width in pixels. |
| 601 | }, |
| 602 | "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image. |
| 603 | "height": 42, # Image height in pixels. |
| 604 | "url": "A String", # The URL of the image. |
| 605 | "width": 42, # Image width in pixels. |
| 606 | }, |
| 607 | "headline": "A String", # A short title for the ad. |
| 608 | "body": "A String", # A long description of the ad. |
| 609 | "clickTrackingUrl": "A String", # The URL to use for click tracking. |
| 610 | "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5]. |
| 611 | "callToAction": "A String", # A label for the button that the user is supposed to click. |
| 612 | }, |
| 613 | "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method. |
| 614 | "video": { # Video content for a creative. # A video creative. |
| 615 | "videoUrl": "A String", # The URL to fetch a video ad. |
| 616 | "videoVastXml": "A String", # The contents of a VAST document for a video ad. This document should conform to the VAST 2.0 or 3.0 standard. |
| 617 | }, |
| 618 | "corrections": [ # Output only. Shows any corrections that were applied to this creative. |
| 619 | { # Output only. Shows any corrections that were applied to this creative. |
| 620 | "details": [ # Additional details about what was corrected. |
| 621 | "A String", |
| 622 | ], |
| 623 | "type": "A String", # The type of correction that was applied to the creative. |
| 624 | "contexts": [ # The contexts for the correction. |
| 625 | { # The serving context for this restriction. |
| 626 | "all": "A String", # Matches all contexts. |
| 627 | "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform. |
| 628 | "platforms": [ # The platforms this restriction applies to. |
| 629 | "A String", |
| 630 | ], |
| 631 | }, |
| 632 | "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type. |
| 633 | "appTypes": [ # The app types this restriction applies to. |
| 634 | "A String", |
| 635 | ], |
| 636 | }, |
| 637 | "securityType": { # Output only. A security context. # Matches impressions for a particular security type. |
| 638 | "securities": [ # The security types in this context. |
| 639 | "A String", |
| 640 | ], |
| 641 | }, |
| 642 | "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type. |
| 643 | "auctionTypes": [ # The auction types this restriction applies to. |
| 644 | "A String", |
| 645 | ], |
| 646 | }, |
| 647 | "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location. |
| 648 | "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs. |
| 649 | 42, |
| 650 | ], |
| 651 | }, |
| 652 | }, |
| 653 | ], |
| 654 | }, |
| 655 | ], |
| 656 | "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 657 | "impressionTrackingUrls": [ # The set of URLs to be called to record an impression. |
| 658 | "A String", |
| 659 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 660 | "html": { # HTML content for a creative. # An HTML creative. |
| 661 | "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. |
| 662 | "height": 42, # The height of the HTML snippet in pixels. |
| 663 | "width": 42, # The width of the HTML snippet in pixels. |
| 664 | }, |
| 665 | "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 666 | 42, |
| 667 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 668 | "agencyId": "A String", # The agency ID for this creative. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 669 | }</pre> |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 670 | </div> |
| 671 | |
| 672 | <div class="method"> |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 673 | <code class="details" id="list">list(accountId, query=None, pageSize=None, pageToken=None, x__xgafv=None)</code> |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 674 | <pre>Lists creatives. |
| 675 | |
| 676 | Args: |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 677 | accountId: string, The account to list the creatives from. Specify "-" to list all creatives the current user has access to. (required) |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 678 | query: string, An optional query string to filter creatives. If no filter is specified, all active creatives will be returned. Supported queries are: - accountId=*account_id_string* - creativeId=*creative_id_string* - dealsStatus: {approved, conditionally_approved, disapproved, not_checked} - openAuctionStatus: {approved, conditionally_approved, disapproved, not_checked} - attribute: {a numeric attribute from the list of attributes} - disapprovalReason: {a reason from DisapprovalReason} Example: 'accountId=12345 AND (dealsStatus:disapproved AND disapprovalReason:unacceptable_content) OR attribute:47' |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 679 | pageSize: integer, Requested page size. The server may return fewer creatives than requested (due to timeout constraint) even if more are available via another call. If unspecified, server will pick an appropriate default. Acceptable values are 1 to 1000, inclusive. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame] | 680 | pageToken: string, A token identifying a page of results the server should return. Typically, this is the value of ListCreativesResponse.next_page_token returned from the previous call to 'ListCreatives' method. |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 681 | x__xgafv: string, V1 error format. |
| 682 | Allowed values |
| 683 | 1 - v1 error format |
| 684 | 2 - v2 error format |
| 685 | |
| 686 | Returns: |
| 687 | An object of the form: |
| 688 | |
| 689 | { # A response for listing creatives. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 690 | "nextPageToken": "A String", # A token to retrieve the next page of results. Pass this value in the ListCreativesRequest.page_token field in the subsequent call to `ListCreatives` method to retrieve the next page of results. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 691 | "creatives": [ # The list of creatives. |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 692 | { # A creative and its classification data. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 693 | "servingRestrictions": [ # Output only. 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). |
| 694 | { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction). |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 695 | "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review). |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 696 | "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead. |
| 697 | { # Output only. The reason and details for a disapproval. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 698 | "details": [ # Additional details about the reason for disapproval. |
| 699 | "A String", |
| 700 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 701 | "reason": "A String", # The categorized reason for disapproval. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 702 | }, |
| 703 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 704 | "contexts": [ # The contexts for the restriction. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 705 | { # The serving context for this restriction. |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 706 | "all": "A String", # Matches all contexts. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 707 | "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform. |
| 708 | "platforms": [ # The platforms this restriction applies to. |
| 709 | "A String", |
| 710 | ], |
| 711 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 712 | "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type. |
| 713 | "appTypes": [ # The app types this restriction applies to. |
| 714 | "A String", |
| 715 | ], |
| 716 | }, |
| 717 | "securityType": { # Output only. A security context. # Matches impressions for a particular security type. |
| 718 | "securities": [ # The security types in this context. |
| 719 | "A String", |
| 720 | ], |
| 721 | }, |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 722 | "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type. |
| 723 | "auctionTypes": [ # The auction types this restriction applies to. |
| 724 | "A String", |
| 725 | ], |
| 726 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 727 | "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location. |
| 728 | "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs. |
| 729 | 42, |
| 730 | ], |
| 731 | }, |
| 732 | }, |
| 733 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 734 | "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. |
| 735 | "details": [ # Additional details about the reason for disapproval. |
| 736 | "A String", |
| 737 | ], |
| 738 | "reason": "A String", # The categorized reason for disapproval. |
| 739 | }, |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 740 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 741 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 742 | "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page. |
| 743 | "version": 42, # Output only. The version of this creative. |
| 744 | "advertiserName": "A String", # The name of the company being advertised in the creative. |
| 745 | "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. |
| 746 | 42, |
| 747 | ], |
| 748 | "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API. |
| 749 | "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids. |
| 750 | 42, |
| 751 | ], |
| 752 | "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. |
| 753 | "A String", |
| 754 | ], |
| 755 | "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative. |
| 756 | "A String", |
| 757 | ], |
| 758 | "detectedDomains": [ # Output only. The detected domains for this creative. |
| 759 | "A String", |
| 760 | ], |
| 761 | "clickThroughUrls": [ # The set of destination URLs for the creative. |
| 762 | "A String", |
| 763 | ], |
| 764 | "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes. |
| 765 | "A String", |
| 766 | ], |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 767 | "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame] | 768 | "A String", |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 769 | ], |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 770 | "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any. |
| 771 | "A String", |
| 772 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 773 | "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 774 | "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers. |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 775 | "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 776 | "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 777 | "A String", |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 778 | ], |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 779 | }, |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 780 | "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method. |
| 781 | "native": { # Native content for a creative. # A native creative. |
| 782 | "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative. |
| 783 | "appIcon": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # The app icon, for app download ads. |
| 784 | "height": 42, # Image height in pixels. |
| 785 | "url": "A String", # The URL of the image. |
| 786 | "width": 42, # Image width in pixels. |
| 787 | }, |
| 788 | "videoUrl": "A String", # The URL to fetch a native video ad. |
| 789 | "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad. |
| 790 | "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app. |
| 791 | "priceDisplayText": "A String", # The price of the promoted app including currency info. |
| 792 | "logo": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A smaller image, for the advertiser's logo. |
| 793 | "height": 42, # Image height in pixels. |
| 794 | "url": "A String", # The URL of the image. |
| 795 | "width": 42, # Image width in pixels. |
| 796 | }, |
| 797 | "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image. |
| 798 | "height": 42, # Image height in pixels. |
| 799 | "url": "A String", # The URL of the image. |
| 800 | "width": 42, # Image width in pixels. |
| 801 | }, |
| 802 | "headline": "A String", # A short title for the ad. |
| 803 | "body": "A String", # A long description of the ad. |
| 804 | "clickTrackingUrl": "A String", # The URL to use for click tracking. |
| 805 | "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5]. |
| 806 | "callToAction": "A String", # A label for the button that the user is supposed to click. |
| 807 | }, |
| 808 | "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method. |
| 809 | "video": { # Video content for a creative. # A video creative. |
| 810 | "videoUrl": "A String", # The URL to fetch a video ad. |
| 811 | "videoVastXml": "A String", # The contents of a VAST document for a video ad. This document should conform to the VAST 2.0 or 3.0 standard. |
| 812 | }, |
| 813 | "corrections": [ # Output only. Shows any corrections that were applied to this creative. |
| 814 | { # Output only. Shows any corrections that were applied to this creative. |
| 815 | "details": [ # Additional details about what was corrected. |
| 816 | "A String", |
| 817 | ], |
| 818 | "type": "A String", # The type of correction that was applied to the creative. |
| 819 | "contexts": [ # The contexts for the correction. |
| 820 | { # The serving context for this restriction. |
| 821 | "all": "A String", # Matches all contexts. |
| 822 | "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform. |
| 823 | "platforms": [ # The platforms this restriction applies to. |
| 824 | "A String", |
| 825 | ], |
| 826 | }, |
| 827 | "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type. |
| 828 | "appTypes": [ # The app types this restriction applies to. |
| 829 | "A String", |
| 830 | ], |
| 831 | }, |
| 832 | "securityType": { # Output only. A security context. # Matches impressions for a particular security type. |
| 833 | "securities": [ # The security types in this context. |
| 834 | "A String", |
| 835 | ], |
| 836 | }, |
| 837 | "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type. |
| 838 | "auctionTypes": [ # The auction types this restriction applies to. |
| 839 | "A String", |
| 840 | ], |
| 841 | }, |
| 842 | "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location. |
| 843 | "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs. |
| 844 | 42, |
| 845 | ], |
| 846 | }, |
| 847 | }, |
| 848 | ], |
| 849 | }, |
| 850 | ], |
| 851 | "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 852 | "impressionTrackingUrls": [ # The set of URLs to be called to record an impression. |
| 853 | "A String", |
| 854 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 855 | "html": { # HTML content for a creative. # An HTML creative. |
| 856 | "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. |
| 857 | "height": 42, # The height of the HTML snippet in pixels. |
| 858 | "width": 42, # The width of the HTML snippet in pixels. |
| 859 | }, |
| 860 | "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 861 | 42, |
| 862 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 863 | "agencyId": "A String", # The agency ID for this creative. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 864 | }, |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 865 | ], |
| 866 | }</pre> |
| 867 | </div> |
| 868 | |
| 869 | <div class="method"> |
| 870 | <code class="details" id="list_next">list_next(previous_request, previous_response)</code> |
| 871 | <pre>Retrieves the next page of results. |
| 872 | |
| 873 | Args: |
| 874 | previous_request: The request for the previous page. (required) |
| 875 | previous_response: The response from the request for the previous page. (required) |
| 876 | |
| 877 | Returns: |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 878 | A request object that you can call 'execute()' on to request the next |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 879 | page. Returns None if there are no more items in the collection. |
| 880 | </pre> |
| 881 | </div> |
| 882 | |
| 883 | <div class="method"> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 884 | <code class="details" id="stopWatching">stopWatching(accountId, creativeId, body=None, x__xgafv=None)</code> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 885 | <pre>Stops watching a creative. Will stop push notifications being sent to the topics when the creative changes status. |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 886 | |
| 887 | Args: |
| 888 | accountId: string, The account of the creative to stop notifications for. (required) |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 889 | creativeId: string, The creative ID of the creative to stop notifications for. Specify "-" to specify stopping account level notifications. (required) |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 890 | body: object, The request body. |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 891 | The object takes the form of: |
| 892 | |
| 893 | { # A request for stopping notifications for changes to creative Status. |
| 894 | } |
| 895 | |
| 896 | x__xgafv: string, V1 error format. |
| 897 | Allowed values |
| 898 | 1 - v1 error format |
| 899 | 2 - v2 error format |
| 900 | |
| 901 | Returns: |
| 902 | An object of the form: |
| 903 | |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 904 | { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`. |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 905 | }</pre> |
| 906 | </div> |
| 907 | |
| 908 | <div class="method"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 909 | <code class="details" id="update">update(accountId, creativeId, body=None, x__xgafv=None)</code> |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 910 | <pre>Updates a creative. |
| 911 | |
| 912 | Args: |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 913 | accountId: string, The account that this creative belongs to. Can be used to filter the response of the creatives.list method. (required) |
| 914 | creativeId: string, The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method. (required) |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 915 | body: object, The request body. |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 916 | The object takes the form of: |
| 917 | |
| 918 | { # A creative and its classification data. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 919 | "servingRestrictions": [ # Output only. 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). |
| 920 | { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction). |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 921 | "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review). |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 922 | "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead. |
| 923 | { # Output only. The reason and details for a disapproval. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 924 | "details": [ # Additional details about the reason for disapproval. |
| 925 | "A String", |
| 926 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 927 | "reason": "A String", # The categorized reason for disapproval. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 928 | }, |
| 929 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 930 | "contexts": [ # The contexts for the restriction. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 931 | { # The serving context for this restriction. |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 932 | "all": "A String", # Matches all contexts. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 933 | "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform. |
| 934 | "platforms": [ # The platforms this restriction applies to. |
| 935 | "A String", |
| 936 | ], |
| 937 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 938 | "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type. |
| 939 | "appTypes": [ # The app types this restriction applies to. |
| 940 | "A String", |
| 941 | ], |
| 942 | }, |
| 943 | "securityType": { # Output only. A security context. # Matches impressions for a particular security type. |
| 944 | "securities": [ # The security types in this context. |
| 945 | "A String", |
| 946 | ], |
| 947 | }, |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 948 | "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type. |
| 949 | "auctionTypes": [ # The auction types this restriction applies to. |
| 950 | "A String", |
| 951 | ], |
| 952 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 953 | "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location. |
| 954 | "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs. |
| 955 | 42, |
| 956 | ], |
| 957 | }, |
| 958 | }, |
| 959 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 960 | "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. |
| 961 | "details": [ # Additional details about the reason for disapproval. |
| 962 | "A String", |
| 963 | ], |
| 964 | "reason": "A String", # The categorized reason for disapproval. |
| 965 | }, |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 966 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 967 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 968 | "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page. |
| 969 | "version": 42, # Output only. The version of this creative. |
| 970 | "advertiserName": "A String", # The name of the company being advertised in the creative. |
| 971 | "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. |
| 972 | 42, |
| 973 | ], |
| 974 | "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API. |
| 975 | "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids. |
| 976 | 42, |
| 977 | ], |
| 978 | "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. |
| 979 | "A String", |
| 980 | ], |
| 981 | "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative. |
| 982 | "A String", |
| 983 | ], |
| 984 | "detectedDomains": [ # Output only. The detected domains for this creative. |
| 985 | "A String", |
| 986 | ], |
| 987 | "clickThroughUrls": [ # The set of destination URLs for the creative. |
| 988 | "A String", |
| 989 | ], |
| 990 | "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes. |
| 991 | "A String", |
| 992 | ], |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 993 | "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame] | 994 | "A String", |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 995 | ], |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 996 | "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any. |
| 997 | "A String", |
| 998 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 999 | "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1000 | "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers. |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 1001 | "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1002 | "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 1003 | "A String", |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1004 | ], |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 1005 | }, |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 1006 | "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method. |
| 1007 | "native": { # Native content for a creative. # A native creative. |
| 1008 | "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative. |
| 1009 | "appIcon": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # The app icon, for app download ads. |
| 1010 | "height": 42, # Image height in pixels. |
| 1011 | "url": "A String", # The URL of the image. |
| 1012 | "width": 42, # Image width in pixels. |
| 1013 | }, |
| 1014 | "videoUrl": "A String", # The URL to fetch a native video ad. |
| 1015 | "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad. |
| 1016 | "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app. |
| 1017 | "priceDisplayText": "A String", # The price of the promoted app including currency info. |
| 1018 | "logo": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A smaller image, for the advertiser's logo. |
| 1019 | "height": 42, # Image height in pixels. |
| 1020 | "url": "A String", # The URL of the image. |
| 1021 | "width": 42, # Image width in pixels. |
| 1022 | }, |
| 1023 | "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image. |
| 1024 | "height": 42, # Image height in pixels. |
| 1025 | "url": "A String", # The URL of the image. |
| 1026 | "width": 42, # Image width in pixels. |
| 1027 | }, |
| 1028 | "headline": "A String", # A short title for the ad. |
| 1029 | "body": "A String", # A long description of the ad. |
| 1030 | "clickTrackingUrl": "A String", # The URL to use for click tracking. |
| 1031 | "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5]. |
| 1032 | "callToAction": "A String", # A label for the button that the user is supposed to click. |
| 1033 | }, |
| 1034 | "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method. |
| 1035 | "video": { # Video content for a creative. # A video creative. |
| 1036 | "videoUrl": "A String", # The URL to fetch a video ad. |
| 1037 | "videoVastXml": "A String", # The contents of a VAST document for a video ad. This document should conform to the VAST 2.0 or 3.0 standard. |
| 1038 | }, |
| 1039 | "corrections": [ # Output only. Shows any corrections that were applied to this creative. |
| 1040 | { # Output only. Shows any corrections that were applied to this creative. |
| 1041 | "details": [ # Additional details about what was corrected. |
| 1042 | "A String", |
| 1043 | ], |
| 1044 | "type": "A String", # The type of correction that was applied to the creative. |
| 1045 | "contexts": [ # The contexts for the correction. |
| 1046 | { # The serving context for this restriction. |
| 1047 | "all": "A String", # Matches all contexts. |
| 1048 | "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform. |
| 1049 | "platforms": [ # The platforms this restriction applies to. |
| 1050 | "A String", |
| 1051 | ], |
| 1052 | }, |
| 1053 | "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type. |
| 1054 | "appTypes": [ # The app types this restriction applies to. |
| 1055 | "A String", |
| 1056 | ], |
| 1057 | }, |
| 1058 | "securityType": { # Output only. A security context. # Matches impressions for a particular security type. |
| 1059 | "securities": [ # The security types in this context. |
| 1060 | "A String", |
| 1061 | ], |
| 1062 | }, |
| 1063 | "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type. |
| 1064 | "auctionTypes": [ # The auction types this restriction applies to. |
| 1065 | "A String", |
| 1066 | ], |
| 1067 | }, |
| 1068 | "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location. |
| 1069 | "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs. |
| 1070 | 42, |
| 1071 | ], |
| 1072 | }, |
| 1073 | }, |
| 1074 | ], |
| 1075 | }, |
| 1076 | ], |
| 1077 | "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1078 | "impressionTrackingUrls": [ # The set of URLs to be called to record an impression. |
| 1079 | "A String", |
| 1080 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 1081 | "html": { # HTML content for a creative. # An HTML creative. |
| 1082 | "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. |
| 1083 | "height": 42, # The height of the HTML snippet in pixels. |
| 1084 | "width": 42, # The width of the HTML snippet in pixels. |
| 1085 | }, |
| 1086 | "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1087 | 42, |
| 1088 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 1089 | "agencyId": "A String", # The agency ID for this creative. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1090 | } |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 1091 | |
| 1092 | x__xgafv: string, V1 error format. |
| 1093 | Allowed values |
| 1094 | 1 - v1 error format |
| 1095 | 2 - v2 error format |
| 1096 | |
| 1097 | Returns: |
| 1098 | An object of the form: |
| 1099 | |
| 1100 | { # A creative and its classification data. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1101 | "servingRestrictions": [ # Output only. 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). |
| 1102 | { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction). |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 1103 | "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review). |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1104 | "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead. |
| 1105 | { # Output only. The reason and details for a disapproval. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1106 | "details": [ # Additional details about the reason for disapproval. |
| 1107 | "A String", |
| 1108 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 1109 | "reason": "A String", # The categorized reason for disapproval. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1110 | }, |
| 1111 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 1112 | "contexts": [ # The contexts for the restriction. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1113 | { # The serving context for this restriction. |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 1114 | "all": "A String", # Matches all contexts. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1115 | "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform. |
| 1116 | "platforms": [ # The platforms this restriction applies to. |
| 1117 | "A String", |
| 1118 | ], |
| 1119 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1120 | "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type. |
| 1121 | "appTypes": [ # The app types this restriction applies to. |
| 1122 | "A String", |
| 1123 | ], |
| 1124 | }, |
| 1125 | "securityType": { # Output only. A security context. # Matches impressions for a particular security type. |
| 1126 | "securities": [ # The security types in this context. |
| 1127 | "A String", |
| 1128 | ], |
| 1129 | }, |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 1130 | "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type. |
| 1131 | "auctionTypes": [ # The auction types this restriction applies to. |
| 1132 | "A String", |
| 1133 | ], |
| 1134 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1135 | "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location. |
| 1136 | "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs. |
| 1137 | 42, |
| 1138 | ], |
| 1139 | }, |
| 1140 | }, |
| 1141 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 1142 | "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. |
| 1143 | "details": [ # Additional details about the reason for disapproval. |
| 1144 | "A String", |
| 1145 | ], |
| 1146 | "reason": "A String", # The categorized reason for disapproval. |
| 1147 | }, |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 1148 | }, |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1149 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 1150 | "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page. |
| 1151 | "version": 42, # Output only. The version of this creative. |
| 1152 | "advertiserName": "A String", # The name of the company being advertised in the creative. |
| 1153 | "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. |
| 1154 | 42, |
| 1155 | ], |
| 1156 | "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API. |
| 1157 | "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids. |
| 1158 | 42, |
| 1159 | ], |
| 1160 | "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. |
| 1161 | "A String", |
| 1162 | ], |
| 1163 | "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative. |
| 1164 | "A String", |
| 1165 | ], |
| 1166 | "detectedDomains": [ # Output only. The detected domains for this creative. |
| 1167 | "A String", |
| 1168 | ], |
| 1169 | "clickThroughUrls": [ # The set of destination URLs for the creative. |
| 1170 | "A String", |
| 1171 | ], |
| 1172 | "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes. |
| 1173 | "A String", |
| 1174 | ], |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1175 | "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame] | 1176 | "A String", |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 1177 | ], |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1178 | "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any. |
| 1179 | "A String", |
| 1180 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 1181 | "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1182 | "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers. |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 1183 | "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1184 | "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 1185 | "A String", |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1186 | ], |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 1187 | }, |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 1188 | "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method. |
| 1189 | "native": { # Native content for a creative. # A native creative. |
| 1190 | "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative. |
| 1191 | "appIcon": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # The app icon, for app download ads. |
| 1192 | "height": 42, # Image height in pixels. |
| 1193 | "url": "A String", # The URL of the image. |
| 1194 | "width": 42, # Image width in pixels. |
| 1195 | }, |
| 1196 | "videoUrl": "A String", # The URL to fetch a native video ad. |
| 1197 | "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad. |
| 1198 | "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app. |
| 1199 | "priceDisplayText": "A String", # The price of the promoted app including currency info. |
| 1200 | "logo": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A smaller image, for the advertiser's logo. |
| 1201 | "height": 42, # Image height in pixels. |
| 1202 | "url": "A String", # The URL of the image. |
| 1203 | "width": 42, # Image width in pixels. |
| 1204 | }, |
| 1205 | "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image. |
| 1206 | "height": 42, # Image height in pixels. |
| 1207 | "url": "A String", # The URL of the image. |
| 1208 | "width": 42, # Image width in pixels. |
| 1209 | }, |
| 1210 | "headline": "A String", # A short title for the ad. |
| 1211 | "body": "A String", # A long description of the ad. |
| 1212 | "clickTrackingUrl": "A String", # The URL to use for click tracking. |
| 1213 | "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5]. |
| 1214 | "callToAction": "A String", # A label for the button that the user is supposed to click. |
| 1215 | }, |
| 1216 | "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method. |
| 1217 | "video": { # Video content for a creative. # A video creative. |
| 1218 | "videoUrl": "A String", # The URL to fetch a video ad. |
| 1219 | "videoVastXml": "A String", # The contents of a VAST document for a video ad. This document should conform to the VAST 2.0 or 3.0 standard. |
| 1220 | }, |
| 1221 | "corrections": [ # Output only. Shows any corrections that were applied to this creative. |
| 1222 | { # Output only. Shows any corrections that were applied to this creative. |
| 1223 | "details": [ # Additional details about what was corrected. |
| 1224 | "A String", |
| 1225 | ], |
| 1226 | "type": "A String", # The type of correction that was applied to the creative. |
| 1227 | "contexts": [ # The contexts for the correction. |
| 1228 | { # The serving context for this restriction. |
| 1229 | "all": "A String", # Matches all contexts. |
| 1230 | "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform. |
| 1231 | "platforms": [ # The platforms this restriction applies to. |
| 1232 | "A String", |
| 1233 | ], |
| 1234 | }, |
| 1235 | "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type. |
| 1236 | "appTypes": [ # The app types this restriction applies to. |
| 1237 | "A String", |
| 1238 | ], |
| 1239 | }, |
| 1240 | "securityType": { # Output only. A security context. # Matches impressions for a particular security type. |
| 1241 | "securities": [ # The security types in this context. |
| 1242 | "A String", |
| 1243 | ], |
| 1244 | }, |
| 1245 | "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type. |
| 1246 | "auctionTypes": [ # The auction types this restriction applies to. |
| 1247 | "A String", |
| 1248 | ], |
| 1249 | }, |
| 1250 | "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location. |
| 1251 | "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs. |
| 1252 | 42, |
| 1253 | ], |
| 1254 | }, |
| 1255 | }, |
| 1256 | ], |
| 1257 | }, |
| 1258 | ], |
| 1259 | "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1260 | "impressionTrackingUrls": [ # The set of URLs to be called to record an impression. |
| 1261 | "A String", |
| 1262 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 1263 | "html": { # HTML content for a creative. # An HTML creative. |
| 1264 | "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. |
| 1265 | "height": 42, # The height of the HTML snippet in pixels. |
| 1266 | "width": 42, # The width of the HTML snippet in pixels. |
| 1267 | }, |
| 1268 | "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1269 | 42, |
| 1270 | ], |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 1271 | "agencyId": "A String", # The agency ID for this creative. |
| Yoshi Automation Bot | 0d561ef | 2020-11-25 07:50:41 -0800 | [diff] [blame] | 1272 | }</pre> |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 1273 | </div> |
| 1274 | |
| 1275 | <div class="method"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 1276 | <code class="details" id="watch">watch(accountId, creativeId, body=None, x__xgafv=None)</code> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1277 | <pre>Watches a creative. Will result in push notifications being sent to the topic when the creative changes status. |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 1278 | |
| 1279 | Args: |
| 1280 | accountId: string, The account of the creative to watch. (required) |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1281 | creativeId: string, The creative ID to watch for status changes. Specify "-" to watch all creatives under the above account. If both creative-level and account-level notifications are sent, only a single notification will be sent to the creative-level notification topic. (required) |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 1282 | body: object, The request body. |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 1283 | The object takes the form of: |
| 1284 | |
| 1285 | { # A request for watching changes to creative Status. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1286 | "topic": "A String", # The Pub/Sub topic to publish notifications to. This topic must already exist and must give permission to ad-exchange-buyside-reports@google.com to write to the topic. This should be the full resource name in "projects/{project_id}/topics/{topic_id}" format. |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 1287 | } |
| 1288 | |
| 1289 | x__xgafv: string, V1 error format. |
| 1290 | Allowed values |
| 1291 | 1 - v1 error format |
| 1292 | 2 - v2 error format |
| 1293 | |
| 1294 | Returns: |
| 1295 | An object of the form: |
| 1296 | |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1297 | { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`. |
| Sai Cheemalapati | c30d2b5 | 2017-03-13 12:12:03 -0400 | [diff] [blame] | 1298 | }</pre> |
| 1299 | </div> |
| 1300 | |
| 1301 | </body></html> |