| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [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="realtimebidding_v1.html">Real-time Bidding API</a> . <a href="realtimebidding_v1.buyers.html">buyers</a> . <a href="realtimebidding_v1.buyers.creatives.html">creatives</a></h1> |
| 76 | <h2>Instance Methods</h2> |
| 77 | <p class="toc_element"> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 78 | <code><a href="#close">close()</a></code></p> |
| 79 | <p class="firstline">Close httplib2 connections.</p> |
| 80 | <p class="toc_element"> |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 81 | <code><a href="#create">create(parent, body=None, x__xgafv=None)</a></code></p> |
| 82 | <p class="firstline">Creates a creative.</p> |
| 83 | <p class="toc_element"> |
| 84 | <code><a href="#get">get(name, view=None, x__xgafv=None)</a></code></p> |
| 85 | <p class="firstline">Gets a creative.</p> |
| 86 | <p class="toc_element"> |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 87 | <code><a href="#list">list(parent, filter=None, view=None, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p> |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 88 | <p class="firstline">Lists creatives.</p> |
| 89 | <p class="toc_element"> |
| 90 | <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> |
| 91 | <p class="firstline">Retrieves the next page of results.</p> |
| 92 | <p class="toc_element"> |
| 93 | <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p> |
| 94 | <p class="firstline">Updates a creative.</p> |
| 95 | <h3>Method Details</h3> |
| 96 | <div class="method"> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 97 | <code class="details" id="close">close()</code> |
| 98 | <pre>Close httplib2 connections.</pre> |
| 99 | </div> |
| 100 | |
| 101 | <div class="method"> |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 102 | <code class="details" id="create">create(parent, body=None, x__xgafv=None)</code> |
| 103 | <pre>Creates a creative. |
| 104 | |
| 105 | Args: |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 106 | parent: string, Required. The name of the parent buyer that the new creative belongs to that must follow the pattern `buyers/{buyerAccountId}`, where `{buyerAccountId}` represents the account ID of the buyer who owns a creative. For a bidder accessing creatives on behalf of a child seat buyer, `{buyerAccountId}` should represent the account ID of the child seat buyer. (required) |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 107 | body: object, The request body. |
| 108 | The object takes the form of: |
| 109 | |
| 110 | { # A creative and its classification data. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 111 | "declaredRestrictedCategories": [ # All declared restricted categories for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 112 | "A String", |
| 113 | ], |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 114 | "declaredAttributes": [ # All declared attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. If the `excluded_attribute` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto") contains one of the attributes that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 115 | "A String", |
| 116 | ], |
| 117 | "impressionTrackingUrls": [ # The set of URLs to be called to record an impression. |
| 118 | "A String", |
| 119 | ], |
| 120 | "html": { # HTML content for a creative. # An HTML creative. |
| 121 | "width": 42, # The width of the HTML snippet in pixels. Can be used to filter the response of the creatives.list method. |
| 122 | "height": 42, # The height of the HTML snippet in pixels. Can be used to filter the response of the creatives.list method. |
| 123 | "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. |
| 124 | }, |
| 125 | "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API. |
| 126 | "accountId": "A String", # Output only. ID of the buyer account that this creative is owned by. Can be used to filter the response of the creatives.list method with equality and inequality check. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 127 | "declaredVendorIds": [ # IDs for the declared ad technology vendors that may be used by this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. Can be used to filter the response of the creatives.list method. |
| 128 | 42, |
| 129 | ], |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 130 | "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page. This is only supported for native ads. |
| 131 | "advertiserName": "A String", # The name of the company being advertised in the creative. Can be used to filter the response of the creatives.list method. |
| 132 | "name": "A String", # Output only. Name of the creative. Follows the pattern `buyers/{buyer}/creatives/{creative}`, where `{buyer}` represents the account ID of the buyer who owns the creative, and `{creative}` is the buyer-specific creative ID that references this creative in the bid response. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 133 | "version": 42, # Output only. The version of this creative. Version for a new creative is 1 and it increments during subsequent creative updates. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 134 | "creativeServingDecision": { # Top level status and detected attributes of a creative. # Output only. Top level status and detected attributes of a creative (for example domain, language, advertiser, product category, etc.) that affect whether (status) and where (context) a creative will be allowed to serve. |
| 135 | "dealsPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding on Programmatic Guaranteed and Preferred Deals (outside of Russia and China). |
| 136 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 137 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 138 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 139 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 140 | { # Evidence associated with a policy topic entry. |
| 141 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 142 | "urls": [ # URLs of HTTP calls made by the creative. |
| 143 | "A String", |
| 144 | ], |
| 145 | }, |
| 146 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 147 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 148 | }, |
| 149 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 150 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 151 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 152 | "A String", |
| 153 | ], |
| 154 | }, |
| 155 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 156 | "crawlTime": "A String", # Approximate time of the crawl. |
| 157 | "reason": "A String", # Reason of destination not crawlable. |
| 158 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 159 | }, |
| 160 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 161 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 162 | "expandedUrl": "A String", # The full non-working URL. |
| 163 | "dnsError": "A String", # DNS lookup errors. |
| 164 | "redirectionError": "A String", # HTTP redirect chain error. |
| 165 | "platform": "A String", # Platform of the non-working URL. |
| 166 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 167 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 168 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 169 | }, |
| 170 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 171 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 172 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 173 | { # The URL-level breakdown for the download size. |
| 174 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 175 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 176 | }, |
| 177 | ], |
| 178 | }, |
| 179 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 180 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 181 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 182 | { # The number of HTTP calls made to the given domain. |
| 183 | "domain": "A String", # The domain name. |
| 184 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 185 | }, |
| 186 | ], |
| 187 | }, |
| 188 | }, |
| 189 | ], |
| 190 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 191 | }, |
| 192 | ], |
| 193 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 194 | }, |
| 195 | "platformPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding in Open Bidding (outside of Russia and China). For the list of platform policies, see: https://support.google.com/platformspolicy/answer/3013851. |
| 196 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 197 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 198 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 199 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 200 | { # Evidence associated with a policy topic entry. |
| 201 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 202 | "urls": [ # URLs of HTTP calls made by the creative. |
| 203 | "A String", |
| 204 | ], |
| 205 | }, |
| 206 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 207 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 208 | }, |
| 209 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 210 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 211 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 212 | "A String", |
| 213 | ], |
| 214 | }, |
| 215 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 216 | "crawlTime": "A String", # Approximate time of the crawl. |
| 217 | "reason": "A String", # Reason of destination not crawlable. |
| 218 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 219 | }, |
| 220 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 221 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 222 | "expandedUrl": "A String", # The full non-working URL. |
| 223 | "dnsError": "A String", # DNS lookup errors. |
| 224 | "redirectionError": "A String", # HTTP redirect chain error. |
| 225 | "platform": "A String", # Platform of the non-working URL. |
| 226 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 227 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 228 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 229 | }, |
| 230 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 231 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 232 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 233 | { # The URL-level breakdown for the download size. |
| 234 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 235 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 236 | }, |
| 237 | ], |
| 238 | }, |
| 239 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 240 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 241 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 242 | { # The number of HTTP calls made to the given domain. |
| 243 | "domain": "A String", # The domain name. |
| 244 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 245 | }, |
| 246 | ], |
| 247 | }, |
| 248 | }, |
| 249 | ], |
| 250 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 251 | }, |
| 252 | ], |
| 253 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 254 | }, |
| 255 | "chinaPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # The policy compliance of this creative in China. When approved or disapproved, this applies to both deals and open auction in China. When pending review, this creative is allowed to serve for deals but not for open auction. |
| 256 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 257 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 258 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 259 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 260 | { # Evidence associated with a policy topic entry. |
| 261 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 262 | "urls": [ # URLs of HTTP calls made by the creative. |
| 263 | "A String", |
| 264 | ], |
| 265 | }, |
| 266 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 267 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 268 | }, |
| 269 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 270 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 271 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 272 | "A String", |
| 273 | ], |
| 274 | }, |
| 275 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 276 | "crawlTime": "A String", # Approximate time of the crawl. |
| 277 | "reason": "A String", # Reason of destination not crawlable. |
| 278 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 279 | }, |
| 280 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 281 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 282 | "expandedUrl": "A String", # The full non-working URL. |
| 283 | "dnsError": "A String", # DNS lookup errors. |
| 284 | "redirectionError": "A String", # HTTP redirect chain error. |
| 285 | "platform": "A String", # Platform of the non-working URL. |
| 286 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 287 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 288 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 289 | }, |
| 290 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 291 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 292 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 293 | { # The URL-level breakdown for the download size. |
| 294 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 295 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 296 | }, |
| 297 | ], |
| 298 | }, |
| 299 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 300 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 301 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 302 | { # The number of HTTP calls made to the given domain. |
| 303 | "domain": "A String", # The domain name. |
| 304 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 305 | }, |
| 306 | ], |
| 307 | }, |
| 308 | }, |
| 309 | ], |
| 310 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 311 | }, |
| 312 | ], |
| 313 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 314 | }, |
| 315 | "detectedAttributes": [ # Publisher-excludable attributes that were detected for this creative. Can be used to filter the response of the creatives.list method. If the `excluded_attribute` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) contains one of the attributes that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 316 | "A String", |
| 317 | ], |
| 318 | "lastStatusUpdate": "A String", # The last time the creative status was updated. Can be used to filter the response of the creatives.list method. |
| 319 | "detectedSensitiveCategories": [ # Detected sensitive categories, if any. Can be used to filter the response of the creatives.list method. 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. |
| 320 | 42, |
| 321 | ], |
| 322 | "detectedProductCategories": [ # Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs. Can be used to filter the response of the creatives.list method. |
| 323 | 42, |
| 324 | ], |
| 325 | "detectedDomains": [ # The detected domains for this creative. |
| 326 | "A String", |
| 327 | ], |
| 328 | "detectedLanguages": [ # 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. Can be used to filter the response of the creatives.list method. |
| 329 | "A String", |
| 330 | ], |
| 331 | "detectedVendorIds": [ # IDs of the ad technology vendors that were detected to be used by this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. Can be used to filter the response of the creatives.list method. If the `allowed_vendor_type` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) does not contain one of the vendor type IDs that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 332 | 42, |
| 333 | ], |
| 334 | "detectedClickThroughUrls": [ # The set of detected destination URLs for the creative. Can be used to filter the response of the creatives.list method. |
| 335 | "A String", |
| 336 | ], |
| 337 | "networkPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding in open auction, private auction, or auction packages (outside of Russia and China). |
| 338 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 339 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 340 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 341 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 342 | { # Evidence associated with a policy topic entry. |
| 343 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 344 | "urls": [ # URLs of HTTP calls made by the creative. |
| 345 | "A String", |
| 346 | ], |
| 347 | }, |
| 348 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 349 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 350 | }, |
| 351 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 352 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 353 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 354 | "A String", |
| 355 | ], |
| 356 | }, |
| 357 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 358 | "crawlTime": "A String", # Approximate time of the crawl. |
| 359 | "reason": "A String", # Reason of destination not crawlable. |
| 360 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 361 | }, |
| 362 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 363 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 364 | "expandedUrl": "A String", # The full non-working URL. |
| 365 | "dnsError": "A String", # DNS lookup errors. |
| 366 | "redirectionError": "A String", # HTTP redirect chain error. |
| 367 | "platform": "A String", # Platform of the non-working URL. |
| 368 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 369 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 370 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 371 | }, |
| 372 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 373 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 374 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 375 | { # The URL-level breakdown for the download size. |
| 376 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 377 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 378 | }, |
| 379 | ], |
| 380 | }, |
| 381 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 382 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 383 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 384 | { # The number of HTTP calls made to the given domain. |
| 385 | "domain": "A String", # The domain name. |
| 386 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 387 | }, |
| 388 | ], |
| 389 | }, |
| 390 | }, |
| 391 | ], |
| 392 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 393 | }, |
| 394 | ], |
| 395 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 396 | }, |
| 397 | "russiaPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # The policy compliance of this creative in Russia. When approved or disapproved, this applies to both deals and open auction in Russia. When pending review, this creative is allowed to serve for deals but not for open auction. |
| 398 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 399 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 400 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 401 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 402 | { # Evidence associated with a policy topic entry. |
| 403 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 404 | "urls": [ # URLs of HTTP calls made by the creative. |
| 405 | "A String", |
| 406 | ], |
| 407 | }, |
| 408 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 409 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 410 | }, |
| 411 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 412 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 413 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 414 | "A String", |
| 415 | ], |
| 416 | }, |
| 417 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 418 | "crawlTime": "A String", # Approximate time of the crawl. |
| 419 | "reason": "A String", # Reason of destination not crawlable. |
| 420 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 421 | }, |
| 422 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 423 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 424 | "expandedUrl": "A String", # The full non-working URL. |
| 425 | "dnsError": "A String", # DNS lookup errors. |
| 426 | "redirectionError": "A String", # HTTP redirect chain error. |
| 427 | "platform": "A String", # Platform of the non-working URL. |
| 428 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 429 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 430 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 431 | }, |
| 432 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 433 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 434 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 435 | { # The URL-level breakdown for the download size. |
| 436 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 437 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 438 | }, |
| 439 | ], |
| 440 | }, |
| 441 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 442 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 443 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 444 | { # The number of HTTP calls made to the given domain. |
| 445 | "domain": "A String", # The domain name. |
| 446 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 447 | }, |
| 448 | ], |
| 449 | }, |
| 450 | }, |
| 451 | ], |
| 452 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 453 | }, |
| 454 | ], |
| 455 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 456 | }, |
| 457 | "detectedAdvertisers": [ # Detected advertisers and brands. |
| 458 | { # Detected advertiser and brand information. |
| 459 | "advertiserId": "A String", # See https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt for the list of possible values. Can be used to filter the response of the creatives.list method. |
| 460 | "advertiserName": "A String", # Advertiser name. Can be used to filter the response of the creatives.list method. |
| 461 | "brandId": "A String", # Detected brand ID or zero if no brand has been detected. See https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt for the list of possible values. Can be used to filter the response of the creatives.list method. |
| 462 | "brandName": "A String", # Brand name. Can be used to filter the response of the creatives.list method. |
| 463 | }, |
| 464 | ], |
| 465 | }, |
| 466 | "dealIds": [ # Output only. IDs of all of the deals with which this creative has been used in bidding. Can be used to filter the response of the creatives.list method. |
| 467 | "A String", |
| 468 | ], |
| 469 | "creativeFormat": "A String", # Output only. The format of this creative. Can be used to filter the response of the creatives.list method. |
| 470 | "native": { # Native content for a creative. # A native creative. |
| 471 | "headline": "A String", # A short title for the ad. |
| 472 | "clickTrackingUrl": "A String", # The URL to use for click tracking. |
| 473 | "body": "A String", # A long description of the ad. |
| 474 | "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. |
| 475 | "height": 42, # Image height in pixels. |
| 476 | "width": 42, # Image width in pixels. |
| 477 | "url": "A String", # The URL of the image. |
| 478 | }, |
| 479 | "priceDisplayText": "A String", # The price of the promoted app including currency info. |
| 480 | "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative. |
| 481 | "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. |
| 482 | "height": 42, # Image height in pixels. |
| 483 | "width": 42, # Image width in pixels. |
| 484 | "url": "A String", # The URL of the image. |
| 485 | }, |
| 486 | "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image. |
| 487 | "height": 42, # Image height in pixels. |
| 488 | "width": 42, # Image width in pixels. |
| 489 | "url": "A String", # The URL of the image. |
| 490 | }, |
| 491 | "callToAction": "A String", # A label for the button that the user is supposed to click. |
| 492 | "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad. |
| 493 | "videoUrl": "A String", # The URL to fetch a native video ad. |
| 494 | "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5]. |
| 495 | }, |
| 496 | "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative. Can be used to filter the response of the creatives.list method. |
| 497 | "A String", |
| 498 | ], |
| 499 | "agencyId": "A String", # The agency ID for this creative. |
| 500 | "creativeId": "A String", # Buyer-specific creative ID that references this creative in bid responses. This field is Ignored in update operations. Can be used to filter the response of the creatives.list method. The maximum length of the creative ID is 128 bytes. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 501 | "video": { # Video content for a creative. # A video creative. |
| 502 | "videoUrl": "A String", # The URL to fetch a video ad. |
| 503 | "videoMetadata": { # Video metadata for a creative. # Output only. Video metadata. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 504 | "isValidVast": True or False, # Is this a valid VAST ad? Can be used to filter the response of the creatives.list method. |
| 505 | "vastVersion": "A String", # The maximum VAST version across all wrapped VAST documents. Can be used to filter the response of the creatives.list method. |
| 506 | "skipOffset": "A String", # The minimum duration that the user has to watch before being able to skip this ad. If the field is not set, the ad is not skippable. If the field is set, the ad is skippable. Can be used to filter the response of the creatives.list method. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 507 | "mediaFiles": [ # The list of all media files declared in the VAST. If there are multiple VASTs in a wrapper chain, this includes the media files from the deepest one in the chain. |
| 508 | { # Information about each media file in the VAST. |
| 509 | "bitrate": "A String", # Bitrate of the video file, in Kbps. Can be used to filter the response of the creatives.list method. |
| 510 | "mimeType": "A String", # The MIME type of this media file. Can be used to filter the response of the creatives.list method. |
| 511 | }, |
| 512 | ], |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 513 | "duration": "A String", # The duration of the ad. Can be used to filter the response of the creatives.list method. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 514 | "isVpaid": True or False, # Is this a VPAID ad? Can be used to filter the response of the creatives.list method. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 515 | }, |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 516 | "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. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 517 | }, |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 518 | "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative. |
| 519 | "A String", |
| 520 | ], |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 521 | } |
| 522 | |
| 523 | x__xgafv: string, V1 error format. |
| 524 | Allowed values |
| 525 | 1 - v1 error format |
| 526 | 2 - v2 error format |
| 527 | |
| 528 | Returns: |
| 529 | An object of the form: |
| 530 | |
| 531 | { # A creative and its classification data. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 532 | "declaredRestrictedCategories": [ # All declared restricted categories for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 533 | "A String", |
| 534 | ], |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 535 | "declaredAttributes": [ # All declared attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. If the `excluded_attribute` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto") contains one of the attributes that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 536 | "A String", |
| 537 | ], |
| 538 | "impressionTrackingUrls": [ # The set of URLs to be called to record an impression. |
| 539 | "A String", |
| 540 | ], |
| 541 | "html": { # HTML content for a creative. # An HTML creative. |
| 542 | "width": 42, # The width of the HTML snippet in pixels. Can be used to filter the response of the creatives.list method. |
| 543 | "height": 42, # The height of the HTML snippet in pixels. Can be used to filter the response of the creatives.list method. |
| 544 | "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. |
| 545 | }, |
| 546 | "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API. |
| 547 | "accountId": "A String", # Output only. ID of the buyer account that this creative is owned by. Can be used to filter the response of the creatives.list method with equality and inequality check. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 548 | "declaredVendorIds": [ # IDs for the declared ad technology vendors that may be used by this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. Can be used to filter the response of the creatives.list method. |
| 549 | 42, |
| 550 | ], |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 551 | "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page. This is only supported for native ads. |
| 552 | "advertiserName": "A String", # The name of the company being advertised in the creative. Can be used to filter the response of the creatives.list method. |
| 553 | "name": "A String", # Output only. Name of the creative. Follows the pattern `buyers/{buyer}/creatives/{creative}`, where `{buyer}` represents the account ID of the buyer who owns the creative, and `{creative}` is the buyer-specific creative ID that references this creative in the bid response. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 554 | "version": 42, # Output only. The version of this creative. Version for a new creative is 1 and it increments during subsequent creative updates. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 555 | "creativeServingDecision": { # Top level status and detected attributes of a creative. # Output only. Top level status and detected attributes of a creative (for example domain, language, advertiser, product category, etc.) that affect whether (status) and where (context) a creative will be allowed to serve. |
| 556 | "dealsPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding on Programmatic Guaranteed and Preferred Deals (outside of Russia and China). |
| 557 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 558 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 559 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 560 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 561 | { # Evidence associated with a policy topic entry. |
| 562 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 563 | "urls": [ # URLs of HTTP calls made by the creative. |
| 564 | "A String", |
| 565 | ], |
| 566 | }, |
| 567 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 568 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 569 | }, |
| 570 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 571 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 572 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 573 | "A String", |
| 574 | ], |
| 575 | }, |
| 576 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 577 | "crawlTime": "A String", # Approximate time of the crawl. |
| 578 | "reason": "A String", # Reason of destination not crawlable. |
| 579 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 580 | }, |
| 581 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 582 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 583 | "expandedUrl": "A String", # The full non-working URL. |
| 584 | "dnsError": "A String", # DNS lookup errors. |
| 585 | "redirectionError": "A String", # HTTP redirect chain error. |
| 586 | "platform": "A String", # Platform of the non-working URL. |
| 587 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 588 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 589 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 590 | }, |
| 591 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 592 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 593 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 594 | { # The URL-level breakdown for the download size. |
| 595 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 596 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 597 | }, |
| 598 | ], |
| 599 | }, |
| 600 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 601 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 602 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 603 | { # The number of HTTP calls made to the given domain. |
| 604 | "domain": "A String", # The domain name. |
| 605 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 606 | }, |
| 607 | ], |
| 608 | }, |
| 609 | }, |
| 610 | ], |
| 611 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 612 | }, |
| 613 | ], |
| 614 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 615 | }, |
| 616 | "platformPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding in Open Bidding (outside of Russia and China). For the list of platform policies, see: https://support.google.com/platformspolicy/answer/3013851. |
| 617 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 618 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 619 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 620 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 621 | { # Evidence associated with a policy topic entry. |
| 622 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 623 | "urls": [ # URLs of HTTP calls made by the creative. |
| 624 | "A String", |
| 625 | ], |
| 626 | }, |
| 627 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 628 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 629 | }, |
| 630 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 631 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 632 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 633 | "A String", |
| 634 | ], |
| 635 | }, |
| 636 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 637 | "crawlTime": "A String", # Approximate time of the crawl. |
| 638 | "reason": "A String", # Reason of destination not crawlable. |
| 639 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 640 | }, |
| 641 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 642 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 643 | "expandedUrl": "A String", # The full non-working URL. |
| 644 | "dnsError": "A String", # DNS lookup errors. |
| 645 | "redirectionError": "A String", # HTTP redirect chain error. |
| 646 | "platform": "A String", # Platform of the non-working URL. |
| 647 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 648 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 649 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 650 | }, |
| 651 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 652 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 653 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 654 | { # The URL-level breakdown for the download size. |
| 655 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 656 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 657 | }, |
| 658 | ], |
| 659 | }, |
| 660 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 661 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 662 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 663 | { # The number of HTTP calls made to the given domain. |
| 664 | "domain": "A String", # The domain name. |
| 665 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 666 | }, |
| 667 | ], |
| 668 | }, |
| 669 | }, |
| 670 | ], |
| 671 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 672 | }, |
| 673 | ], |
| 674 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 675 | }, |
| 676 | "chinaPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # The policy compliance of this creative in China. When approved or disapproved, this applies to both deals and open auction in China. When pending review, this creative is allowed to serve for deals but not for open auction. |
| 677 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 678 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 679 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 680 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 681 | { # Evidence associated with a policy topic entry. |
| 682 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 683 | "urls": [ # URLs of HTTP calls made by the creative. |
| 684 | "A String", |
| 685 | ], |
| 686 | }, |
| 687 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 688 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 689 | }, |
| 690 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 691 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 692 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 693 | "A String", |
| 694 | ], |
| 695 | }, |
| 696 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 697 | "crawlTime": "A String", # Approximate time of the crawl. |
| 698 | "reason": "A String", # Reason of destination not crawlable. |
| 699 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 700 | }, |
| 701 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 702 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 703 | "expandedUrl": "A String", # The full non-working URL. |
| 704 | "dnsError": "A String", # DNS lookup errors. |
| 705 | "redirectionError": "A String", # HTTP redirect chain error. |
| 706 | "platform": "A String", # Platform of the non-working URL. |
| 707 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 708 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 709 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 710 | }, |
| 711 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 712 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 713 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 714 | { # The URL-level breakdown for the download size. |
| 715 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 716 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 717 | }, |
| 718 | ], |
| 719 | }, |
| 720 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 721 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 722 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 723 | { # The number of HTTP calls made to the given domain. |
| 724 | "domain": "A String", # The domain name. |
| 725 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 726 | }, |
| 727 | ], |
| 728 | }, |
| 729 | }, |
| 730 | ], |
| 731 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 732 | }, |
| 733 | ], |
| 734 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 735 | }, |
| 736 | "detectedAttributes": [ # Publisher-excludable attributes that were detected for this creative. Can be used to filter the response of the creatives.list method. If the `excluded_attribute` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) contains one of the attributes that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 737 | "A String", |
| 738 | ], |
| 739 | "lastStatusUpdate": "A String", # The last time the creative status was updated. Can be used to filter the response of the creatives.list method. |
| 740 | "detectedSensitiveCategories": [ # Detected sensitive categories, if any. Can be used to filter the response of the creatives.list method. 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. |
| 741 | 42, |
| 742 | ], |
| 743 | "detectedProductCategories": [ # Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs. Can be used to filter the response of the creatives.list method. |
| 744 | 42, |
| 745 | ], |
| 746 | "detectedDomains": [ # The detected domains for this creative. |
| 747 | "A String", |
| 748 | ], |
| 749 | "detectedLanguages": [ # 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. Can be used to filter the response of the creatives.list method. |
| 750 | "A String", |
| 751 | ], |
| 752 | "detectedVendorIds": [ # IDs of the ad technology vendors that were detected to be used by this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. Can be used to filter the response of the creatives.list method. If the `allowed_vendor_type` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) does not contain one of the vendor type IDs that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 753 | 42, |
| 754 | ], |
| 755 | "detectedClickThroughUrls": [ # The set of detected destination URLs for the creative. Can be used to filter the response of the creatives.list method. |
| 756 | "A String", |
| 757 | ], |
| 758 | "networkPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding in open auction, private auction, or auction packages (outside of Russia and China). |
| 759 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 760 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 761 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 762 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 763 | { # Evidence associated with a policy topic entry. |
| 764 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 765 | "urls": [ # URLs of HTTP calls made by the creative. |
| 766 | "A String", |
| 767 | ], |
| 768 | }, |
| 769 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 770 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 771 | }, |
| 772 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 773 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 774 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 775 | "A String", |
| 776 | ], |
| 777 | }, |
| 778 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 779 | "crawlTime": "A String", # Approximate time of the crawl. |
| 780 | "reason": "A String", # Reason of destination not crawlable. |
| 781 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 782 | }, |
| 783 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 784 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 785 | "expandedUrl": "A String", # The full non-working URL. |
| 786 | "dnsError": "A String", # DNS lookup errors. |
| 787 | "redirectionError": "A String", # HTTP redirect chain error. |
| 788 | "platform": "A String", # Platform of the non-working URL. |
| 789 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 790 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 791 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 792 | }, |
| 793 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 794 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 795 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 796 | { # The URL-level breakdown for the download size. |
| 797 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 798 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 799 | }, |
| 800 | ], |
| 801 | }, |
| 802 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 803 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 804 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 805 | { # The number of HTTP calls made to the given domain. |
| 806 | "domain": "A String", # The domain name. |
| 807 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 808 | }, |
| 809 | ], |
| 810 | }, |
| 811 | }, |
| 812 | ], |
| 813 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 814 | }, |
| 815 | ], |
| 816 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 817 | }, |
| 818 | "russiaPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # The policy compliance of this creative in Russia. When approved or disapproved, this applies to both deals and open auction in Russia. When pending review, this creative is allowed to serve for deals but not for open auction. |
| 819 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 820 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 821 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 822 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 823 | { # Evidence associated with a policy topic entry. |
| 824 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 825 | "urls": [ # URLs of HTTP calls made by the creative. |
| 826 | "A String", |
| 827 | ], |
| 828 | }, |
| 829 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 830 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 831 | }, |
| 832 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 833 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 834 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 835 | "A String", |
| 836 | ], |
| 837 | }, |
| 838 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 839 | "crawlTime": "A String", # Approximate time of the crawl. |
| 840 | "reason": "A String", # Reason of destination not crawlable. |
| 841 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 842 | }, |
| 843 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 844 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 845 | "expandedUrl": "A String", # The full non-working URL. |
| 846 | "dnsError": "A String", # DNS lookup errors. |
| 847 | "redirectionError": "A String", # HTTP redirect chain error. |
| 848 | "platform": "A String", # Platform of the non-working URL. |
| 849 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 850 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 851 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 852 | }, |
| 853 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 854 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 855 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 856 | { # The URL-level breakdown for the download size. |
| 857 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 858 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 859 | }, |
| 860 | ], |
| 861 | }, |
| 862 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 863 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 864 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 865 | { # The number of HTTP calls made to the given domain. |
| 866 | "domain": "A String", # The domain name. |
| 867 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 868 | }, |
| 869 | ], |
| 870 | }, |
| 871 | }, |
| 872 | ], |
| 873 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 874 | }, |
| 875 | ], |
| 876 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 877 | }, |
| 878 | "detectedAdvertisers": [ # Detected advertisers and brands. |
| 879 | { # Detected advertiser and brand information. |
| 880 | "advertiserId": "A String", # See https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt for the list of possible values. Can be used to filter the response of the creatives.list method. |
| 881 | "advertiserName": "A String", # Advertiser name. Can be used to filter the response of the creatives.list method. |
| 882 | "brandId": "A String", # Detected brand ID or zero if no brand has been detected. See https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt for the list of possible values. Can be used to filter the response of the creatives.list method. |
| 883 | "brandName": "A String", # Brand name. Can be used to filter the response of the creatives.list method. |
| 884 | }, |
| 885 | ], |
| 886 | }, |
| 887 | "dealIds": [ # Output only. IDs of all of the deals with which this creative has been used in bidding. Can be used to filter the response of the creatives.list method. |
| 888 | "A String", |
| 889 | ], |
| 890 | "creativeFormat": "A String", # Output only. The format of this creative. Can be used to filter the response of the creatives.list method. |
| 891 | "native": { # Native content for a creative. # A native creative. |
| 892 | "headline": "A String", # A short title for the ad. |
| 893 | "clickTrackingUrl": "A String", # The URL to use for click tracking. |
| 894 | "body": "A String", # A long description of the ad. |
| 895 | "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. |
| 896 | "height": 42, # Image height in pixels. |
| 897 | "width": 42, # Image width in pixels. |
| 898 | "url": "A String", # The URL of the image. |
| 899 | }, |
| 900 | "priceDisplayText": "A String", # The price of the promoted app including currency info. |
| 901 | "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative. |
| 902 | "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. |
| 903 | "height": 42, # Image height in pixels. |
| 904 | "width": 42, # Image width in pixels. |
| 905 | "url": "A String", # The URL of the image. |
| 906 | }, |
| 907 | "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image. |
| 908 | "height": 42, # Image height in pixels. |
| 909 | "width": 42, # Image width in pixels. |
| 910 | "url": "A String", # The URL of the image. |
| 911 | }, |
| 912 | "callToAction": "A String", # A label for the button that the user is supposed to click. |
| 913 | "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad. |
| 914 | "videoUrl": "A String", # The URL to fetch a native video ad. |
| 915 | "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5]. |
| 916 | }, |
| 917 | "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative. Can be used to filter the response of the creatives.list method. |
| 918 | "A String", |
| 919 | ], |
| 920 | "agencyId": "A String", # The agency ID for this creative. |
| 921 | "creativeId": "A String", # Buyer-specific creative ID that references this creative in bid responses. This field is Ignored in update operations. Can be used to filter the response of the creatives.list method. The maximum length of the creative ID is 128 bytes. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 922 | "video": { # Video content for a creative. # A video creative. |
| 923 | "videoUrl": "A String", # The URL to fetch a video ad. |
| 924 | "videoMetadata": { # Video metadata for a creative. # Output only. Video metadata. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 925 | "isValidVast": True or False, # Is this a valid VAST ad? Can be used to filter the response of the creatives.list method. |
| 926 | "vastVersion": "A String", # The maximum VAST version across all wrapped VAST documents. Can be used to filter the response of the creatives.list method. |
| 927 | "skipOffset": "A String", # The minimum duration that the user has to watch before being able to skip this ad. If the field is not set, the ad is not skippable. If the field is set, the ad is skippable. Can be used to filter the response of the creatives.list method. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 928 | "mediaFiles": [ # The list of all media files declared in the VAST. If there are multiple VASTs in a wrapper chain, this includes the media files from the deepest one in the chain. |
| 929 | { # Information about each media file in the VAST. |
| 930 | "bitrate": "A String", # Bitrate of the video file, in Kbps. Can be used to filter the response of the creatives.list method. |
| 931 | "mimeType": "A String", # The MIME type of this media file. Can be used to filter the response of the creatives.list method. |
| 932 | }, |
| 933 | ], |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 934 | "duration": "A String", # The duration of the ad. Can be used to filter the response of the creatives.list method. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 935 | "isVpaid": True or False, # Is this a VPAID ad? Can be used to filter the response of the creatives.list method. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 936 | }, |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 937 | "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. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 938 | }, |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 939 | "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative. |
| 940 | "A String", |
| 941 | ], |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 942 | }</pre> |
| 943 | </div> |
| 944 | |
| 945 | <div class="method"> |
| 946 | <code class="details" id="get">get(name, view=None, x__xgafv=None)</code> |
| 947 | <pre>Gets a creative. |
| 948 | |
| 949 | Args: |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 950 | name: string, Required. Name of the creative to retrieve. See creative.name. (required) |
| 951 | view: string, Controls the amount of information included in the response. By default only creativeServingDecision is included. To retrieve the entire creative resource (including the declared fields and the creative content) specify the view as "FULL". |
| 952 | Allowed values |
| 953 | CREATIVE_VIEW_UNSPECIFIED - Not specified, equivalent to SERVING_DECISION_ONLY. |
| 954 | SERVING_DECISION_ONLY - Only creativeServingDecision is included in the response. |
| 955 | FULL - The entire creative resource (including the declared fields and the creative content) is included in the response. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 956 | x__xgafv: string, V1 error format. |
| 957 | Allowed values |
| 958 | 1 - v1 error format |
| 959 | 2 - v2 error format |
| 960 | |
| 961 | Returns: |
| 962 | An object of the form: |
| 963 | |
| 964 | { # A creative and its classification data. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 965 | "declaredRestrictedCategories": [ # All declared restricted categories for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 966 | "A String", |
| 967 | ], |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 968 | "declaredAttributes": [ # All declared attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. If the `excluded_attribute` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto") contains one of the attributes that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 969 | "A String", |
| 970 | ], |
| 971 | "impressionTrackingUrls": [ # The set of URLs to be called to record an impression. |
| 972 | "A String", |
| 973 | ], |
| 974 | "html": { # HTML content for a creative. # An HTML creative. |
| 975 | "width": 42, # The width of the HTML snippet in pixels. Can be used to filter the response of the creatives.list method. |
| 976 | "height": 42, # The height of the HTML snippet in pixels. Can be used to filter the response of the creatives.list method. |
| 977 | "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. |
| 978 | }, |
| 979 | "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API. |
| 980 | "accountId": "A String", # Output only. ID of the buyer account that this creative is owned by. Can be used to filter the response of the creatives.list method with equality and inequality check. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 981 | "declaredVendorIds": [ # IDs for the declared ad technology vendors that may be used by this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. Can be used to filter the response of the creatives.list method. |
| 982 | 42, |
| 983 | ], |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 984 | "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page. This is only supported for native ads. |
| 985 | "advertiserName": "A String", # The name of the company being advertised in the creative. Can be used to filter the response of the creatives.list method. |
| 986 | "name": "A String", # Output only. Name of the creative. Follows the pattern `buyers/{buyer}/creatives/{creative}`, where `{buyer}` represents the account ID of the buyer who owns the creative, and `{creative}` is the buyer-specific creative ID that references this creative in the bid response. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 987 | "version": 42, # Output only. The version of this creative. Version for a new creative is 1 and it increments during subsequent creative updates. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 988 | "creativeServingDecision": { # Top level status and detected attributes of a creative. # Output only. Top level status and detected attributes of a creative (for example domain, language, advertiser, product category, etc.) that affect whether (status) and where (context) a creative will be allowed to serve. |
| 989 | "dealsPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding on Programmatic Guaranteed and Preferred Deals (outside of Russia and China). |
| 990 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 991 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 992 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 993 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 994 | { # Evidence associated with a policy topic entry. |
| 995 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 996 | "urls": [ # URLs of HTTP calls made by the creative. |
| 997 | "A String", |
| 998 | ], |
| 999 | }, |
| 1000 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 1001 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 1002 | }, |
| 1003 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 1004 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 1005 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 1006 | "A String", |
| 1007 | ], |
| 1008 | }, |
| 1009 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 1010 | "crawlTime": "A String", # Approximate time of the crawl. |
| 1011 | "reason": "A String", # Reason of destination not crawlable. |
| 1012 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 1013 | }, |
| 1014 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 1015 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 1016 | "expandedUrl": "A String", # The full non-working URL. |
| 1017 | "dnsError": "A String", # DNS lookup errors. |
| 1018 | "redirectionError": "A String", # HTTP redirect chain error. |
| 1019 | "platform": "A String", # Platform of the non-working URL. |
| 1020 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 1021 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 1022 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 1023 | }, |
| 1024 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 1025 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 1026 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 1027 | { # The URL-level breakdown for the download size. |
| 1028 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 1029 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 1030 | }, |
| 1031 | ], |
| 1032 | }, |
| 1033 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 1034 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 1035 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 1036 | { # The number of HTTP calls made to the given domain. |
| 1037 | "domain": "A String", # The domain name. |
| 1038 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 1039 | }, |
| 1040 | ], |
| 1041 | }, |
| 1042 | }, |
| 1043 | ], |
| 1044 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 1045 | }, |
| 1046 | ], |
| 1047 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 1048 | }, |
| 1049 | "platformPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding in Open Bidding (outside of Russia and China). For the list of platform policies, see: https://support.google.com/platformspolicy/answer/3013851. |
| 1050 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 1051 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 1052 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 1053 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 1054 | { # Evidence associated with a policy topic entry. |
| 1055 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 1056 | "urls": [ # URLs of HTTP calls made by the creative. |
| 1057 | "A String", |
| 1058 | ], |
| 1059 | }, |
| 1060 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 1061 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 1062 | }, |
| 1063 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 1064 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 1065 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 1066 | "A String", |
| 1067 | ], |
| 1068 | }, |
| 1069 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 1070 | "crawlTime": "A String", # Approximate time of the crawl. |
| 1071 | "reason": "A String", # Reason of destination not crawlable. |
| 1072 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 1073 | }, |
| 1074 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 1075 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 1076 | "expandedUrl": "A String", # The full non-working URL. |
| 1077 | "dnsError": "A String", # DNS lookup errors. |
| 1078 | "redirectionError": "A String", # HTTP redirect chain error. |
| 1079 | "platform": "A String", # Platform of the non-working URL. |
| 1080 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 1081 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 1082 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 1083 | }, |
| 1084 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 1085 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 1086 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 1087 | { # The URL-level breakdown for the download size. |
| 1088 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 1089 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 1090 | }, |
| 1091 | ], |
| 1092 | }, |
| 1093 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 1094 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 1095 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 1096 | { # The number of HTTP calls made to the given domain. |
| 1097 | "domain": "A String", # The domain name. |
| 1098 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 1099 | }, |
| 1100 | ], |
| 1101 | }, |
| 1102 | }, |
| 1103 | ], |
| 1104 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 1105 | }, |
| 1106 | ], |
| 1107 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 1108 | }, |
| 1109 | "chinaPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # The policy compliance of this creative in China. When approved or disapproved, this applies to both deals and open auction in China. When pending review, this creative is allowed to serve for deals but not for open auction. |
| 1110 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 1111 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 1112 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 1113 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 1114 | { # Evidence associated with a policy topic entry. |
| 1115 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 1116 | "urls": [ # URLs of HTTP calls made by the creative. |
| 1117 | "A String", |
| 1118 | ], |
| 1119 | }, |
| 1120 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 1121 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 1122 | }, |
| 1123 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 1124 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 1125 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 1126 | "A String", |
| 1127 | ], |
| 1128 | }, |
| 1129 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 1130 | "crawlTime": "A String", # Approximate time of the crawl. |
| 1131 | "reason": "A String", # Reason of destination not crawlable. |
| 1132 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 1133 | }, |
| 1134 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 1135 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 1136 | "expandedUrl": "A String", # The full non-working URL. |
| 1137 | "dnsError": "A String", # DNS lookup errors. |
| 1138 | "redirectionError": "A String", # HTTP redirect chain error. |
| 1139 | "platform": "A String", # Platform of the non-working URL. |
| 1140 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 1141 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 1142 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 1143 | }, |
| 1144 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 1145 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 1146 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 1147 | { # The URL-level breakdown for the download size. |
| 1148 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 1149 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 1150 | }, |
| 1151 | ], |
| 1152 | }, |
| 1153 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 1154 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 1155 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 1156 | { # The number of HTTP calls made to the given domain. |
| 1157 | "domain": "A String", # The domain name. |
| 1158 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 1159 | }, |
| 1160 | ], |
| 1161 | }, |
| 1162 | }, |
| 1163 | ], |
| 1164 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 1165 | }, |
| 1166 | ], |
| 1167 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 1168 | }, |
| 1169 | "detectedAttributes": [ # Publisher-excludable attributes that were detected for this creative. Can be used to filter the response of the creatives.list method. If the `excluded_attribute` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) contains one of the attributes that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 1170 | "A String", |
| 1171 | ], |
| 1172 | "lastStatusUpdate": "A String", # The last time the creative status was updated. Can be used to filter the response of the creatives.list method. |
| 1173 | "detectedSensitiveCategories": [ # Detected sensitive categories, if any. Can be used to filter the response of the creatives.list method. 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. |
| 1174 | 42, |
| 1175 | ], |
| 1176 | "detectedProductCategories": [ # Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs. Can be used to filter the response of the creatives.list method. |
| 1177 | 42, |
| 1178 | ], |
| 1179 | "detectedDomains": [ # The detected domains for this creative. |
| 1180 | "A String", |
| 1181 | ], |
| 1182 | "detectedLanguages": [ # 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. Can be used to filter the response of the creatives.list method. |
| 1183 | "A String", |
| 1184 | ], |
| 1185 | "detectedVendorIds": [ # IDs of the ad technology vendors that were detected to be used by this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. Can be used to filter the response of the creatives.list method. If the `allowed_vendor_type` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) does not contain one of the vendor type IDs that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 1186 | 42, |
| 1187 | ], |
| 1188 | "detectedClickThroughUrls": [ # The set of detected destination URLs for the creative. Can be used to filter the response of the creatives.list method. |
| 1189 | "A String", |
| 1190 | ], |
| 1191 | "networkPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding in open auction, private auction, or auction packages (outside of Russia and China). |
| 1192 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 1193 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 1194 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 1195 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 1196 | { # Evidence associated with a policy topic entry. |
| 1197 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 1198 | "urls": [ # URLs of HTTP calls made by the creative. |
| 1199 | "A String", |
| 1200 | ], |
| 1201 | }, |
| 1202 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 1203 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 1204 | }, |
| 1205 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 1206 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 1207 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 1208 | "A String", |
| 1209 | ], |
| 1210 | }, |
| 1211 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 1212 | "crawlTime": "A String", # Approximate time of the crawl. |
| 1213 | "reason": "A String", # Reason of destination not crawlable. |
| 1214 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 1215 | }, |
| 1216 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 1217 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 1218 | "expandedUrl": "A String", # The full non-working URL. |
| 1219 | "dnsError": "A String", # DNS lookup errors. |
| 1220 | "redirectionError": "A String", # HTTP redirect chain error. |
| 1221 | "platform": "A String", # Platform of the non-working URL. |
| 1222 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 1223 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 1224 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 1225 | }, |
| 1226 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 1227 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 1228 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 1229 | { # The URL-level breakdown for the download size. |
| 1230 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 1231 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 1232 | }, |
| 1233 | ], |
| 1234 | }, |
| 1235 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 1236 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 1237 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 1238 | { # The number of HTTP calls made to the given domain. |
| 1239 | "domain": "A String", # The domain name. |
| 1240 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 1241 | }, |
| 1242 | ], |
| 1243 | }, |
| 1244 | }, |
| 1245 | ], |
| 1246 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 1247 | }, |
| 1248 | ], |
| 1249 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 1250 | }, |
| 1251 | "russiaPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # The policy compliance of this creative in Russia. When approved or disapproved, this applies to both deals and open auction in Russia. When pending review, this creative is allowed to serve for deals but not for open auction. |
| 1252 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 1253 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 1254 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 1255 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 1256 | { # Evidence associated with a policy topic entry. |
| 1257 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 1258 | "urls": [ # URLs of HTTP calls made by the creative. |
| 1259 | "A String", |
| 1260 | ], |
| 1261 | }, |
| 1262 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 1263 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 1264 | }, |
| 1265 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 1266 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 1267 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 1268 | "A String", |
| 1269 | ], |
| 1270 | }, |
| 1271 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 1272 | "crawlTime": "A String", # Approximate time of the crawl. |
| 1273 | "reason": "A String", # Reason of destination not crawlable. |
| 1274 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 1275 | }, |
| 1276 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 1277 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 1278 | "expandedUrl": "A String", # The full non-working URL. |
| 1279 | "dnsError": "A String", # DNS lookup errors. |
| 1280 | "redirectionError": "A String", # HTTP redirect chain error. |
| 1281 | "platform": "A String", # Platform of the non-working URL. |
| 1282 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 1283 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 1284 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 1285 | }, |
| 1286 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 1287 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 1288 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 1289 | { # The URL-level breakdown for the download size. |
| 1290 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 1291 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 1292 | }, |
| 1293 | ], |
| 1294 | }, |
| 1295 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 1296 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 1297 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 1298 | { # The number of HTTP calls made to the given domain. |
| 1299 | "domain": "A String", # The domain name. |
| 1300 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 1301 | }, |
| 1302 | ], |
| 1303 | }, |
| 1304 | }, |
| 1305 | ], |
| 1306 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 1307 | }, |
| 1308 | ], |
| 1309 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 1310 | }, |
| 1311 | "detectedAdvertisers": [ # Detected advertisers and brands. |
| 1312 | { # Detected advertiser and brand information. |
| 1313 | "advertiserId": "A String", # See https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt for the list of possible values. Can be used to filter the response of the creatives.list method. |
| 1314 | "advertiserName": "A String", # Advertiser name. Can be used to filter the response of the creatives.list method. |
| 1315 | "brandId": "A String", # Detected brand ID or zero if no brand has been detected. See https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt for the list of possible values. Can be used to filter the response of the creatives.list method. |
| 1316 | "brandName": "A String", # Brand name. Can be used to filter the response of the creatives.list method. |
| 1317 | }, |
| 1318 | ], |
| 1319 | }, |
| 1320 | "dealIds": [ # Output only. IDs of all of the deals with which this creative has been used in bidding. Can be used to filter the response of the creatives.list method. |
| 1321 | "A String", |
| 1322 | ], |
| 1323 | "creativeFormat": "A String", # Output only. The format of this creative. Can be used to filter the response of the creatives.list method. |
| 1324 | "native": { # Native content for a creative. # A native creative. |
| 1325 | "headline": "A String", # A short title for the ad. |
| 1326 | "clickTrackingUrl": "A String", # The URL to use for click tracking. |
| 1327 | "body": "A String", # A long description of the ad. |
| 1328 | "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. |
| 1329 | "height": 42, # Image height in pixels. |
| 1330 | "width": 42, # Image width in pixels. |
| 1331 | "url": "A String", # The URL of the image. |
| 1332 | }, |
| 1333 | "priceDisplayText": "A String", # The price of the promoted app including currency info. |
| 1334 | "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative. |
| 1335 | "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. |
| 1336 | "height": 42, # Image height in pixels. |
| 1337 | "width": 42, # Image width in pixels. |
| 1338 | "url": "A String", # The URL of the image. |
| 1339 | }, |
| 1340 | "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image. |
| 1341 | "height": 42, # Image height in pixels. |
| 1342 | "width": 42, # Image width in pixels. |
| 1343 | "url": "A String", # The URL of the image. |
| 1344 | }, |
| 1345 | "callToAction": "A String", # A label for the button that the user is supposed to click. |
| 1346 | "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad. |
| 1347 | "videoUrl": "A String", # The URL to fetch a native video ad. |
| 1348 | "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5]. |
| 1349 | }, |
| 1350 | "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative. Can be used to filter the response of the creatives.list method. |
| 1351 | "A String", |
| 1352 | ], |
| 1353 | "agencyId": "A String", # The agency ID for this creative. |
| 1354 | "creativeId": "A String", # Buyer-specific creative ID that references this creative in bid responses. This field is Ignored in update operations. Can be used to filter the response of the creatives.list method. The maximum length of the creative ID is 128 bytes. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1355 | "video": { # Video content for a creative. # A video creative. |
| 1356 | "videoUrl": "A String", # The URL to fetch a video ad. |
| 1357 | "videoMetadata": { # Video metadata for a creative. # Output only. Video metadata. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 1358 | "isValidVast": True or False, # Is this a valid VAST ad? Can be used to filter the response of the creatives.list method. |
| 1359 | "vastVersion": "A String", # The maximum VAST version across all wrapped VAST documents. Can be used to filter the response of the creatives.list method. |
| 1360 | "skipOffset": "A String", # The minimum duration that the user has to watch before being able to skip this ad. If the field is not set, the ad is not skippable. If the field is set, the ad is skippable. Can be used to filter the response of the creatives.list method. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1361 | "mediaFiles": [ # The list of all media files declared in the VAST. If there are multiple VASTs in a wrapper chain, this includes the media files from the deepest one in the chain. |
| 1362 | { # Information about each media file in the VAST. |
| 1363 | "bitrate": "A String", # Bitrate of the video file, in Kbps. Can be used to filter the response of the creatives.list method. |
| 1364 | "mimeType": "A String", # The MIME type of this media file. Can be used to filter the response of the creatives.list method. |
| 1365 | }, |
| 1366 | ], |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 1367 | "duration": "A String", # The duration of the ad. Can be used to filter the response of the creatives.list method. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 1368 | "isVpaid": True or False, # Is this a VPAID ad? Can be used to filter the response of the creatives.list method. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1369 | }, |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 1370 | "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. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1371 | }, |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 1372 | "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative. |
| 1373 | "A String", |
| 1374 | ], |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 1375 | }</pre> |
| 1376 | </div> |
| 1377 | |
| 1378 | <div class="method"> |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 1379 | <code class="details" id="list">list(parent, filter=None, view=None, pageToken=None, pageSize=None, x__xgafv=None)</code> |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 1380 | <pre>Lists creatives. |
| 1381 | |
| 1382 | Args: |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1383 | parent: string, Required. Name of the parent buyer that owns the creatives. The pattern for this resource is either `buyers/{buyerAccountId}` or `bidders/{bidderAccountId}`. For `buyers/{buyerAccountId}`, the `buyerAccountId` can be one of the following: 1. The ID of the buyer that is accessing their own creatives. 2. The ID of the child seat buyer under a bidder account. So for listing creatives pertaining to the child seat buyer (`456`) under bidder account (`123`), you would use the pattern: `buyers/456`. 3. The ID of the bidder itself. So for listing creatives pertaining to bidder (`123`), you would use `buyers/123`. If you want to access all creatives pertaining to both the bidder and all of its child seat accounts, you would use `bidders/{bidderAccountId}`, e.g., for all creatives pertaining to bidder (`123`), use `bidders/123`. (required) |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 1384 | filter: string, Query string to filter creatives. If no filter is specified, all active creatives will be returned. Example: 'accountId=12345 AND (dealsStatus:DISAPPROVED AND disapprovalReason:UNACCEPTABLE_CONTENT) OR declaredAttributes:IS_COOKIE_TARGETED' |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1385 | view: string, Controls the amount of information included in the response. By default only creativeServingDecision is included. To retrieve the entire creative resource (including the declared fields and the creative content) specify the view as "FULL". |
| 1386 | Allowed values |
| 1387 | CREATIVE_VIEW_UNSPECIFIED - Not specified, equivalent to SERVING_DECISION_ONLY. |
| 1388 | SERVING_DECISION_ONLY - Only creativeServingDecision is included in the response. |
| 1389 | FULL - The entire creative resource (including the declared fields and the creative content) is included in the response. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1390 | pageToken: string, A token identifying a page of results the server should return. Typically, this is the value of ListCreativesResponse.nextPageToken returned from the previous call to the 'ListCreatives' method. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 1391 | 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 1392 | x__xgafv: string, V1 error format. |
| 1393 | Allowed values |
| 1394 | 1 - v1 error format |
| 1395 | 2 - v2 error format |
| 1396 | |
| 1397 | Returns: |
| 1398 | An object of the form: |
| 1399 | |
| 1400 | { # A response for listing creatives. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 1401 | "creatives": [ # The list of creatives. |
| 1402 | { # A creative and its classification data. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 1403 | "declaredRestrictedCategories": [ # All declared restricted categories for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 1404 | "A String", |
| 1405 | ], |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 1406 | "declaredAttributes": [ # All declared attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. If the `excluded_attribute` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto") contains one of the attributes that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 1407 | "A String", |
| 1408 | ], |
| 1409 | "impressionTrackingUrls": [ # The set of URLs to be called to record an impression. |
| 1410 | "A String", |
| 1411 | ], |
| 1412 | "html": { # HTML content for a creative. # An HTML creative. |
| 1413 | "width": 42, # The width of the HTML snippet in pixels. Can be used to filter the response of the creatives.list method. |
| 1414 | "height": 42, # The height of the HTML snippet in pixels. Can be used to filter the response of the creatives.list method. |
| 1415 | "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. |
| 1416 | }, |
| 1417 | "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API. |
| 1418 | "accountId": "A String", # Output only. ID of the buyer account that this creative is owned by. Can be used to filter the response of the creatives.list method with equality and inequality check. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1419 | "declaredVendorIds": [ # IDs for the declared ad technology vendors that may be used by this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. Can be used to filter the response of the creatives.list method. |
| 1420 | 42, |
| 1421 | ], |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 1422 | "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page. This is only supported for native ads. |
| 1423 | "advertiserName": "A String", # The name of the company being advertised in the creative. Can be used to filter the response of the creatives.list method. |
| 1424 | "name": "A String", # Output only. Name of the creative. Follows the pattern `buyers/{buyer}/creatives/{creative}`, where `{buyer}` represents the account ID of the buyer who owns the creative, and `{creative}` is the buyer-specific creative ID that references this creative in the bid response. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1425 | "version": 42, # Output only. The version of this creative. Version for a new creative is 1 and it increments during subsequent creative updates. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 1426 | "creativeServingDecision": { # Top level status and detected attributes of a creative. # Output only. Top level status and detected attributes of a creative (for example domain, language, advertiser, product category, etc.) that affect whether (status) and where (context) a creative will be allowed to serve. |
| 1427 | "dealsPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding on Programmatic Guaranteed and Preferred Deals (outside of Russia and China). |
| 1428 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 1429 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 1430 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 1431 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 1432 | { # Evidence associated with a policy topic entry. |
| 1433 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 1434 | "urls": [ # URLs of HTTP calls made by the creative. |
| 1435 | "A String", |
| 1436 | ], |
| 1437 | }, |
| 1438 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 1439 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 1440 | }, |
| 1441 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 1442 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 1443 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 1444 | "A String", |
| 1445 | ], |
| 1446 | }, |
| 1447 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 1448 | "crawlTime": "A String", # Approximate time of the crawl. |
| 1449 | "reason": "A String", # Reason of destination not crawlable. |
| 1450 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 1451 | }, |
| 1452 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 1453 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 1454 | "expandedUrl": "A String", # The full non-working URL. |
| 1455 | "dnsError": "A String", # DNS lookup errors. |
| 1456 | "redirectionError": "A String", # HTTP redirect chain error. |
| 1457 | "platform": "A String", # Platform of the non-working URL. |
| 1458 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 1459 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 1460 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 1461 | }, |
| 1462 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 1463 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 1464 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 1465 | { # The URL-level breakdown for the download size. |
| 1466 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 1467 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 1468 | }, |
| 1469 | ], |
| 1470 | }, |
| 1471 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 1472 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 1473 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 1474 | { # The number of HTTP calls made to the given domain. |
| 1475 | "domain": "A String", # The domain name. |
| 1476 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 1477 | }, |
| 1478 | ], |
| 1479 | }, |
| 1480 | }, |
| 1481 | ], |
| 1482 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 1483 | }, |
| 1484 | ], |
| 1485 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 1486 | }, |
| 1487 | "platformPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding in Open Bidding (outside of Russia and China). For the list of platform policies, see: https://support.google.com/platformspolicy/answer/3013851. |
| 1488 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 1489 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 1490 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 1491 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 1492 | { # Evidence associated with a policy topic entry. |
| 1493 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 1494 | "urls": [ # URLs of HTTP calls made by the creative. |
| 1495 | "A String", |
| 1496 | ], |
| 1497 | }, |
| 1498 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 1499 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 1500 | }, |
| 1501 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 1502 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 1503 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 1504 | "A String", |
| 1505 | ], |
| 1506 | }, |
| 1507 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 1508 | "crawlTime": "A String", # Approximate time of the crawl. |
| 1509 | "reason": "A String", # Reason of destination not crawlable. |
| 1510 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 1511 | }, |
| 1512 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 1513 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 1514 | "expandedUrl": "A String", # The full non-working URL. |
| 1515 | "dnsError": "A String", # DNS lookup errors. |
| 1516 | "redirectionError": "A String", # HTTP redirect chain error. |
| 1517 | "platform": "A String", # Platform of the non-working URL. |
| 1518 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 1519 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 1520 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 1521 | }, |
| 1522 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 1523 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 1524 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 1525 | { # The URL-level breakdown for the download size. |
| 1526 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 1527 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 1528 | }, |
| 1529 | ], |
| 1530 | }, |
| 1531 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 1532 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 1533 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 1534 | { # The number of HTTP calls made to the given domain. |
| 1535 | "domain": "A String", # The domain name. |
| 1536 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 1537 | }, |
| 1538 | ], |
| 1539 | }, |
| 1540 | }, |
| 1541 | ], |
| 1542 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 1543 | }, |
| 1544 | ], |
| 1545 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 1546 | }, |
| 1547 | "chinaPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # The policy compliance of this creative in China. When approved or disapproved, this applies to both deals and open auction in China. When pending review, this creative is allowed to serve for deals but not for open auction. |
| 1548 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 1549 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 1550 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 1551 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 1552 | { # Evidence associated with a policy topic entry. |
| 1553 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 1554 | "urls": [ # URLs of HTTP calls made by the creative. |
| 1555 | "A String", |
| 1556 | ], |
| 1557 | }, |
| 1558 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 1559 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 1560 | }, |
| 1561 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 1562 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 1563 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 1564 | "A String", |
| 1565 | ], |
| 1566 | }, |
| 1567 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 1568 | "crawlTime": "A String", # Approximate time of the crawl. |
| 1569 | "reason": "A String", # Reason of destination not crawlable. |
| 1570 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 1571 | }, |
| 1572 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 1573 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 1574 | "expandedUrl": "A String", # The full non-working URL. |
| 1575 | "dnsError": "A String", # DNS lookup errors. |
| 1576 | "redirectionError": "A String", # HTTP redirect chain error. |
| 1577 | "platform": "A String", # Platform of the non-working URL. |
| 1578 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 1579 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 1580 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 1581 | }, |
| 1582 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 1583 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 1584 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 1585 | { # The URL-level breakdown for the download size. |
| 1586 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 1587 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 1588 | }, |
| 1589 | ], |
| 1590 | }, |
| 1591 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 1592 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 1593 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 1594 | { # The number of HTTP calls made to the given domain. |
| 1595 | "domain": "A String", # The domain name. |
| 1596 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 1597 | }, |
| 1598 | ], |
| 1599 | }, |
| 1600 | }, |
| 1601 | ], |
| 1602 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 1603 | }, |
| 1604 | ], |
| 1605 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 1606 | }, |
| 1607 | "detectedAttributes": [ # Publisher-excludable attributes that were detected for this creative. Can be used to filter the response of the creatives.list method. If the `excluded_attribute` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) contains one of the attributes that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 1608 | "A String", |
| 1609 | ], |
| 1610 | "lastStatusUpdate": "A String", # The last time the creative status was updated. Can be used to filter the response of the creatives.list method. |
| 1611 | "detectedSensitiveCategories": [ # Detected sensitive categories, if any. Can be used to filter the response of the creatives.list method. 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. |
| 1612 | 42, |
| 1613 | ], |
| 1614 | "detectedProductCategories": [ # Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs. Can be used to filter the response of the creatives.list method. |
| 1615 | 42, |
| 1616 | ], |
| 1617 | "detectedDomains": [ # The detected domains for this creative. |
| 1618 | "A String", |
| 1619 | ], |
| 1620 | "detectedLanguages": [ # 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. Can be used to filter the response of the creatives.list method. |
| 1621 | "A String", |
| 1622 | ], |
| 1623 | "detectedVendorIds": [ # IDs of the ad technology vendors that were detected to be used by this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. Can be used to filter the response of the creatives.list method. If the `allowed_vendor_type` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) does not contain one of the vendor type IDs that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 1624 | 42, |
| 1625 | ], |
| 1626 | "detectedClickThroughUrls": [ # The set of detected destination URLs for the creative. Can be used to filter the response of the creatives.list method. |
| 1627 | "A String", |
| 1628 | ], |
| 1629 | "networkPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding in open auction, private auction, or auction packages (outside of Russia and China). |
| 1630 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 1631 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 1632 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 1633 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 1634 | { # Evidence associated with a policy topic entry. |
| 1635 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 1636 | "urls": [ # URLs of HTTP calls made by the creative. |
| 1637 | "A String", |
| 1638 | ], |
| 1639 | }, |
| 1640 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 1641 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 1642 | }, |
| 1643 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 1644 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 1645 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 1646 | "A String", |
| 1647 | ], |
| 1648 | }, |
| 1649 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 1650 | "crawlTime": "A String", # Approximate time of the crawl. |
| 1651 | "reason": "A String", # Reason of destination not crawlable. |
| 1652 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 1653 | }, |
| 1654 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 1655 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 1656 | "expandedUrl": "A String", # The full non-working URL. |
| 1657 | "dnsError": "A String", # DNS lookup errors. |
| 1658 | "redirectionError": "A String", # HTTP redirect chain error. |
| 1659 | "platform": "A String", # Platform of the non-working URL. |
| 1660 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 1661 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 1662 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 1663 | }, |
| 1664 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 1665 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 1666 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 1667 | { # The URL-level breakdown for the download size. |
| 1668 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 1669 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 1670 | }, |
| 1671 | ], |
| 1672 | }, |
| 1673 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 1674 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 1675 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 1676 | { # The number of HTTP calls made to the given domain. |
| 1677 | "domain": "A String", # The domain name. |
| 1678 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 1679 | }, |
| 1680 | ], |
| 1681 | }, |
| 1682 | }, |
| 1683 | ], |
| 1684 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 1685 | }, |
| 1686 | ], |
| 1687 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 1688 | }, |
| 1689 | "russiaPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # The policy compliance of this creative in Russia. When approved or disapproved, this applies to both deals and open auction in Russia. When pending review, this creative is allowed to serve for deals but not for open auction. |
| 1690 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 1691 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 1692 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 1693 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 1694 | { # Evidence associated with a policy topic entry. |
| 1695 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 1696 | "urls": [ # URLs of HTTP calls made by the creative. |
| 1697 | "A String", |
| 1698 | ], |
| 1699 | }, |
| 1700 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 1701 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 1702 | }, |
| 1703 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 1704 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 1705 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 1706 | "A String", |
| 1707 | ], |
| 1708 | }, |
| 1709 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 1710 | "crawlTime": "A String", # Approximate time of the crawl. |
| 1711 | "reason": "A String", # Reason of destination not crawlable. |
| 1712 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 1713 | }, |
| 1714 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 1715 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 1716 | "expandedUrl": "A String", # The full non-working URL. |
| 1717 | "dnsError": "A String", # DNS lookup errors. |
| 1718 | "redirectionError": "A String", # HTTP redirect chain error. |
| 1719 | "platform": "A String", # Platform of the non-working URL. |
| 1720 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 1721 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 1722 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 1723 | }, |
| 1724 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 1725 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 1726 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 1727 | { # The URL-level breakdown for the download size. |
| 1728 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 1729 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 1730 | }, |
| 1731 | ], |
| 1732 | }, |
| 1733 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 1734 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 1735 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 1736 | { # The number of HTTP calls made to the given domain. |
| 1737 | "domain": "A String", # The domain name. |
| 1738 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 1739 | }, |
| 1740 | ], |
| 1741 | }, |
| 1742 | }, |
| 1743 | ], |
| 1744 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 1745 | }, |
| 1746 | ], |
| 1747 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 1748 | }, |
| 1749 | "detectedAdvertisers": [ # Detected advertisers and brands. |
| 1750 | { # Detected advertiser and brand information. |
| 1751 | "advertiserId": "A String", # See https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt for the list of possible values. Can be used to filter the response of the creatives.list method. |
| 1752 | "advertiserName": "A String", # Advertiser name. Can be used to filter the response of the creatives.list method. |
| 1753 | "brandId": "A String", # Detected brand ID or zero if no brand has been detected. See https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt for the list of possible values. Can be used to filter the response of the creatives.list method. |
| 1754 | "brandName": "A String", # Brand name. Can be used to filter the response of the creatives.list method. |
| 1755 | }, |
| 1756 | ], |
| 1757 | }, |
| 1758 | "dealIds": [ # Output only. IDs of all of the deals with which this creative has been used in bidding. Can be used to filter the response of the creatives.list method. |
| 1759 | "A String", |
| 1760 | ], |
| 1761 | "creativeFormat": "A String", # Output only. The format of this creative. Can be used to filter the response of the creatives.list method. |
| 1762 | "native": { # Native content for a creative. # A native creative. |
| 1763 | "headline": "A String", # A short title for the ad. |
| 1764 | "clickTrackingUrl": "A String", # The URL to use for click tracking. |
| 1765 | "body": "A String", # A long description of the ad. |
| 1766 | "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. |
| 1767 | "height": 42, # Image height in pixels. |
| 1768 | "width": 42, # Image width in pixels. |
| 1769 | "url": "A String", # The URL of the image. |
| 1770 | }, |
| 1771 | "priceDisplayText": "A String", # The price of the promoted app including currency info. |
| 1772 | "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative. |
| 1773 | "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. |
| 1774 | "height": 42, # Image height in pixels. |
| 1775 | "width": 42, # Image width in pixels. |
| 1776 | "url": "A String", # The URL of the image. |
| 1777 | }, |
| 1778 | "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image. |
| 1779 | "height": 42, # Image height in pixels. |
| 1780 | "width": 42, # Image width in pixels. |
| 1781 | "url": "A String", # The URL of the image. |
| 1782 | }, |
| 1783 | "callToAction": "A String", # A label for the button that the user is supposed to click. |
| 1784 | "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad. |
| 1785 | "videoUrl": "A String", # The URL to fetch a native video ad. |
| 1786 | "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5]. |
| 1787 | }, |
| 1788 | "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative. Can be used to filter the response of the creatives.list method. |
| 1789 | "A String", |
| 1790 | ], |
| 1791 | "agencyId": "A String", # The agency ID for this creative. |
| 1792 | "creativeId": "A String", # Buyer-specific creative ID that references this creative in bid responses. This field is Ignored in update operations. Can be used to filter the response of the creatives.list method. The maximum length of the creative ID is 128 bytes. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1793 | "video": { # Video content for a creative. # A video creative. |
| 1794 | "videoUrl": "A String", # The URL to fetch a video ad. |
| 1795 | "videoMetadata": { # Video metadata for a creative. # Output only. Video metadata. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 1796 | "isValidVast": True or False, # Is this a valid VAST ad? Can be used to filter the response of the creatives.list method. |
| 1797 | "vastVersion": "A String", # The maximum VAST version across all wrapped VAST documents. Can be used to filter the response of the creatives.list method. |
| 1798 | "skipOffset": "A String", # The minimum duration that the user has to watch before being able to skip this ad. If the field is not set, the ad is not skippable. If the field is set, the ad is skippable. Can be used to filter the response of the creatives.list method. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1799 | "mediaFiles": [ # The list of all media files declared in the VAST. If there are multiple VASTs in a wrapper chain, this includes the media files from the deepest one in the chain. |
| 1800 | { # Information about each media file in the VAST. |
| 1801 | "bitrate": "A String", # Bitrate of the video file, in Kbps. Can be used to filter the response of the creatives.list method. |
| 1802 | "mimeType": "A String", # The MIME type of this media file. Can be used to filter the response of the creatives.list method. |
| 1803 | }, |
| 1804 | ], |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 1805 | "duration": "A String", # The duration of the ad. Can be used to filter the response of the creatives.list method. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 1806 | "isVpaid": True or False, # Is this a VPAID ad? Can be used to filter the response of the creatives.list method. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1807 | }, |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 1808 | "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. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1809 | }, |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 1810 | "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative. |
| 1811 | "A String", |
| 1812 | ], |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 1813 | }, |
| 1814 | ], |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 1815 | "nextPageToken": "A String", # A token to retrieve the next page of results. Pass this value in the ListCreativesRequest.pageToken field in the subsequent call to the `ListCreatives` method to retrieve the next page of results. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 1816 | }</pre> |
| 1817 | </div> |
| 1818 | |
| 1819 | <div class="method"> |
| 1820 | <code class="details" id="list_next">list_next(previous_request, previous_response)</code> |
| 1821 | <pre>Retrieves the next page of results. |
| 1822 | |
| 1823 | Args: |
| 1824 | previous_request: The request for the previous page. (required) |
| 1825 | previous_response: The response from the request for the previous page. (required) |
| 1826 | |
| 1827 | Returns: |
| 1828 | A request object that you can call 'execute()' on to request the next |
| 1829 | page. Returns None if there are no more items in the collection. |
| 1830 | </pre> |
| 1831 | </div> |
| 1832 | |
| 1833 | <div class="method"> |
| 1834 | <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code> |
| 1835 | <pre>Updates a creative. |
| 1836 | |
| 1837 | Args: |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 1838 | name: string, Output only. Name of the creative. Follows the pattern `buyers/{buyer}/creatives/{creative}`, where `{buyer}` represents the account ID of the buyer who owns the creative, and `{creative}` is the buyer-specific creative ID that references this creative in the bid response. (required) |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 1839 | body: object, The request body. |
| 1840 | The object takes the form of: |
| 1841 | |
| 1842 | { # A creative and its classification data. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 1843 | "declaredRestrictedCategories": [ # All declared restricted categories for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 1844 | "A String", |
| 1845 | ], |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 1846 | "declaredAttributes": [ # All declared attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. If the `excluded_attribute` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto") contains one of the attributes that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 1847 | "A String", |
| 1848 | ], |
| 1849 | "impressionTrackingUrls": [ # The set of URLs to be called to record an impression. |
| 1850 | "A String", |
| 1851 | ], |
| 1852 | "html": { # HTML content for a creative. # An HTML creative. |
| 1853 | "width": 42, # The width of the HTML snippet in pixels. Can be used to filter the response of the creatives.list method. |
| 1854 | "height": 42, # The height of the HTML snippet in pixels. Can be used to filter the response of the creatives.list method. |
| 1855 | "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. |
| 1856 | }, |
| 1857 | "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API. |
| 1858 | "accountId": "A String", # Output only. ID of the buyer account that this creative is owned by. Can be used to filter the response of the creatives.list method with equality and inequality check. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1859 | "declaredVendorIds": [ # IDs for the declared ad technology vendors that may be used by this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. Can be used to filter the response of the creatives.list method. |
| 1860 | 42, |
| 1861 | ], |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 1862 | "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page. This is only supported for native ads. |
| 1863 | "advertiserName": "A String", # The name of the company being advertised in the creative. Can be used to filter the response of the creatives.list method. |
| 1864 | "name": "A String", # Output only. Name of the creative. Follows the pattern `buyers/{buyer}/creatives/{creative}`, where `{buyer}` represents the account ID of the buyer who owns the creative, and `{creative}` is the buyer-specific creative ID that references this creative in the bid response. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 1865 | "version": 42, # Output only. The version of this creative. Version for a new creative is 1 and it increments during subsequent creative updates. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 1866 | "creativeServingDecision": { # Top level status and detected attributes of a creative. # Output only. Top level status and detected attributes of a creative (for example domain, language, advertiser, product category, etc.) that affect whether (status) and where (context) a creative will be allowed to serve. |
| 1867 | "dealsPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding on Programmatic Guaranteed and Preferred Deals (outside of Russia and China). |
| 1868 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 1869 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 1870 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 1871 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 1872 | { # Evidence associated with a policy topic entry. |
| 1873 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 1874 | "urls": [ # URLs of HTTP calls made by the creative. |
| 1875 | "A String", |
| 1876 | ], |
| 1877 | }, |
| 1878 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 1879 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 1880 | }, |
| 1881 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 1882 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 1883 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 1884 | "A String", |
| 1885 | ], |
| 1886 | }, |
| 1887 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 1888 | "crawlTime": "A String", # Approximate time of the crawl. |
| 1889 | "reason": "A String", # Reason of destination not crawlable. |
| 1890 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 1891 | }, |
| 1892 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 1893 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 1894 | "expandedUrl": "A String", # The full non-working URL. |
| 1895 | "dnsError": "A String", # DNS lookup errors. |
| 1896 | "redirectionError": "A String", # HTTP redirect chain error. |
| 1897 | "platform": "A String", # Platform of the non-working URL. |
| 1898 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 1899 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 1900 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 1901 | }, |
| 1902 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 1903 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 1904 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 1905 | { # The URL-level breakdown for the download size. |
| 1906 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 1907 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 1908 | }, |
| 1909 | ], |
| 1910 | }, |
| 1911 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 1912 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 1913 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 1914 | { # The number of HTTP calls made to the given domain. |
| 1915 | "domain": "A String", # The domain name. |
| 1916 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 1917 | }, |
| 1918 | ], |
| 1919 | }, |
| 1920 | }, |
| 1921 | ], |
| 1922 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 1923 | }, |
| 1924 | ], |
| 1925 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 1926 | }, |
| 1927 | "platformPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding in Open Bidding (outside of Russia and China). For the list of platform policies, see: https://support.google.com/platformspolicy/answer/3013851. |
| 1928 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 1929 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 1930 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 1931 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 1932 | { # Evidence associated with a policy topic entry. |
| 1933 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 1934 | "urls": [ # URLs of HTTP calls made by the creative. |
| 1935 | "A String", |
| 1936 | ], |
| 1937 | }, |
| 1938 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 1939 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 1940 | }, |
| 1941 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 1942 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 1943 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 1944 | "A String", |
| 1945 | ], |
| 1946 | }, |
| 1947 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 1948 | "crawlTime": "A String", # Approximate time of the crawl. |
| 1949 | "reason": "A String", # Reason of destination not crawlable. |
| 1950 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 1951 | }, |
| 1952 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 1953 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 1954 | "expandedUrl": "A String", # The full non-working URL. |
| 1955 | "dnsError": "A String", # DNS lookup errors. |
| 1956 | "redirectionError": "A String", # HTTP redirect chain error. |
| 1957 | "platform": "A String", # Platform of the non-working URL. |
| 1958 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 1959 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 1960 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 1961 | }, |
| 1962 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 1963 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 1964 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 1965 | { # The URL-level breakdown for the download size. |
| 1966 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 1967 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 1968 | }, |
| 1969 | ], |
| 1970 | }, |
| 1971 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 1972 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 1973 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 1974 | { # The number of HTTP calls made to the given domain. |
| 1975 | "domain": "A String", # The domain name. |
| 1976 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 1977 | }, |
| 1978 | ], |
| 1979 | }, |
| 1980 | }, |
| 1981 | ], |
| 1982 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 1983 | }, |
| 1984 | ], |
| 1985 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 1986 | }, |
| 1987 | "chinaPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # The policy compliance of this creative in China. When approved or disapproved, this applies to both deals and open auction in China. When pending review, this creative is allowed to serve for deals but not for open auction. |
| 1988 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 1989 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 1990 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 1991 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 1992 | { # Evidence associated with a policy topic entry. |
| 1993 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 1994 | "urls": [ # URLs of HTTP calls made by the creative. |
| 1995 | "A String", |
| 1996 | ], |
| 1997 | }, |
| 1998 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 1999 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 2000 | }, |
| 2001 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 2002 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 2003 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 2004 | "A String", |
| 2005 | ], |
| 2006 | }, |
| 2007 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 2008 | "crawlTime": "A String", # Approximate time of the crawl. |
| 2009 | "reason": "A String", # Reason of destination not crawlable. |
| 2010 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 2011 | }, |
| 2012 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 2013 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 2014 | "expandedUrl": "A String", # The full non-working URL. |
| 2015 | "dnsError": "A String", # DNS lookup errors. |
| 2016 | "redirectionError": "A String", # HTTP redirect chain error. |
| 2017 | "platform": "A String", # Platform of the non-working URL. |
| 2018 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 2019 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 2020 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 2021 | }, |
| 2022 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 2023 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 2024 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 2025 | { # The URL-level breakdown for the download size. |
| 2026 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 2027 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 2028 | }, |
| 2029 | ], |
| 2030 | }, |
| 2031 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 2032 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 2033 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 2034 | { # The number of HTTP calls made to the given domain. |
| 2035 | "domain": "A String", # The domain name. |
| 2036 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 2037 | }, |
| 2038 | ], |
| 2039 | }, |
| 2040 | }, |
| 2041 | ], |
| 2042 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 2043 | }, |
| 2044 | ], |
| 2045 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 2046 | }, |
| 2047 | "detectedAttributes": [ # Publisher-excludable attributes that were detected for this creative. Can be used to filter the response of the creatives.list method. If the `excluded_attribute` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) contains one of the attributes that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 2048 | "A String", |
| 2049 | ], |
| 2050 | "lastStatusUpdate": "A String", # The last time the creative status was updated. Can be used to filter the response of the creatives.list method. |
| 2051 | "detectedSensitiveCategories": [ # Detected sensitive categories, if any. Can be used to filter the response of the creatives.list method. 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. |
| 2052 | 42, |
| 2053 | ], |
| 2054 | "detectedProductCategories": [ # Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs. Can be used to filter the response of the creatives.list method. |
| 2055 | 42, |
| 2056 | ], |
| 2057 | "detectedDomains": [ # The detected domains for this creative. |
| 2058 | "A String", |
| 2059 | ], |
| 2060 | "detectedLanguages": [ # 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. Can be used to filter the response of the creatives.list method. |
| 2061 | "A String", |
| 2062 | ], |
| 2063 | "detectedVendorIds": [ # IDs of the ad technology vendors that were detected to be used by this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. Can be used to filter the response of the creatives.list method. If the `allowed_vendor_type` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) does not contain one of the vendor type IDs that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 2064 | 42, |
| 2065 | ], |
| 2066 | "detectedClickThroughUrls": [ # The set of detected destination URLs for the creative. Can be used to filter the response of the creatives.list method. |
| 2067 | "A String", |
| 2068 | ], |
| 2069 | "networkPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding in open auction, private auction, or auction packages (outside of Russia and China). |
| 2070 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 2071 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 2072 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 2073 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 2074 | { # Evidence associated with a policy topic entry. |
| 2075 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 2076 | "urls": [ # URLs of HTTP calls made by the creative. |
| 2077 | "A String", |
| 2078 | ], |
| 2079 | }, |
| 2080 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 2081 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 2082 | }, |
| 2083 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 2084 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 2085 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 2086 | "A String", |
| 2087 | ], |
| 2088 | }, |
| 2089 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 2090 | "crawlTime": "A String", # Approximate time of the crawl. |
| 2091 | "reason": "A String", # Reason of destination not crawlable. |
| 2092 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 2093 | }, |
| 2094 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 2095 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 2096 | "expandedUrl": "A String", # The full non-working URL. |
| 2097 | "dnsError": "A String", # DNS lookup errors. |
| 2098 | "redirectionError": "A String", # HTTP redirect chain error. |
| 2099 | "platform": "A String", # Platform of the non-working URL. |
| 2100 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 2101 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 2102 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 2103 | }, |
| 2104 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 2105 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 2106 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 2107 | { # The URL-level breakdown for the download size. |
| 2108 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 2109 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 2110 | }, |
| 2111 | ], |
| 2112 | }, |
| 2113 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 2114 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 2115 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 2116 | { # The number of HTTP calls made to the given domain. |
| 2117 | "domain": "A String", # The domain name. |
| 2118 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 2119 | }, |
| 2120 | ], |
| 2121 | }, |
| 2122 | }, |
| 2123 | ], |
| 2124 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 2125 | }, |
| 2126 | ], |
| 2127 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 2128 | }, |
| 2129 | "russiaPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # The policy compliance of this creative in Russia. When approved or disapproved, this applies to both deals and open auction in Russia. When pending review, this creative is allowed to serve for deals but not for open auction. |
| 2130 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 2131 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 2132 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 2133 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 2134 | { # Evidence associated with a policy topic entry. |
| 2135 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 2136 | "urls": [ # URLs of HTTP calls made by the creative. |
| 2137 | "A String", |
| 2138 | ], |
| 2139 | }, |
| 2140 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 2141 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 2142 | }, |
| 2143 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 2144 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 2145 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 2146 | "A String", |
| 2147 | ], |
| 2148 | }, |
| 2149 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 2150 | "crawlTime": "A String", # Approximate time of the crawl. |
| 2151 | "reason": "A String", # Reason of destination not crawlable. |
| 2152 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 2153 | }, |
| 2154 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 2155 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 2156 | "expandedUrl": "A String", # The full non-working URL. |
| 2157 | "dnsError": "A String", # DNS lookup errors. |
| 2158 | "redirectionError": "A String", # HTTP redirect chain error. |
| 2159 | "platform": "A String", # Platform of the non-working URL. |
| 2160 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 2161 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 2162 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 2163 | }, |
| 2164 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 2165 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 2166 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 2167 | { # The URL-level breakdown for the download size. |
| 2168 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 2169 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 2170 | }, |
| 2171 | ], |
| 2172 | }, |
| 2173 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 2174 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 2175 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 2176 | { # The number of HTTP calls made to the given domain. |
| 2177 | "domain": "A String", # The domain name. |
| 2178 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 2179 | }, |
| 2180 | ], |
| 2181 | }, |
| 2182 | }, |
| 2183 | ], |
| 2184 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 2185 | }, |
| 2186 | ], |
| 2187 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 2188 | }, |
| 2189 | "detectedAdvertisers": [ # Detected advertisers and brands. |
| 2190 | { # Detected advertiser and brand information. |
| 2191 | "advertiserId": "A String", # See https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt for the list of possible values. Can be used to filter the response of the creatives.list method. |
| 2192 | "advertiserName": "A String", # Advertiser name. Can be used to filter the response of the creatives.list method. |
| 2193 | "brandId": "A String", # Detected brand ID or zero if no brand has been detected. See https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt for the list of possible values. Can be used to filter the response of the creatives.list method. |
| 2194 | "brandName": "A String", # Brand name. Can be used to filter the response of the creatives.list method. |
| 2195 | }, |
| 2196 | ], |
| 2197 | }, |
| 2198 | "dealIds": [ # Output only. IDs of all of the deals with which this creative has been used in bidding. Can be used to filter the response of the creatives.list method. |
| 2199 | "A String", |
| 2200 | ], |
| 2201 | "creativeFormat": "A String", # Output only. The format of this creative. Can be used to filter the response of the creatives.list method. |
| 2202 | "native": { # Native content for a creative. # A native creative. |
| 2203 | "headline": "A String", # A short title for the ad. |
| 2204 | "clickTrackingUrl": "A String", # The URL to use for click tracking. |
| 2205 | "body": "A String", # A long description of the ad. |
| 2206 | "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. |
| 2207 | "height": 42, # Image height in pixels. |
| 2208 | "width": 42, # Image width in pixels. |
| 2209 | "url": "A String", # The URL of the image. |
| 2210 | }, |
| 2211 | "priceDisplayText": "A String", # The price of the promoted app including currency info. |
| 2212 | "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative. |
| 2213 | "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. |
| 2214 | "height": 42, # Image height in pixels. |
| 2215 | "width": 42, # Image width in pixels. |
| 2216 | "url": "A String", # The URL of the image. |
| 2217 | }, |
| 2218 | "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image. |
| 2219 | "height": 42, # Image height in pixels. |
| 2220 | "width": 42, # Image width in pixels. |
| 2221 | "url": "A String", # The URL of the image. |
| 2222 | }, |
| 2223 | "callToAction": "A String", # A label for the button that the user is supposed to click. |
| 2224 | "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad. |
| 2225 | "videoUrl": "A String", # The URL to fetch a native video ad. |
| 2226 | "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5]. |
| 2227 | }, |
| 2228 | "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative. Can be used to filter the response of the creatives.list method. |
| 2229 | "A String", |
| 2230 | ], |
| 2231 | "agencyId": "A String", # The agency ID for this creative. |
| 2232 | "creativeId": "A String", # Buyer-specific creative ID that references this creative in bid responses. This field is Ignored in update operations. Can be used to filter the response of the creatives.list method. The maximum length of the creative ID is 128 bytes. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 2233 | "video": { # Video content for a creative. # A video creative. |
| 2234 | "videoUrl": "A String", # The URL to fetch a video ad. |
| 2235 | "videoMetadata": { # Video metadata for a creative. # Output only. Video metadata. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 2236 | "isValidVast": True or False, # Is this a valid VAST ad? Can be used to filter the response of the creatives.list method. |
| 2237 | "vastVersion": "A String", # The maximum VAST version across all wrapped VAST documents. Can be used to filter the response of the creatives.list method. |
| 2238 | "skipOffset": "A String", # The minimum duration that the user has to watch before being able to skip this ad. If the field is not set, the ad is not skippable. If the field is set, the ad is skippable. Can be used to filter the response of the creatives.list method. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 2239 | "mediaFiles": [ # The list of all media files declared in the VAST. If there are multiple VASTs in a wrapper chain, this includes the media files from the deepest one in the chain. |
| 2240 | { # Information about each media file in the VAST. |
| 2241 | "bitrate": "A String", # Bitrate of the video file, in Kbps. Can be used to filter the response of the creatives.list method. |
| 2242 | "mimeType": "A String", # The MIME type of this media file. Can be used to filter the response of the creatives.list method. |
| 2243 | }, |
| 2244 | ], |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 2245 | "duration": "A String", # The duration of the ad. Can be used to filter the response of the creatives.list method. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 2246 | "isVpaid": True or False, # Is this a VPAID ad? Can be used to filter the response of the creatives.list method. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 2247 | }, |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 2248 | "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. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 2249 | }, |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 2250 | "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative. |
| 2251 | "A String", |
| 2252 | ], |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 2253 | } |
| 2254 | |
| 2255 | updateMask: string, Field mask to use for partial in-place updates. |
| 2256 | x__xgafv: string, V1 error format. |
| 2257 | Allowed values |
| 2258 | 1 - v1 error format |
| 2259 | 2 - v2 error format |
| 2260 | |
| 2261 | Returns: |
| 2262 | An object of the form: |
| 2263 | |
| 2264 | { # A creative and its classification data. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 2265 | "declaredRestrictedCategories": [ # All declared restricted categories for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 2266 | "A String", |
| 2267 | ], |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 2268 | "declaredAttributes": [ # All declared attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method. If the `excluded_attribute` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto") contains one of the attributes that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 2269 | "A String", |
| 2270 | ], |
| 2271 | "impressionTrackingUrls": [ # The set of URLs to be called to record an impression. |
| 2272 | "A String", |
| 2273 | ], |
| 2274 | "html": { # HTML content for a creative. # An HTML creative. |
| 2275 | "width": 42, # The width of the HTML snippet in pixels. Can be used to filter the response of the creatives.list method. |
| 2276 | "height": 42, # The height of the HTML snippet in pixels. Can be used to filter the response of the creatives.list method. |
| 2277 | "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page. |
| 2278 | }, |
| 2279 | "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API. |
| 2280 | "accountId": "A String", # Output only. ID of the buyer account that this creative is owned by. Can be used to filter the response of the creatives.list method with equality and inequality check. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 2281 | "declaredVendorIds": [ # IDs for the declared ad technology vendors that may be used by this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. Can be used to filter the response of the creatives.list method. |
| 2282 | 42, |
| 2283 | ], |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 2284 | "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page. This is only supported for native ads. |
| 2285 | "advertiserName": "A String", # The name of the company being advertised in the creative. Can be used to filter the response of the creatives.list method. |
| 2286 | "name": "A String", # Output only. Name of the creative. Follows the pattern `buyers/{buyer}/creatives/{creative}`, where `{buyer}` represents the account ID of the buyer who owns the creative, and `{creative}` is the buyer-specific creative ID that references this creative in the bid response. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 2287 | "version": 42, # Output only. The version of this creative. Version for a new creative is 1 and it increments during subsequent creative updates. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 2288 | "creativeServingDecision": { # Top level status and detected attributes of a creative. # Output only. Top level status and detected attributes of a creative (for example domain, language, advertiser, product category, etc.) that affect whether (status) and where (context) a creative will be allowed to serve. |
| 2289 | "dealsPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding on Programmatic Guaranteed and Preferred Deals (outside of Russia and China). |
| 2290 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 2291 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 2292 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 2293 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 2294 | { # Evidence associated with a policy topic entry. |
| 2295 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 2296 | "urls": [ # URLs of HTTP calls made by the creative. |
| 2297 | "A String", |
| 2298 | ], |
| 2299 | }, |
| 2300 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 2301 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 2302 | }, |
| 2303 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 2304 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 2305 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 2306 | "A String", |
| 2307 | ], |
| 2308 | }, |
| 2309 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 2310 | "crawlTime": "A String", # Approximate time of the crawl. |
| 2311 | "reason": "A String", # Reason of destination not crawlable. |
| 2312 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 2313 | }, |
| 2314 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 2315 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 2316 | "expandedUrl": "A String", # The full non-working URL. |
| 2317 | "dnsError": "A String", # DNS lookup errors. |
| 2318 | "redirectionError": "A String", # HTTP redirect chain error. |
| 2319 | "platform": "A String", # Platform of the non-working URL. |
| 2320 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 2321 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 2322 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 2323 | }, |
| 2324 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 2325 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 2326 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 2327 | { # The URL-level breakdown for the download size. |
| 2328 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 2329 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 2330 | }, |
| 2331 | ], |
| 2332 | }, |
| 2333 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 2334 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 2335 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 2336 | { # The number of HTTP calls made to the given domain. |
| 2337 | "domain": "A String", # The domain name. |
| 2338 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 2339 | }, |
| 2340 | ], |
| 2341 | }, |
| 2342 | }, |
| 2343 | ], |
| 2344 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 2345 | }, |
| 2346 | ], |
| 2347 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 2348 | }, |
| 2349 | "platformPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding in Open Bidding (outside of Russia and China). For the list of platform policies, see: https://support.google.com/platformspolicy/answer/3013851. |
| 2350 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 2351 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 2352 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 2353 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 2354 | { # Evidence associated with a policy topic entry. |
| 2355 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 2356 | "urls": [ # URLs of HTTP calls made by the creative. |
| 2357 | "A String", |
| 2358 | ], |
| 2359 | }, |
| 2360 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 2361 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 2362 | }, |
| 2363 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 2364 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 2365 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 2366 | "A String", |
| 2367 | ], |
| 2368 | }, |
| 2369 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 2370 | "crawlTime": "A String", # Approximate time of the crawl. |
| 2371 | "reason": "A String", # Reason of destination not crawlable. |
| 2372 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 2373 | }, |
| 2374 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 2375 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 2376 | "expandedUrl": "A String", # The full non-working URL. |
| 2377 | "dnsError": "A String", # DNS lookup errors. |
| 2378 | "redirectionError": "A String", # HTTP redirect chain error. |
| 2379 | "platform": "A String", # Platform of the non-working URL. |
| 2380 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 2381 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 2382 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 2383 | }, |
| 2384 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 2385 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 2386 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 2387 | { # The URL-level breakdown for the download size. |
| 2388 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 2389 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 2390 | }, |
| 2391 | ], |
| 2392 | }, |
| 2393 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 2394 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 2395 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 2396 | { # The number of HTTP calls made to the given domain. |
| 2397 | "domain": "A String", # The domain name. |
| 2398 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 2399 | }, |
| 2400 | ], |
| 2401 | }, |
| 2402 | }, |
| 2403 | ], |
| 2404 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 2405 | }, |
| 2406 | ], |
| 2407 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 2408 | }, |
| 2409 | "chinaPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # The policy compliance of this creative in China. When approved or disapproved, this applies to both deals and open auction in China. When pending review, this creative is allowed to serve for deals but not for open auction. |
| 2410 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 2411 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 2412 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 2413 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 2414 | { # Evidence associated with a policy topic entry. |
| 2415 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 2416 | "urls": [ # URLs of HTTP calls made by the creative. |
| 2417 | "A String", |
| 2418 | ], |
| 2419 | }, |
| 2420 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 2421 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 2422 | }, |
| 2423 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 2424 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 2425 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 2426 | "A String", |
| 2427 | ], |
| 2428 | }, |
| 2429 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 2430 | "crawlTime": "A String", # Approximate time of the crawl. |
| 2431 | "reason": "A String", # Reason of destination not crawlable. |
| 2432 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 2433 | }, |
| 2434 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 2435 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 2436 | "expandedUrl": "A String", # The full non-working URL. |
| 2437 | "dnsError": "A String", # DNS lookup errors. |
| 2438 | "redirectionError": "A String", # HTTP redirect chain error. |
| 2439 | "platform": "A String", # Platform of the non-working URL. |
| 2440 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 2441 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 2442 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 2443 | }, |
| 2444 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 2445 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 2446 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 2447 | { # The URL-level breakdown for the download size. |
| 2448 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 2449 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 2450 | }, |
| 2451 | ], |
| 2452 | }, |
| 2453 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 2454 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 2455 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 2456 | { # The number of HTTP calls made to the given domain. |
| 2457 | "domain": "A String", # The domain name. |
| 2458 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 2459 | }, |
| 2460 | ], |
| 2461 | }, |
| 2462 | }, |
| 2463 | ], |
| 2464 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 2465 | }, |
| 2466 | ], |
| 2467 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 2468 | }, |
| 2469 | "detectedAttributes": [ # Publisher-excludable attributes that were detected for this creative. Can be used to filter the response of the creatives.list method. If the `excluded_attribute` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) contains one of the attributes that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 2470 | "A String", |
| 2471 | ], |
| 2472 | "lastStatusUpdate": "A String", # The last time the creative status was updated. Can be used to filter the response of the creatives.list method. |
| 2473 | "detectedSensitiveCategories": [ # Detected sensitive categories, if any. Can be used to filter the response of the creatives.list method. 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. |
| 2474 | 42, |
| 2475 | ], |
| 2476 | "detectedProductCategories": [ # Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs. Can be used to filter the response of the creatives.list method. |
| 2477 | 42, |
| 2478 | ], |
| 2479 | "detectedDomains": [ # The detected domains for this creative. |
| 2480 | "A String", |
| 2481 | ], |
| 2482 | "detectedLanguages": [ # 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. Can be used to filter the response of the creatives.list method. |
| 2483 | "A String", |
| 2484 | ], |
| 2485 | "detectedVendorIds": [ # IDs of the ad technology vendors that were detected to be used by this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values. Can be used to filter the response of the creatives.list method. If the `allowed_vendor_type` field of a [bid request](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) does not contain one of the vendor type IDs that were declared or detected for a given creative, and a bid is submitted with that creative, the bid will be filtered before the auction. |
| 2486 | 42, |
| 2487 | ], |
| 2488 | "detectedClickThroughUrls": [ # The set of detected destination URLs for the creative. Can be used to filter the response of the creatives.list method. |
| 2489 | "A String", |
| 2490 | ], |
| 2491 | "networkPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # Policy compliance of this creative when bidding in open auction, private auction, or auction packages (outside of Russia and China). |
| 2492 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 2493 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 2494 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 2495 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 2496 | { # Evidence associated with a policy topic entry. |
| 2497 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 2498 | "urls": [ # URLs of HTTP calls made by the creative. |
| 2499 | "A String", |
| 2500 | ], |
| 2501 | }, |
| 2502 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 2503 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 2504 | }, |
| 2505 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 2506 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 2507 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 2508 | "A String", |
| 2509 | ], |
| 2510 | }, |
| 2511 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 2512 | "crawlTime": "A String", # Approximate time of the crawl. |
| 2513 | "reason": "A String", # Reason of destination not crawlable. |
| 2514 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 2515 | }, |
| 2516 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 2517 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 2518 | "expandedUrl": "A String", # The full non-working URL. |
| 2519 | "dnsError": "A String", # DNS lookup errors. |
| 2520 | "redirectionError": "A String", # HTTP redirect chain error. |
| 2521 | "platform": "A String", # Platform of the non-working URL. |
| 2522 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 2523 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 2524 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 2525 | }, |
| 2526 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 2527 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 2528 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 2529 | { # The URL-level breakdown for the download size. |
| 2530 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 2531 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 2532 | }, |
| 2533 | ], |
| 2534 | }, |
| 2535 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 2536 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 2537 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 2538 | { # The number of HTTP calls made to the given domain. |
| 2539 | "domain": "A String", # The domain name. |
| 2540 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 2541 | }, |
| 2542 | ], |
| 2543 | }, |
| 2544 | }, |
| 2545 | ], |
| 2546 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 2547 | }, |
| 2548 | ], |
| 2549 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 2550 | }, |
| 2551 | "russiaPolicyCompliance": { # Policy compliance of the creative for a transaction type or a region. # The policy compliance of this creative in Russia. When approved or disapproved, this applies to both deals and open auction in Russia. When pending review, this creative is allowed to serve for deals but not for open auction. |
| 2552 | "topics": [ # Topics related to the policy compliance for this transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Topics may be present only if status is DISAPPROVED. |
| 2553 | { # Each policy topic entry will represent a violation of a policy topic for a creative, with the policy topic information and optional evidence for the policy violation. |
| 2554 | "helpCenterUrl": "A String", # URL of the help center article describing this policy topic. |
| 2555 | "evidences": [ # Pieces of evidence associated with this policy topic entry. |
| 2556 | { # Evidence associated with a policy topic entry. |
| 2557 | "httpCall": { # HTTP calls made by a creative that resulted in policy violations. # HTTP calls made by the creative that resulted in policy violations. |
| 2558 | "urls": [ # URLs of HTTP calls made by the creative. |
| 2559 | "A String", |
| 2560 | ], |
| 2561 | }, |
| 2562 | "destinationUrl": { # The full landing page URL of the destination. # URL of the actual landing page. |
| 2563 | "destinationUrl": "A String", # The full landing page URL of the destination. |
| 2564 | }, |
| 2565 | "httpCookie": { # Evidence for HTTP cookie-related policy violations. # Evidence for HTTP cookie-related policy violations. |
| 2566 | "maxCookieCount": 42, # The largest number of cookies set by a creative. If this field is set, cookie_names above will be set to the cookie names of top domains with the largest number of cookies. This field will only be set for TOO_MANY_COOKIES policy. |
| 2567 | "cookieNames": [ # Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy, this will be the cookie names of top domains with the largest number of cookies. For other policies, this will be all the cookie names that violate the policy. |
| 2568 | "A String", |
| 2569 | ], |
| 2570 | }, |
| 2571 | "destinationNotCrawlable": { # Evidence that the creative's destination URL was not crawlable by Google. # The creative's destination URL was not crawlable by Google. |
| 2572 | "crawlTime": "A String", # Approximate time of the crawl. |
| 2573 | "reason": "A String", # Reason of destination not crawlable. |
| 2574 | "crawledUrl": "A String", # Destination URL that was attempted to be crawled. |
| 2575 | }, |
| 2576 | "destinationNotWorking": { # Evidence of the creative's destination URL not functioning properly or having been incorrectly set up. # The creative's destination URL did not function properly or was incorrectly set up. |
| 2577 | "invalidPage": "A String", # Page was crawled successfully, but was detected as either a page with no content or an error page. |
| 2578 | "expandedUrl": "A String", # The full non-working URL. |
| 2579 | "dnsError": "A String", # DNS lookup errors. |
| 2580 | "redirectionError": "A String", # HTTP redirect chain error. |
| 2581 | "platform": "A String", # Platform of the non-working URL. |
| 2582 | "httpError": 42, # HTTP error code (e.g. 404 or 5xx) |
| 2583 | "urlRejected": "A String", # Rejected because of malformed URLs or invalid requests. |
| 2584 | "lastCheckTime": "A String", # Approximate time when the ad destination was last checked. |
| 2585 | }, |
| 2586 | "downloadSize": { # Total download size and URL-level download size breakdown for resources in a creative. # Total download size and URL-level download size breakdown for resources in a creative. |
| 2587 | "totalDownloadSizeKb": 42, # Total download size (in kilobytes) for all the resources in the creative. |
| 2588 | "topUrlDownloadSizeBreakdowns": [ # Download size broken down by URLs with the top download size. |
| 2589 | { # The URL-level breakdown for the download size. |
| 2590 | "normalizedUrl": "A String", # The normalized URL with query parameters and fragment removed. |
| 2591 | "downloadSizeKb": 42, # Download size of the URL in kilobytes. |
| 2592 | }, |
| 2593 | ], |
| 2594 | }, |
| 2595 | "domainCall": { # Number of HTTP calls made by a creative, broken down by domain. # Number of HTTP calls made by the creative, broken down by domain. |
| 2596 | "totalHttpCallCount": 42, # The total number of HTTP calls made by the creative, including but not limited to the number of calls in the top_http_call_domains. |
| 2597 | "topHttpCallDomains": [ # Breakdown of the most frequent domains called via HTTP by the creative. |
| 2598 | { # The number of HTTP calls made to the given domain. |
| 2599 | "domain": "A String", # The domain name. |
| 2600 | "httpCallCount": 42, # Number of HTTP calls made to the domain. |
| 2601 | }, |
| 2602 | ], |
| 2603 | }, |
| 2604 | }, |
| 2605 | ], |
| 2606 | "policyTopic": "A String", # Policy topic this entry refers to. For example, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible policy topics is not fixed for a particular API version and may change at any time. Can be used to filter the response of the creatives.list method |
| 2607 | }, |
| 2608 | ], |
| 2609 | "status": "A String", # Serving status for the given transaction type (e.g., open auction, deals) or region (e.g., China, Russia). Can be used to filter the response of the creatives.list method. |
| 2610 | }, |
| 2611 | "detectedAdvertisers": [ # Detected advertisers and brands. |
| 2612 | { # Detected advertiser and brand information. |
| 2613 | "advertiserId": "A String", # See https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt for the list of possible values. Can be used to filter the response of the creatives.list method. |
| 2614 | "advertiserName": "A String", # Advertiser name. Can be used to filter the response of the creatives.list method. |
| 2615 | "brandId": "A String", # Detected brand ID or zero if no brand has been detected. See https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt for the list of possible values. Can be used to filter the response of the creatives.list method. |
| 2616 | "brandName": "A String", # Brand name. Can be used to filter the response of the creatives.list method. |
| 2617 | }, |
| 2618 | ], |
| 2619 | }, |
| 2620 | "dealIds": [ # Output only. IDs of all of the deals with which this creative has been used in bidding. Can be used to filter the response of the creatives.list method. |
| 2621 | "A String", |
| 2622 | ], |
| 2623 | "creativeFormat": "A String", # Output only. The format of this creative. Can be used to filter the response of the creatives.list method. |
| 2624 | "native": { # Native content for a creative. # A native creative. |
| 2625 | "headline": "A String", # A short title for the ad. |
| 2626 | "clickTrackingUrl": "A String", # The URL to use for click tracking. |
| 2627 | "body": "A String", # A long description of the ad. |
| 2628 | "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. |
| 2629 | "height": 42, # Image height in pixels. |
| 2630 | "width": 42, # Image width in pixels. |
| 2631 | "url": "A String", # The URL of the image. |
| 2632 | }, |
| 2633 | "priceDisplayText": "A String", # The price of the promoted app including currency info. |
| 2634 | "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative. |
| 2635 | "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. |
| 2636 | "height": 42, # Image height in pixels. |
| 2637 | "width": 42, # Image width in pixels. |
| 2638 | "url": "A String", # The URL of the image. |
| 2639 | }, |
| 2640 | "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image. |
| 2641 | "height": 42, # Image height in pixels. |
| 2642 | "width": 42, # Image width in pixels. |
| 2643 | "url": "A String", # The URL of the image. |
| 2644 | }, |
| 2645 | "callToAction": "A String", # A label for the button that the user is supposed to click. |
| 2646 | "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad. |
| 2647 | "videoUrl": "A String", # The URL to fetch a native video ad. |
| 2648 | "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5]. |
| 2649 | }, |
| 2650 | "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative. Can be used to filter the response of the creatives.list method. |
| 2651 | "A String", |
| 2652 | ], |
| 2653 | "agencyId": "A String", # The agency ID for this creative. |
| 2654 | "creativeId": "A String", # Buyer-specific creative ID that references this creative in bid responses. This field is Ignored in update operations. Can be used to filter the response of the creatives.list method. The maximum length of the creative ID is 128 bytes. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 2655 | "video": { # Video content for a creative. # A video creative. |
| 2656 | "videoUrl": "A String", # The URL to fetch a video ad. |
| 2657 | "videoMetadata": { # Video metadata for a creative. # Output only. Video metadata. |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 2658 | "isValidVast": True or False, # Is this a valid VAST ad? Can be used to filter the response of the creatives.list method. |
| 2659 | "vastVersion": "A String", # The maximum VAST version across all wrapped VAST documents. Can be used to filter the response of the creatives.list method. |
| 2660 | "skipOffset": "A String", # The minimum duration that the user has to watch before being able to skip this ad. If the field is not set, the ad is not skippable. If the field is set, the ad is skippable. Can be used to filter the response of the creatives.list method. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 2661 | "mediaFiles": [ # The list of all media files declared in the VAST. If there are multiple VASTs in a wrapper chain, this includes the media files from the deepest one in the chain. |
| 2662 | { # Information about each media file in the VAST. |
| 2663 | "bitrate": "A String", # Bitrate of the video file, in Kbps. Can be used to filter the response of the creatives.list method. |
| 2664 | "mimeType": "A String", # The MIME type of this media file. Can be used to filter the response of the creatives.list method. |
| 2665 | }, |
| 2666 | ], |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 2667 | "duration": "A String", # The duration of the ad. Can be used to filter the response of the creatives.list method. |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 2668 | "isVpaid": True or False, # Is this a VPAID ad? Can be used to filter the response of the creatives.list method. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 2669 | }, |
| Yoshi Automation Bot | c2228be | 2020-11-24 15:48:03 -0800 | [diff] [blame^] | 2670 | "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. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 2671 | }, |
| Bu Sun Kim | 673ec5c | 2020-11-16 11:05:03 -0700 | [diff] [blame] | 2672 | "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative. |
| 2673 | "A String", |
| 2674 | ], |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 2675 | }</pre> |
| 2676 | </div> |
| 2677 | |
| 2678 | </body></html> |