docs: update docs/dyn (#1096)
This PR was generated using Autosynth. :rainbow:
Synth log will be available here:
https://source.cloud.google.com/results/invocations/6f0f288a-a1e8-4b2d-a85f-00b1c6150185/targets
- [ ] To automatically regenerate this PR, check this box.
Source-Link: https://github.com/googleapis/synthtool/commit/39b7149da4026765385403632db3c6f63db96b2c
Source-Link: https://github.com/googleapis/synthtool/commit/9a7d9fbb7045c34c9d3d22c1ff766eeae51f04c9
Source-Link: https://github.com/googleapis/synthtool/commit/dc9903a8c30c3662b6098f0e4a97f221d67268b2
Source-Link: https://github.com/googleapis/synthtool/commit/7fcc405a579d5d53a726ff3da1b7c8c08f0f2d58
Source-Link: https://github.com/googleapis/synthtool/commit/d5fc0bcf9ea9789c5b0e3154a9e3b29e5cea6116
Source-Link: https://github.com/googleapis/synthtool/commit/e89175cf074dccc4babb4eca66ae913696e47a71
Source-Link: https://github.com/googleapis/synthtool/commit/7d652819519dfa24da9e14548232e4aaba71a11c
Source-Link: https://github.com/googleapis/synthtool/commit/7db8a6c5ffb12a6e4c2f799c18f00f7f3d60e279
Source-Link: https://github.com/googleapis/synthtool/commit/1f1148d3c7a7a52f0c98077f976bd9b3c948ee2b
Source-Link: https://github.com/googleapis/synthtool/commit/2c8aecedd55b0480fb4e123b6e07fa5b12953862
Source-Link: https://github.com/googleapis/synthtool/commit/3d3e94c4e02370f307a9a200b0c743c3d8d19f29
Source-Link: https://github.com/googleapis/synthtool/commit/c7824ea48ff6d4d42dfae0849aec8a85acd90bd9
Source-Link: https://github.com/googleapis/synthtool/commit/ba9918cd22874245b55734f57470c719b577e591
Source-Link: https://github.com/googleapis/synthtool/commit/b19b401571e77192f8dd38eab5fb2300a0de9324
Source-Link: https://github.com/googleapis/synthtool/commit/6542bd723403513626f61642fc02ddca528409aa
diff --git a/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html b/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html
index 82ca5d4..c216cf5 100644
--- a/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html
+++ b/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html
@@ -89,7 +89,7 @@
<code><a href="#get">get(accountId, creativeId, x__xgafv=None)</a></code></p>
<p class="firstline">Gets a creative.</p>
<p class="toc_element">
- <code><a href="#list">list(accountId, pageSize=None, pageToken=None, query=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(accountId, pageSize=None, query=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists creatives.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -119,178 +119,178 @@
The object takes the form of:
{ # A creative and its classification data.
- "html": { # HTML content for a creative. # An HTML creative.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- "height": 42, # The height of the HTML snippet in pixels.
- "width": 42, # The width of the HTML snippet in pixels.
- },
- "version": 42, # Output only. The version of this creative.
- "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes.
- "A String",
- ],
- "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
- "A String",
- ],
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "detectedDomains": [ # Output only. The detected domains for this creative.
- "A String",
- ],
- "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction).
- { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction).
- "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
- "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method.
+ "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs.
+ 42,
+ ],
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
+ "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction).
+ { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction).
+ "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead.
+ { # Output only. The reason and details for a disapproval.
+ "reason": "A String", # The categorized reason for disapproval.
"details": [ # Additional details about the reason for disapproval.
"A String",
],
- "reason": "A String", # The categorized reason for disapproval.
},
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
- "platforms": [ # The platforms this restriction applies to.
- "A String",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
- "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
- 42,
- ],
- },
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
- "appTypes": [ # The app types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- },
- ],
- "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead.
- { # Output only. The reason and details for a disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- "reason": "A String", # The categorized reason for disapproval.
- },
- ],
- },
- ],
- "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method.
- "A String",
- ],
- "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values.
- 42,
- ],
- "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
- "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
- "A String",
- ],
- "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "agencyId": "A String", # The agency ID for this creative.
- "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids.
- 42,
- ],
- "corrections": [ # Output only. Shows any corrections that were applied to this creative.
- { # Output only. Shows any corrections that were applied to this creative.
- "contexts": [ # The contexts for the correction.
- { # The serving context for this restriction.
- "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
- "platforms": [ # The platforms this restriction applies to.
- "A String",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
- "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
- 42,
- ],
- },
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
- "appTypes": [ # The app types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- },
- ],
- "type": "A String", # The type of correction that was applied to the creative.
- "details": [ # Additional details about what was corrected.
+ ],
+ "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
+ "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method.
+ "reason": "A String", # The categorized reason for disapproval.
+ "details": [ # Additional details about the reason for disapproval.
"A String",
],
},
+ "contexts": [ # The contexts for the restriction.
+ { # The serving context for this restriction.
+ "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
+ "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
+ 42,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
+ "auctionTypes": [ # The auction types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
+ "platforms": [ # The platforms this restriction applies to.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "video": { # Video content for a creative. # A video creative.
+ "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.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ },
+ "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
+ "A String",
+ ],
+ "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method.
+ "A String",
+ ],
+ "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "native": { # Native content for a creative. # A native creative.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ "body": "A String", # A long description of the ad.
+ "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "headline": "A String", # A short title for the ad.
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
+ "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
+ "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
+ "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.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "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.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ },
+ "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
+ "A String",
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values.
+ 42,
+ ],
+ "clickThroughUrls": [ # The set of destination URLs for the creative.
+ "A String",
+ ],
+ "version": 42, # Output only. The version of this creative.
+ "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids.
+ 42,
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method.
+ "html": { # HTML content for a creative. # An HTML creative.
+ "height": 42, # The height of the HTML snippet in pixels.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ },
+ "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
+ "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction.
+ "A String",
],
- "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
- "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction.
+ "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction.
+ },
+ "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "detectedDomains": [ # Output only. The detected domains for this creative.
+ "A String",
+ ],
+ "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
+ "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
+ "corrections": [ # Output only. Shows any corrections that were applied to this creative.
+ { # Output only. Shows any corrections that were applied to this creative.
+ "details": [ # Additional details about what was corrected.
"A String",
],
- "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
+ "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
+ 42,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
+ "auctionTypes": [ # The auction types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
+ "platforms": [ # The platforms this restriction applies to.
+ "A String",
+ ],
+ },
+ },
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
},
- "native": { # Native content for a creative. # A native creative.
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- "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.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
- "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.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "callToAction": "A String", # A label for the button that the user is supposed to click.
- "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
- "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
- "videoUrl": "A String", # The URL to fetch a native video ad.
- "body": "A String", # A long description of the ad.
- "priceDisplayText": "A String", # The price of the promoted app including currency info.
- "headline": "A String", # A short title for the ad.
- },
- "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
- "A String",
- ],
- "clickThroughUrls": [ # The set of destination URLs for the creative.
- "A String",
- ],
- "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs.
- 42,
- ],
- "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method.
- "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
- "A String",
- ],
- "video": { # Video content for a creative. # A video creative.
- "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.
- "videoUrl": "A String", # The URL to fetch a video ad.
- },
- "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
- }
+ ],
+}
duplicateIdMode: string, Indicates if multiple creatives can share an ID or not. Default is NO_DUPLICATES (one ID per creative).
Allowed values
@@ -305,178 +305,178 @@
An object of the form:
{ # A creative and its classification data.
- "html": { # HTML content for a creative. # An HTML creative.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- "height": 42, # The height of the HTML snippet in pixels.
- "width": 42, # The width of the HTML snippet in pixels.
- },
- "version": 42, # Output only. The version of this creative.
- "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes.
- "A String",
- ],
- "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
- "A String",
- ],
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "detectedDomains": [ # Output only. The detected domains for this creative.
- "A String",
- ],
- "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction).
- { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction).
- "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
- "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method.
+ "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs.
+ 42,
+ ],
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
+ "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction).
+ { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction).
+ "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead.
+ { # Output only. The reason and details for a disapproval.
+ "reason": "A String", # The categorized reason for disapproval.
"details": [ # Additional details about the reason for disapproval.
"A String",
],
- "reason": "A String", # The categorized reason for disapproval.
},
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
- "platforms": [ # The platforms this restriction applies to.
- "A String",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
- "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
- 42,
- ],
- },
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
- "appTypes": [ # The app types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- },
- ],
- "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead.
- { # Output only. The reason and details for a disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- "reason": "A String", # The categorized reason for disapproval.
- },
- ],
- },
- ],
- "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method.
- "A String",
- ],
- "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values.
- 42,
- ],
- "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
- "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
- "A String",
- ],
- "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "agencyId": "A String", # The agency ID for this creative.
- "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids.
- 42,
- ],
- "corrections": [ # Output only. Shows any corrections that were applied to this creative.
- { # Output only. Shows any corrections that were applied to this creative.
- "contexts": [ # The contexts for the correction.
- { # The serving context for this restriction.
- "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
- "platforms": [ # The platforms this restriction applies to.
- "A String",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
- "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
- 42,
- ],
- },
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
- "appTypes": [ # The app types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- },
- ],
- "type": "A String", # The type of correction that was applied to the creative.
- "details": [ # Additional details about what was corrected.
+ ],
+ "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
+ "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method.
+ "reason": "A String", # The categorized reason for disapproval.
+ "details": [ # Additional details about the reason for disapproval.
"A String",
],
},
+ "contexts": [ # The contexts for the restriction.
+ { # The serving context for this restriction.
+ "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
+ "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
+ 42,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
+ "auctionTypes": [ # The auction types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
+ "platforms": [ # The platforms this restriction applies to.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "video": { # Video content for a creative. # A video creative.
+ "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.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ },
+ "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
+ "A String",
+ ],
+ "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method.
+ "A String",
+ ],
+ "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "native": { # Native content for a creative. # A native creative.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ "body": "A String", # A long description of the ad.
+ "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "headline": "A String", # A short title for the ad.
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
+ "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
+ "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
+ "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.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "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.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ },
+ "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
+ "A String",
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values.
+ 42,
+ ],
+ "clickThroughUrls": [ # The set of destination URLs for the creative.
+ "A String",
+ ],
+ "version": 42, # Output only. The version of this creative.
+ "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids.
+ 42,
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method.
+ "html": { # HTML content for a creative. # An HTML creative.
+ "height": 42, # The height of the HTML snippet in pixels.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ },
+ "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
+ "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction.
+ "A String",
],
- "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
- "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction.
+ "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction.
+ },
+ "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "detectedDomains": [ # Output only. The detected domains for this creative.
+ "A String",
+ ],
+ "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
+ "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
+ "corrections": [ # Output only. Shows any corrections that were applied to this creative.
+ { # Output only. Shows any corrections that were applied to this creative.
+ "details": [ # Additional details about what was corrected.
"A String",
],
- "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
+ "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
+ 42,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
+ "auctionTypes": [ # The auction types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
+ "platforms": [ # The platforms this restriction applies to.
+ "A String",
+ ],
+ },
+ },
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
},
- "native": { # Native content for a creative. # A native creative.
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- "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.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
- "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.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "callToAction": "A String", # A label for the button that the user is supposed to click.
- "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
- "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
- "videoUrl": "A String", # The URL to fetch a native video ad.
- "body": "A String", # A long description of the ad.
- "priceDisplayText": "A String", # The price of the promoted app including currency info.
- "headline": "A String", # A short title for the ad.
- },
- "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
- "A String",
- ],
- "clickThroughUrls": [ # The set of destination URLs for the creative.
- "A String",
- ],
- "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs.
- 42,
- ],
- "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method.
- "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
- "A String",
- ],
- "video": { # Video content for a creative. # A video creative.
- "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.
- "videoUrl": "A String", # The URL to fetch a video ad.
- },
- "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
- }</pre>
+ ],
+ }</pre>
</div>
<div class="method">
@@ -495,189 +495,189 @@
An object of the form:
{ # A creative and its classification data.
- "html": { # HTML content for a creative. # An HTML creative.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- "height": 42, # The height of the HTML snippet in pixels.
- "width": 42, # The width of the HTML snippet in pixels.
- },
- "version": 42, # Output only. The version of this creative.
- "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes.
- "A String",
- ],
- "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
- "A String",
- ],
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "detectedDomains": [ # Output only. The detected domains for this creative.
- "A String",
- ],
- "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction).
- { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction).
- "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
- "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method.
+ "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs.
+ 42,
+ ],
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
+ "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction).
+ { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction).
+ "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead.
+ { # Output only. The reason and details for a disapproval.
+ "reason": "A String", # The categorized reason for disapproval.
"details": [ # Additional details about the reason for disapproval.
"A String",
],
- "reason": "A String", # The categorized reason for disapproval.
},
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
- "platforms": [ # The platforms this restriction applies to.
- "A String",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
- "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
- 42,
- ],
- },
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
- "appTypes": [ # The app types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- },
- ],
- "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead.
- { # Output only. The reason and details for a disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- "reason": "A String", # The categorized reason for disapproval.
- },
- ],
- },
- ],
- "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method.
- "A String",
- ],
- "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values.
- 42,
- ],
- "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
- "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
- "A String",
- ],
- "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "agencyId": "A String", # The agency ID for this creative.
- "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids.
- 42,
- ],
- "corrections": [ # Output only. Shows any corrections that were applied to this creative.
- { # Output only. Shows any corrections that were applied to this creative.
- "contexts": [ # The contexts for the correction.
- { # The serving context for this restriction.
- "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
- "platforms": [ # The platforms this restriction applies to.
- "A String",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
- "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
- 42,
- ],
- },
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
- "appTypes": [ # The app types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- },
- ],
- "type": "A String", # The type of correction that was applied to the creative.
- "details": [ # Additional details about what was corrected.
+ ],
+ "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
+ "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method.
+ "reason": "A String", # The categorized reason for disapproval.
+ "details": [ # Additional details about the reason for disapproval.
"A String",
],
},
+ "contexts": [ # The contexts for the restriction.
+ { # The serving context for this restriction.
+ "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
+ "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
+ 42,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
+ "auctionTypes": [ # The auction types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
+ "platforms": [ # The platforms this restriction applies to.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "video": { # Video content for a creative. # A video creative.
+ "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.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ },
+ "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
+ "A String",
+ ],
+ "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method.
+ "A String",
+ ],
+ "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "native": { # Native content for a creative. # A native creative.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ "body": "A String", # A long description of the ad.
+ "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "headline": "A String", # A short title for the ad.
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
+ "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
+ "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
+ "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.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "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.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ },
+ "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
+ "A String",
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values.
+ 42,
+ ],
+ "clickThroughUrls": [ # The set of destination URLs for the creative.
+ "A String",
+ ],
+ "version": 42, # Output only. The version of this creative.
+ "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids.
+ 42,
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method.
+ "html": { # HTML content for a creative. # An HTML creative.
+ "height": 42, # The height of the HTML snippet in pixels.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ },
+ "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
+ "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction.
+ "A String",
],
- "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
- "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction.
+ "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction.
+ },
+ "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "detectedDomains": [ # Output only. The detected domains for this creative.
+ "A String",
+ ],
+ "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
+ "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
+ "corrections": [ # Output only. Shows any corrections that were applied to this creative.
+ { # Output only. Shows any corrections that were applied to this creative.
+ "details": [ # Additional details about what was corrected.
"A String",
],
- "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
+ "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
+ 42,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
+ "auctionTypes": [ # The auction types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
+ "platforms": [ # The platforms this restriction applies to.
+ "A String",
+ ],
+ },
+ },
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
},
- "native": { # Native content for a creative. # A native creative.
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- "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.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
- "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.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "callToAction": "A String", # A label for the button that the user is supposed to click.
- "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
- "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
- "videoUrl": "A String", # The URL to fetch a native video ad.
- "body": "A String", # A long description of the ad.
- "priceDisplayText": "A String", # The price of the promoted app including currency info.
- "headline": "A String", # A short title for the ad.
- },
- "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
- "A String",
- ],
- "clickThroughUrls": [ # The set of destination URLs for the creative.
- "A String",
- ],
- "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs.
- 42,
- ],
- "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method.
- "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
- "A String",
- ],
- "video": { # Video content for a creative. # A video creative.
- "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.
- "videoUrl": "A String", # The URL to fetch a video ad.
- },
- "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
- }</pre>
+ ],
+ }</pre>
</div>
<div class="method">
- <code class="details" id="list">list(accountId, pageSize=None, pageToken=None, query=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(accountId, pageSize=None, query=None, pageToken=None, x__xgafv=None)</code>
<pre>Lists creatives.
Args:
accountId: string, The account to list the creatives from. Specify "-" to list all creatives the current user has access to. (required)
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.
- pageToken: string, A token identifying a page of results the server should return. Typically, this is the value of ListCreativesResponse.next_page_token returned from the previous call to 'ListCreatives' method.
query: string, An optional query string to filter creatives. If no filter is specified, all active creatives will be returned. Supported queries are: - accountId=*account_id_string* - creativeId=*creative_id_string* - dealsStatus: {approved, conditionally_approved, disapproved, not_checked} - openAuctionStatus: {approved, conditionally_approved, disapproved, not_checked} - attribute: {a numeric attribute from the list of attributes} - disapprovalReason: {a reason from DisapprovalReason} Example: 'accountId=12345 AND (dealsStatus:disapproved AND disapprovalReason:unacceptable_content) OR attribute:47'
+ pageToken: string, A token identifying a page of results the server should return. Typically, this is the value of ListCreativesResponse.next_page_token returned from the previous call to 'ListCreatives' method.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -690,178 +690,178 @@
"nextPageToken": "A String", # A token to retrieve the next page of results. Pass this value in the ListCreativesRequest.page_token field in the subsequent call to `ListCreatives` method to retrieve the next page of results.
"creatives": [ # The list of creatives.
{ # A creative and its classification data.
- "html": { # HTML content for a creative. # An HTML creative.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- "height": 42, # The height of the HTML snippet in pixels.
- "width": 42, # The width of the HTML snippet in pixels.
- },
- "version": 42, # Output only. The version of this creative.
- "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes.
- "A String",
- ],
- "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
- "A String",
- ],
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "detectedDomains": [ # Output only. The detected domains for this creative.
- "A String",
- ],
- "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction).
- { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction).
- "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
- "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method.
+ "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs.
+ 42,
+ ],
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
+ "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction).
+ { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction).
+ "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead.
+ { # Output only. The reason and details for a disapproval.
+ "reason": "A String", # The categorized reason for disapproval.
"details": [ # Additional details about the reason for disapproval.
"A String",
],
- "reason": "A String", # The categorized reason for disapproval.
},
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
- "platforms": [ # The platforms this restriction applies to.
- "A String",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
- "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
- 42,
- ],
- },
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
- "appTypes": [ # The app types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- },
- ],
- "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead.
- { # Output only. The reason and details for a disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- "reason": "A String", # The categorized reason for disapproval.
- },
- ],
- },
- ],
- "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method.
- "A String",
- ],
- "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values.
- 42,
- ],
- "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
- "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
- "A String",
- ],
- "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "agencyId": "A String", # The agency ID for this creative.
- "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids.
- 42,
- ],
- "corrections": [ # Output only. Shows any corrections that were applied to this creative.
- { # Output only. Shows any corrections that were applied to this creative.
- "contexts": [ # The contexts for the correction.
- { # The serving context for this restriction.
- "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
- "platforms": [ # The platforms this restriction applies to.
- "A String",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
- "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
- 42,
- ],
- },
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
- "appTypes": [ # The app types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- },
- ],
- "type": "A String", # The type of correction that was applied to the creative.
- "details": [ # Additional details about what was corrected.
+ ],
+ "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
+ "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method.
+ "reason": "A String", # The categorized reason for disapproval.
+ "details": [ # Additional details about the reason for disapproval.
"A String",
],
},
+ "contexts": [ # The contexts for the restriction.
+ { # The serving context for this restriction.
+ "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
+ "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
+ 42,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
+ "auctionTypes": [ # The auction types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
+ "platforms": [ # The platforms this restriction applies to.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "video": { # Video content for a creative. # A video creative.
+ "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.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ },
+ "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
+ "A String",
+ ],
+ "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method.
+ "A String",
+ ],
+ "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "native": { # Native content for a creative. # A native creative.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ "body": "A String", # A long description of the ad.
+ "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "headline": "A String", # A short title for the ad.
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
+ "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
+ "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
+ "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.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "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.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ },
+ "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
+ "A String",
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values.
+ 42,
+ ],
+ "clickThroughUrls": [ # The set of destination URLs for the creative.
+ "A String",
+ ],
+ "version": 42, # Output only. The version of this creative.
+ "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids.
+ 42,
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method.
+ "html": { # HTML content for a creative. # An HTML creative.
+ "height": 42, # The height of the HTML snippet in pixels.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ },
+ "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
+ "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction.
+ "A String",
],
- "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
- "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction.
+ "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction.
+ },
+ "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "detectedDomains": [ # Output only. The detected domains for this creative.
+ "A String",
+ ],
+ "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
+ "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
+ "corrections": [ # Output only. Shows any corrections that were applied to this creative.
+ { # Output only. Shows any corrections that were applied to this creative.
+ "details": [ # Additional details about what was corrected.
"A String",
],
- "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
+ "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
+ 42,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
+ "auctionTypes": [ # The auction types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
+ "platforms": [ # The platforms this restriction applies to.
+ "A String",
+ ],
+ },
+ },
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
},
- "native": { # Native content for a creative. # A native creative.
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- "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.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
- "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.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "callToAction": "A String", # A label for the button that the user is supposed to click.
- "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
- "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
- "videoUrl": "A String", # The URL to fetch a native video ad.
- "body": "A String", # A long description of the ad.
- "priceDisplayText": "A String", # The price of the promoted app including currency info.
- "headline": "A String", # A short title for the ad.
- },
- "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
- "A String",
- ],
- "clickThroughUrls": [ # The set of destination URLs for the creative.
- "A String",
- ],
- "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs.
- 42,
- ],
- "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method.
- "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
- "A String",
- ],
- "video": { # Video content for a creative. # A video creative.
- "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.
- "videoUrl": "A String", # The URL to fetch a video ad.
- },
- "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
- },
+ ],
+ },
],
}</pre>
</div>
@@ -916,178 +916,178 @@
The object takes the form of:
{ # A creative and its classification data.
- "html": { # HTML content for a creative. # An HTML creative.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- "height": 42, # The height of the HTML snippet in pixels.
- "width": 42, # The width of the HTML snippet in pixels.
- },
- "version": 42, # Output only. The version of this creative.
- "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes.
- "A String",
- ],
- "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
- "A String",
- ],
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "detectedDomains": [ # Output only. The detected domains for this creative.
- "A String",
- ],
- "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction).
- { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction).
- "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
- "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method.
+ "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs.
+ 42,
+ ],
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
+ "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction).
+ { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction).
+ "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead.
+ { # Output only. The reason and details for a disapproval.
+ "reason": "A String", # The categorized reason for disapproval.
"details": [ # Additional details about the reason for disapproval.
"A String",
],
- "reason": "A String", # The categorized reason for disapproval.
},
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
- "platforms": [ # The platforms this restriction applies to.
- "A String",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
- "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
- 42,
- ],
- },
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
- "appTypes": [ # The app types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- },
- ],
- "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead.
- { # Output only. The reason and details for a disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- "reason": "A String", # The categorized reason for disapproval.
- },
- ],
- },
- ],
- "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method.
- "A String",
- ],
- "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values.
- 42,
- ],
- "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
- "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
- "A String",
- ],
- "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "agencyId": "A String", # The agency ID for this creative.
- "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids.
- 42,
- ],
- "corrections": [ # Output only. Shows any corrections that were applied to this creative.
- { # Output only. Shows any corrections that were applied to this creative.
- "contexts": [ # The contexts for the correction.
- { # The serving context for this restriction.
- "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
- "platforms": [ # The platforms this restriction applies to.
- "A String",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
- "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
- 42,
- ],
- },
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
- "appTypes": [ # The app types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- },
- ],
- "type": "A String", # The type of correction that was applied to the creative.
- "details": [ # Additional details about what was corrected.
+ ],
+ "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
+ "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method.
+ "reason": "A String", # The categorized reason for disapproval.
+ "details": [ # Additional details about the reason for disapproval.
"A String",
],
},
+ "contexts": [ # The contexts for the restriction.
+ { # The serving context for this restriction.
+ "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
+ "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
+ 42,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
+ "auctionTypes": [ # The auction types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
+ "platforms": [ # The platforms this restriction applies to.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "video": { # Video content for a creative. # A video creative.
+ "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.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ },
+ "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
+ "A String",
+ ],
+ "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method.
+ "A String",
+ ],
+ "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "native": { # Native content for a creative. # A native creative.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ "body": "A String", # A long description of the ad.
+ "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "headline": "A String", # A short title for the ad.
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
+ "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
+ "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
+ "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.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "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.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ },
+ "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
+ "A String",
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values.
+ 42,
+ ],
+ "clickThroughUrls": [ # The set of destination URLs for the creative.
+ "A String",
+ ],
+ "version": 42, # Output only. The version of this creative.
+ "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids.
+ 42,
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method.
+ "html": { # HTML content for a creative. # An HTML creative.
+ "height": 42, # The height of the HTML snippet in pixels.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ },
+ "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
+ "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction.
+ "A String",
],
- "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
- "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction.
+ "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction.
+ },
+ "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "detectedDomains": [ # Output only. The detected domains for this creative.
+ "A String",
+ ],
+ "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
+ "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
+ "corrections": [ # Output only. Shows any corrections that were applied to this creative.
+ { # Output only. Shows any corrections that were applied to this creative.
+ "details": [ # Additional details about what was corrected.
"A String",
],
- "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
+ "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
+ 42,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
+ "auctionTypes": [ # The auction types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
+ "platforms": [ # The platforms this restriction applies to.
+ "A String",
+ ],
+ },
+ },
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
},
- "native": { # Native content for a creative. # A native creative.
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- "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.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
- "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.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "callToAction": "A String", # A label for the button that the user is supposed to click.
- "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
- "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
- "videoUrl": "A String", # The URL to fetch a native video ad.
- "body": "A String", # A long description of the ad.
- "priceDisplayText": "A String", # The price of the promoted app including currency info.
- "headline": "A String", # A short title for the ad.
- },
- "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
- "A String",
- ],
- "clickThroughUrls": [ # The set of destination URLs for the creative.
- "A String",
- ],
- "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs.
- 42,
- ],
- "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method.
- "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
- "A String",
- ],
- "video": { # Video content for a creative. # A video creative.
- "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.
- "videoUrl": "A String", # The URL to fetch a video ad.
- },
- "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
- }
+ ],
+}
x__xgafv: string, V1 error format.
Allowed values
@@ -1098,178 +1098,178 @@
An object of the form:
{ # A creative and its classification data.
- "html": { # HTML content for a creative. # An HTML creative.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- "height": 42, # The height of the HTML snippet in pixels.
- "width": 42, # The width of the HTML snippet in pixels.
- },
- "version": 42, # Output only. The version of this creative.
- "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes.
- "A String",
- ],
- "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
- "A String",
- ],
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "detectedDomains": [ # Output only. The detected domains for this creative.
- "A String",
- ],
- "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction).
- { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction).
- "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
- "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method.
+ "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs.
+ 42,
+ ],
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
+ "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts. A context here relates to where something ultimately serves (for example, a physical location, a platform, an HTTPS vs HTTP request, or the type of auction).
+ { # Output only. A representation of the status of an ad in a specific context. A context here relates to where something ultimately serves (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request, or the type of auction).
+ "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead.
+ { # Output only. The reason and details for a disapproval.
+ "reason": "A String", # The categorized reason for disapproval.
"details": [ # Additional details about the reason for disapproval.
"A String",
],
- "reason": "A String", # The categorized reason for disapproval.
},
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
- "platforms": [ # The platforms this restriction applies to.
- "A String",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
- "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
- 42,
- ],
- },
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
- "appTypes": [ # The app types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- },
- ],
- "disapprovalReasons": [ # Any disapprovals bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method. Deprecated; please use disapproval field instead.
- { # Output only. The reason and details for a disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- "reason": "A String", # The categorized reason for disapproval.
- },
- ],
- },
- ],
- "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method.
- "A String",
- ],
- "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values.
- 42,
- ],
- "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
- "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
- "A String",
- ],
- "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "agencyId": "A String", # The agency ID for this creative.
- "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids.
- 42,
- ],
- "corrections": [ # Output only. Shows any corrections that were applied to this creative.
- { # Output only. Shows any corrections that were applied to this creative.
- "contexts": [ # The contexts for the correction.
- { # The serving context for this restriction.
- "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
- "platforms": [ # The platforms this restriction applies to.
- "A String",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
- "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
- 42,
- ],
- },
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
- "appTypes": [ # The app types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- },
- ],
- "type": "A String", # The type of correction that was applied to the creative.
- "details": [ # Additional details about what was corrected.
+ ],
+ "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
+ "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction. Only present if status=DISAPPROVED. Can be used to filter the response of the creatives.list method.
+ "reason": "A String", # The categorized reason for disapproval.
+ "details": [ # Additional details about the reason for disapproval.
"A String",
],
},
+ "contexts": [ # The contexts for the restriction.
+ { # The serving context for this restriction.
+ "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
+ "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
+ 42,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
+ "auctionTypes": [ # The auction types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
+ "platforms": [ # The platforms this restriction applies to.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "video": { # Video content for a creative. # A video creative.
+ "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.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ },
+ "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
+ "A String",
+ ],
+ "attributes": [ # All attributes for the ads that may be shown from this creative. Can be used to filter the response of the creatives.list method.
+ "A String",
+ ],
+ "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative. If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "native": { # Native content for a creative. # A native creative.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ "body": "A String", # A long description of the ad.
+ "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "headline": "A String", # A short title for the ad.
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
+ "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
+ "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
+ "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.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "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.
+ "width": 42, # Image width in pixels.
+ "url": "A String", # The URL of the image.
+ "height": 42, # Image height in pixels.
+ },
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ },
+ "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
+ "A String",
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "vendorIds": [ # All vendor IDs for the ads that may be shown from this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible values.
+ 42,
+ ],
+ "clickThroughUrls": [ # The set of destination URLs for the creative.
+ "A String",
+ ],
+ "version": 42, # Output only. The version of this creative.
+ "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any. See the ad-sensitive-categories.txt file in the technical documentation for a list of IDs. You should use these IDs along with the excluded-sensitive-category field in the bid request to filter your bids.
+ 42,
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method.
+ "html": { # HTML content for a creative. # An HTML creative.
+ "height": 42, # The height of the HTML snippet in pixels.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ },
+ "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
+ "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction.
+ "A String",
],
- "adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
- "detectedProviderIds": [ # The detected ad technology provider IDs for this creative. See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID to provided name, a privacy policy URL, and a list of domains which can be attributed to the provider. If the creative contains provider IDs that are outside of those listed in the `BidRequest.adslot.consented_providers_settings.consented_providers` field on the (Google bid protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto] and the `BidRequest.user.ext.consented_providers_settings.consented_providers` field on the (OpenRTB protocol)[https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto], and a bid is submitted with that creative for an impression that will serve to an EEA user, the bid will be filtered before the auction.
+ "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction.
+ },
+ "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "detectedDomains": [ # Output only. The detected domains for this creative.
+ "A String",
+ ],
+ "detectedLanguages": [ # Output only. The detected languages for this creative. The order is arbitrary. The codes are 2 or 5 characters and are documented at https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
+ "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
+ "corrections": [ # Output only. Shows any corrections that were applied to this creative.
+ { # Output only. Shows any corrections that were applied to this creative.
+ "details": [ # Additional details about what was corrected.
"A String",
],
- "hasUnidentifiedProvider": True or False, # Whether the creative contains an unidentified ad technology provider. If true for a given creative, any bid submitted with that creative for an impression that will serve to an EEA user will be filtered before the auction.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "location": { # Output only. The Geo criteria the restriction applies to. # Matches impressions coming from users *or* publishers in a specific location.
+ "geoCriteriaIds": [ # IDs representing the geo location for this context. Please refer to the [geo-table.csv](https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv) file for different geo criteria IDs.
+ 42,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
+ "auctionTypes": [ # The auction types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ "platform": { # Output only. The type of platform the restriction applies to. # Matches impressions coming from a particular platform.
+ "platforms": [ # The platforms this restriction applies to.
+ "A String",
+ ],
+ },
+ },
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
},
- "native": { # Native content for a creative. # A native creative.
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- "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.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
- "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.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "callToAction": "A String", # A label for the button that the user is supposed to click.
- "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
- "image": { # An image resource. You may provide a larger image than was requested, so long as the aspect ratio is preserved. # A large image.
- "height": 42, # Image height in pixels.
- "url": "A String", # The URL of the image.
- "width": 42, # Image width in pixels.
- },
- "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
- "videoUrl": "A String", # The URL to fetch a native video ad.
- "body": "A String", # A long description of the ad.
- "priceDisplayText": "A String", # The price of the promoted app including currency info.
- "headline": "A String", # A short title for the ad.
- },
- "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
- "A String",
- ],
- "clickThroughUrls": [ # The set of destination URLs for the creative.
- "A String",
- ],
- "detectedProductCategories": [ # Output only. Detected product categories, if any. See the ad-product-categories.txt file in the technical documentation for a list of IDs.
- 42,
- ],
- "accountId": "A String", # The account that this creative belongs to. Can be used to filter the response of the creatives.list method.
- "detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
- "A String",
- ],
- "video": { # Video content for a creative. # A video creative.
- "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.
- "videoUrl": "A String", # The URL to fetch a video ad.
- },
- "dealsStatus": "A String", # Output only. The top-level deals status of this creative. If disapproved, an entry for 'auctionType=DIRECT_DEALS' (or 'ALL') in serving_restrictions will also exist. Note that this may be nuanced with other contextual restrictions, in which case, it may be preferable to read from serving_restrictions directly. Can be used to filter the response of the creatives.list method.
- }</pre>
+ ],
+ }</pre>
</div>
<div class="method">