chore: update docs/dyn , add static discovery files to discovery_cache/documents (#1111)
This PR was generated using Autosynth. :rainbow:
Synth log will be available here:
https://source.cloud.google.com/results/invocations/78f53313-0c78-4a29-8841-f031665a4c6a/targets
- [ ] To automatically regenerate this PR, check this box.
Source-Link: https://github.com/googleapis/synthtool/commit/c2de32114ec484aa708d32012d1fa8d75232daf5
diff --git a/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html b/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html
index 8b39121..c3d6544 100644
--- a/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html
+++ b/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html
@@ -119,118 +119,25 @@
The object takes the form of:
{ # A creative and its classification data.
- "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",
- ],
"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).
- "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.
- "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",
- ],
- },
- "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",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- "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,
- ],
- },
- },
- ],
+ "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
"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.
},
],
- "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
- },
- ],
- "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.
- "detectedDomains": [ # Output only. The detected domains for this creative.
- "A String",
- ],
- "html": { # HTML content for a creative. # An HTML creative.
- "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.
- "height": 42, # The height of the HTML snippet in pixels.
- },
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
- "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",
- ],
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "native": { # Native content for a creative. # A native creative.
- "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.
- "headline": "A String", # A short title for the ad.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "videoUrl": "A String", # The URL to fetch a native video ad.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "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.
- "body": "A String", # A long description of the ad.
- "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- },
- "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.
+ "contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
+ "all": "A String", # Matches all contexts.
"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",
],
},
- "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",
@@ -241,7 +148,11 @@
"A String",
],
},
- "all": "A String", # Matches all contexts.
+ "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",
+ ],
+ },
"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,
@@ -249,47 +160,136 @@
},
},
],
- "type": "A String", # The type of correction that was applied to the creative.
- "details": [ # Additional details about what was corrected.
- "A String",
- ],
+ "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.
+ "details": [ # Additional details about the reason for disapproval.
+ "A String",
+ ],
+ "reason": "A String", # The categorized reason for disapproval.
+ },
},
],
- "video": { # Video content for a creative. # A video creative.
- "videoUrl": "A String", # The URL to fetch a video ad.
- "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.
- },
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "version": 42, # Output only. The version of this creative.
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "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,
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "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,
+ ],
+ "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",
+ ],
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "detectedDomains": [ # Output only. The detected domains for this creative.
+ "A String",
+ ],
+ "clickThroughUrls": [ # The set of destination URLs for the 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",
+ ],
"declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
"A String",
],
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"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,
- ],
+ "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.
"adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
+ "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.
"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",
],
- "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.
},
- "version": 42, # Output only. The version of this creative.
- "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.
+ "native": { # Native content for a creative. # A native creative.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "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.
+ },
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "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.
+ },
+ "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.
+ },
+ "headline": "A String", # A short title for the ad.
+ "body": "A String", # A long description of 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].
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ },
+ "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
+ "video": { # Video content for a creative. # A video creative.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ "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.
+ },
+ "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",
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "all": "A String", # Matches all contexts.
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "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.
"impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
"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.
- "accountId": "A String", # The account that this creative belongs to. 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",
- ],
- "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.
+ "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.
+ },
+ "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,
],
+ "agencyId": "A String", # The agency ID for this creative.
}
duplicateIdMode: string, Indicates if multiple creatives can share an ID or not. Default is NO_DUPLICATES (one ID per creative).
@@ -305,118 +305,25 @@
An object of the form:
{ # A creative and its classification data.
- "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",
- ],
"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).
- "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.
- "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",
- ],
- },
- "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",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- "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,
- ],
- },
- },
- ],
+ "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
"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.
},
],
- "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
- },
- ],
- "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.
- "detectedDomains": [ # Output only. The detected domains for this creative.
- "A String",
- ],
- "html": { # HTML content for a creative. # An HTML creative.
- "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.
- "height": 42, # The height of the HTML snippet in pixels.
- },
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
- "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",
- ],
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "native": { # Native content for a creative. # A native creative.
- "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.
- "headline": "A String", # A short title for the ad.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "videoUrl": "A String", # The URL to fetch a native video ad.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "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.
- "body": "A String", # A long description of the ad.
- "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- },
- "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.
+ "contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
+ "all": "A String", # Matches all contexts.
"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",
],
},
- "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",
@@ -427,7 +334,11 @@
"A String",
],
},
- "all": "A String", # Matches all contexts.
+ "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",
+ ],
+ },
"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,
@@ -435,47 +346,136 @@
},
},
],
- "type": "A String", # The type of correction that was applied to the creative.
- "details": [ # Additional details about what was corrected.
- "A String",
- ],
+ "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.
+ "details": [ # Additional details about the reason for disapproval.
+ "A String",
+ ],
+ "reason": "A String", # The categorized reason for disapproval.
+ },
},
],
- "video": { # Video content for a creative. # A video creative.
- "videoUrl": "A String", # The URL to fetch a video ad.
- "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.
- },
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "version": 42, # Output only. The version of this creative.
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "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,
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "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,
+ ],
+ "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",
+ ],
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "detectedDomains": [ # Output only. The detected domains for this creative.
+ "A String",
+ ],
+ "clickThroughUrls": [ # The set of destination URLs for the 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",
+ ],
"declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
"A String",
],
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"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,
- ],
+ "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.
"adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
+ "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.
"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",
],
- "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.
},
- "version": 42, # Output only. The version of this creative.
- "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.
+ "native": { # Native content for a creative. # A native creative.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "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.
+ },
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "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.
+ },
+ "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.
+ },
+ "headline": "A String", # A short title for the ad.
+ "body": "A String", # A long description of 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].
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ },
+ "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
+ "video": { # Video content for a creative. # A video creative.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ "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.
+ },
+ "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",
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "all": "A String", # Matches all contexts.
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "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.
"impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
"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.
- "accountId": "A String", # The account that this creative belongs to. 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",
- ],
- "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.
+ "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.
+ },
+ "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,
],
+ "agencyId": "A String", # The agency ID for this creative.
}</pre>
</div>
@@ -495,118 +495,25 @@
An object of the form:
{ # A creative and its classification data.
- "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",
- ],
"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).
- "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.
- "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",
- ],
- },
- "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",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- "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,
- ],
- },
- },
- ],
+ "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
"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.
},
],
- "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
- },
- ],
- "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.
- "detectedDomains": [ # Output only. The detected domains for this creative.
- "A String",
- ],
- "html": { # HTML content for a creative. # An HTML creative.
- "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.
- "height": 42, # The height of the HTML snippet in pixels.
- },
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
- "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",
- ],
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "native": { # Native content for a creative. # A native creative.
- "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.
- "headline": "A String", # A short title for the ad.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "videoUrl": "A String", # The URL to fetch a native video ad.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "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.
- "body": "A String", # A long description of the ad.
- "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- },
- "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.
+ "contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
+ "all": "A String", # Matches all contexts.
"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",
],
},
- "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",
@@ -617,7 +524,11 @@
"A String",
],
},
- "all": "A String", # Matches all contexts.
+ "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",
+ ],
+ },
"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,
@@ -625,47 +536,136 @@
},
},
],
- "type": "A String", # The type of correction that was applied to the creative.
- "details": [ # Additional details about what was corrected.
- "A String",
- ],
+ "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.
+ "details": [ # Additional details about the reason for disapproval.
+ "A String",
+ ],
+ "reason": "A String", # The categorized reason for disapproval.
+ },
},
],
- "video": { # Video content for a creative. # A video creative.
- "videoUrl": "A String", # The URL to fetch a video ad.
- "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.
- },
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "version": 42, # Output only. The version of this creative.
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "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,
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "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,
+ ],
+ "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",
+ ],
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "detectedDomains": [ # Output only. The detected domains for this creative.
+ "A String",
+ ],
+ "clickThroughUrls": [ # The set of destination URLs for the 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",
+ ],
"declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
"A String",
],
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"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,
- ],
+ "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.
"adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
+ "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.
"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",
],
- "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.
},
- "version": 42, # Output only. The version of this creative.
- "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.
+ "native": { # Native content for a creative. # A native creative.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "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.
+ },
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "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.
+ },
+ "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.
+ },
+ "headline": "A String", # A short title for the ad.
+ "body": "A String", # A long description of 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].
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ },
+ "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
+ "video": { # Video content for a creative. # A video creative.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ "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.
+ },
+ "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",
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "all": "A String", # Matches all contexts.
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "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.
"impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
"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.
- "accountId": "A String", # The account that this creative belongs to. 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",
- ],
- "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.
+ "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.
+ },
+ "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,
],
+ "agencyId": "A String", # The agency ID for this creative.
}</pre>
</div>
@@ -690,118 +690,25 @@
"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.
- "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",
- ],
"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).
- "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.
- "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",
- ],
- },
- "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",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- "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,
- ],
- },
- },
- ],
+ "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
"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.
},
],
- "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
- },
- ],
- "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.
- "detectedDomains": [ # Output only. The detected domains for this creative.
- "A String",
- ],
- "html": { # HTML content for a creative. # An HTML creative.
- "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.
- "height": 42, # The height of the HTML snippet in pixels.
- },
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
- "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",
- ],
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "native": { # Native content for a creative. # A native creative.
- "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.
- "headline": "A String", # A short title for the ad.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "videoUrl": "A String", # The URL to fetch a native video ad.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "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.
- "body": "A String", # A long description of the ad.
- "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- },
- "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.
+ "contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
+ "all": "A String", # Matches all contexts.
"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",
],
},
- "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",
@@ -812,7 +719,11 @@
"A String",
],
},
- "all": "A String", # Matches all contexts.
+ "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",
+ ],
+ },
"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,
@@ -820,47 +731,136 @@
},
},
],
- "type": "A String", # The type of correction that was applied to the creative.
- "details": [ # Additional details about what was corrected.
- "A String",
- ],
+ "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.
+ "details": [ # Additional details about the reason for disapproval.
+ "A String",
+ ],
+ "reason": "A String", # The categorized reason for disapproval.
+ },
},
],
- "video": { # Video content for a creative. # A video creative.
- "videoUrl": "A String", # The URL to fetch a video ad.
- "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.
- },
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "version": 42, # Output only. The version of this creative.
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "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,
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "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,
+ ],
+ "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",
+ ],
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "detectedDomains": [ # Output only. The detected domains for this creative.
+ "A String",
+ ],
+ "clickThroughUrls": [ # The set of destination URLs for the 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",
+ ],
"declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
"A String",
],
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"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,
- ],
+ "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.
"adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
+ "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.
"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",
],
- "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.
},
- "version": 42, # Output only. The version of this creative.
- "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.
+ "native": { # Native content for a creative. # A native creative.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "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.
+ },
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "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.
+ },
+ "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.
+ },
+ "headline": "A String", # A short title for the ad.
+ "body": "A String", # A long description of 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].
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ },
+ "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
+ "video": { # Video content for a creative. # A video creative.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ "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.
+ },
+ "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",
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "all": "A String", # Matches all contexts.
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "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.
"impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
"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.
- "accountId": "A String", # The account that this creative belongs to. 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",
- ],
- "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.
+ "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.
+ },
+ "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,
],
+ "agencyId": "A String", # The agency ID for this creative.
},
],
}</pre>
@@ -916,118 +916,25 @@
The object takes the form of:
{ # A creative and its classification data.
- "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",
- ],
"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).
- "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.
- "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",
- ],
- },
- "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",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- "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,
- ],
- },
- },
- ],
+ "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
"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.
},
],
- "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
- },
- ],
- "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.
- "detectedDomains": [ # Output only. The detected domains for this creative.
- "A String",
- ],
- "html": { # HTML content for a creative. # An HTML creative.
- "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.
- "height": 42, # The height of the HTML snippet in pixels.
- },
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
- "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",
- ],
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "native": { # Native content for a creative. # A native creative.
- "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.
- "headline": "A String", # A short title for the ad.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "videoUrl": "A String", # The URL to fetch a native video ad.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "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.
- "body": "A String", # A long description of the ad.
- "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- },
- "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.
+ "contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
+ "all": "A String", # Matches all contexts.
"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",
],
},
- "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",
@@ -1038,7 +945,11 @@
"A String",
],
},
- "all": "A String", # Matches all contexts.
+ "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",
+ ],
+ },
"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,
@@ -1046,47 +957,136 @@
},
},
],
- "type": "A String", # The type of correction that was applied to the creative.
- "details": [ # Additional details about what was corrected.
- "A String",
- ],
+ "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.
+ "details": [ # Additional details about the reason for disapproval.
+ "A String",
+ ],
+ "reason": "A String", # The categorized reason for disapproval.
+ },
},
],
- "video": { # Video content for a creative. # A video creative.
- "videoUrl": "A String", # The URL to fetch a video ad.
- "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.
- },
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "version": 42, # Output only. The version of this creative.
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "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,
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "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,
+ ],
+ "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",
+ ],
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "detectedDomains": [ # Output only. The detected domains for this creative.
+ "A String",
+ ],
+ "clickThroughUrls": [ # The set of destination URLs for the 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",
+ ],
"declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
"A String",
],
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"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,
- ],
+ "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.
"adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
+ "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.
"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",
],
- "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.
},
- "version": 42, # Output only. The version of this creative.
- "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.
+ "native": { # Native content for a creative. # A native creative.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "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.
+ },
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "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.
+ },
+ "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.
+ },
+ "headline": "A String", # A short title for the ad.
+ "body": "A String", # A long description of 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].
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ },
+ "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
+ "video": { # Video content for a creative. # A video creative.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ "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.
+ },
+ "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",
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "all": "A String", # Matches all contexts.
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "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.
"impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
"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.
- "accountId": "A String", # The account that this creative belongs to. 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",
- ],
- "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.
+ "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.
+ },
+ "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,
],
+ "agencyId": "A String", # The agency ID for this creative.
}
x__xgafv: string, V1 error format.
@@ -1098,118 +1098,25 @@
An object of the form:
{ # A creative and its classification data.
- "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",
- ],
"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).
- "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.
- "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",
- ],
- },
- "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",
- ],
- },
- "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
- "securities": [ # The security types in this context.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- "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,
- ],
- },
- },
- ],
+ "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
"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.
},
],
- "status": "A String", # The status of the creative in this context (for example, it has been explicitly disapproved or is pending review).
- },
- ],
- "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.
- "detectedDomains": [ # Output only. The detected domains for this creative.
- "A String",
- ],
- "html": { # HTML content for a creative. # An HTML creative.
- "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.
- "height": 42, # The height of the HTML snippet in pixels.
- },
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
- "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",
- ],
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "native": { # Native content for a creative. # A native creative.
- "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.
- "headline": "A String", # A short title for the ad.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "videoUrl": "A String", # The URL to fetch a native video ad.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "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.
- "body": "A String", # A long description of the ad.
- "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- "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.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- },
- "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.
+ "contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
+ "all": "A String", # Matches all contexts.
"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",
],
},
- "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",
@@ -1220,7 +1127,11 @@
"A String",
],
},
- "all": "A String", # Matches all contexts.
+ "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",
+ ],
+ },
"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,
@@ -1228,47 +1139,136 @@
},
},
],
- "type": "A String", # The type of correction that was applied to the creative.
- "details": [ # Additional details about what was corrected.
- "A String",
- ],
+ "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.
+ "details": [ # Additional details about the reason for disapproval.
+ "A String",
+ ],
+ "reason": "A String", # The categorized reason for disapproval.
+ },
},
],
- "video": { # Video content for a creative. # A video creative.
- "videoUrl": "A String", # The URL to fetch a video ad.
- "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.
- },
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "version": 42, # Output only. The version of this creative.
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "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,
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "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,
+ ],
+ "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",
+ ],
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "detectedDomains": [ # Output only. The detected domains for this creative.
+ "A String",
+ ],
+ "clickThroughUrls": [ # The set of destination URLs for the 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",
+ ],
"declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
"A String",
],
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"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,
- ],
+ "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.
"adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
+ "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.
"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",
],
- "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.
},
- "version": 42, # Output only. The version of this creative.
- "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.
+ "native": { # Native content for a creative. # A native creative.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "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.
+ },
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "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.
+ },
+ "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.
+ },
+ "headline": "A String", # A short title for the ad.
+ "body": "A String", # A long description of 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].
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ },
+ "creativeId": "A String", # The buyer-defined creative ID of this creative. Can be used to filter the response of the creatives.list method.
+ "video": { # Video content for a creative. # A video creative.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ "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.
+ },
+ "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",
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "all": "A String", # Matches all contexts.
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "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.
"impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
"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.
- "accountId": "A String", # The account that this creative belongs to. 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",
- ],
- "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.
+ "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.
+ },
+ "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,
],
+ "agencyId": "A String", # The agency ID for this creative.
}</pre>
</div>