docs: update docs (#916)
* fix: re-run script
* test: fix noxfile
diff --git a/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html b/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html
index 7c6e9c6..4a1fff1 100644
--- a/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html
+++ b/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html
@@ -86,7 +86,7 @@
<code><a href="#get">get(accountId, creativeId, x__xgafv=None)</a></code></p>
<p class="firstline">Gets a creative.</p>
<p class="toc_element">
- <code><a href="#list">list(accountId, pageToken=None, pageSize=None, query=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(accountId, pageToken=None, query=None, pageSize=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists creatives.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -114,56 +114,106 @@
The object takes the form of:
{ # A creative and its classification data.
+ "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
+ "A String",
+ ],
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "corrections": [ # Output only. Shows any corrections that were applied to this creative.
+ { # Output only. Shows any corrections that were applied to this creative.
+ "type": "A String", # The type of correction that was applied to the creative.
+ "details": [ # Additional details about what was corrected.
+ "A String",
+ ],
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ },
+ ],
+ },
+ ],
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "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,
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "agencyId": "A String", # The agency ID for this creative.
+ "detectedDomains": [ # Output only. The detected domains for 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.
+ 42,
+ ],
+ "detectedProductCategories": [ # Output only. Detected product categories, if any.
+ # See the ad-product-categories.txt file in the technical documentation
+ # for a list of IDs.
+ 42,
+ ],
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
+ "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.
+ "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",
+ ],
"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",
],
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "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",
- ],
- "creativeId": "A String", # The buyer-defined creative ID of this creative.
- # 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.
- "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.
- "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
- "headline": "A String", # A short title for the ad.
- "appIcon": { # An image resource. You may provide a larger image than was requested, # The app icon, for app download ads.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "callToAction": "A String", # A label for the button that the user is supposed to click.
- "body": "A String", # A long description of the ad.
- "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "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.
- "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "priceDisplayText": "A String", # The price of the promoted app including currency info.
- "image": { # An image resource. You may provide a larger image than was requested, # A large image.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- },
"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
@@ -172,6 +222,8 @@
# specific context. A context here relates to where something ultimately serves
# (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
# or the type of auction).
+ "status": "A String", # The status of the creative in this context (for example, it has been
+ # explicitly disapproved or is pending review).
"disapprovalReasons": [ # Any disapprovals bound to this restriction.
# Only present if status=DISAPPROVED.
# Can be used to filter the response of the
@@ -181,44 +233,10 @@
# disapproval
# field instead.
{ # Output only. The reason and details for a disapproval.
+ "reason": "A String", # The categorized reason for disapproval.
"details": [ # Additional details about the reason for disapproval.
"A String",
],
- "reason": "A String", # The categorized reason for disapproval.
- },
- ],
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- "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",
- ],
- },
- "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",
- ],
- },
- "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,
- ],
- },
},
],
"disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
@@ -226,52 +244,25 @@
# 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",
],
- "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).
- },
- ],
- "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.
- },
- "agencyId": "A String", # The agency ID for this creative.
- "clickThroughUrls": [ # The set of destination URLs for the creative.
- "A String",
- ],
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "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,
- ],
- "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
- "A String",
- ],
- "corrections": [ # Output only. Shows any corrections that were applied to this creative.
- { # Output only. Shows any corrections that were applied to this creative.
- "type": "A String", # The type of correction that was applied to the creative.
- "contexts": [ # The contexts for the correction.
+ "contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
- "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.
+ "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.
"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.
+ "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",
],
},
@@ -289,20 +280,12 @@
42,
],
},
+ "all": "A String", # Matches all contexts.
},
],
- "details": [ # Additional details about what was corrected.
- "A String",
- ],
},
],
- "version": 42, # Output only. The version of this creative.
"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
@@ -320,33 +303,22 @@
# 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.
},
- "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,
- ],
- "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
- "A String",
- ],
- "html": { # HTML content for a creative. # An HTML creative.
- "height": 42, # The height of the HTML snippet in pixels.
- "width": 42, # The width of the HTML snippet in pixels.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- },
- "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.
+ "creativeId": "A String", # The buyer-defined creative ID of this creative.
# Can be used to filter the response of the
# creatives.list
# method.
- "detectedProductCategories": [ # Output only. Detected product categories, if any.
- # See the ad-product-categories.txt file in the technical documentation
- # for a list of IDs.
- 42,
- ],
+ "version": 42, # Output only. The version of this creative.
+ "video": { # Video content for a creative. # A video creative.
+ "videoVastXml": "A String", # The contents of a VAST document for a video ad.
+ # This document should conform to the VAST 2.0 or 3.0 standard.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ },
"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
@@ -355,13 +327,41 @@
# Can be used to filter the response of the
# creatives.list
# method.
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
- "A String",
- ],
- "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.
+ "height": 42, # The height of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ },
+ "native": { # Native content for a creative. # A native creative.
+ "body": "A String", # A long description of the ad.
+ "appIcon": { # An image resource. You may provide a larger image than was requested, # The app icon, for app download ads.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "headline": "A String", # A short title for the ad.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "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.
+ "image": { # An image resource. You may provide a larger image than was requested, # A large image.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ },
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"A String",
],
@@ -378,56 +378,106 @@
An object of the form:
{ # A creative and its classification data.
+ "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
+ "A String",
+ ],
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "corrections": [ # Output only. Shows any corrections that were applied to this creative.
+ { # Output only. Shows any corrections that were applied to this creative.
+ "type": "A String", # The type of correction that was applied to the creative.
+ "details": [ # Additional details about what was corrected.
+ "A String",
+ ],
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ },
+ ],
+ },
+ ],
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "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,
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "agencyId": "A String", # The agency ID for this creative.
+ "detectedDomains": [ # Output only. The detected domains for 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.
+ 42,
+ ],
+ "detectedProductCategories": [ # Output only. Detected product categories, if any.
+ # See the ad-product-categories.txt file in the technical documentation
+ # for a list of IDs.
+ 42,
+ ],
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
+ "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.
+ "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",
+ ],
"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",
],
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "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",
- ],
- "creativeId": "A String", # The buyer-defined creative ID of this creative.
- # 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.
- "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.
- "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
- "headline": "A String", # A short title for the ad.
- "appIcon": { # An image resource. You may provide a larger image than was requested, # The app icon, for app download ads.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "callToAction": "A String", # A label for the button that the user is supposed to click.
- "body": "A String", # A long description of the ad.
- "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "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.
- "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "priceDisplayText": "A String", # The price of the promoted app including currency info.
- "image": { # An image resource. You may provide a larger image than was requested, # A large image.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- },
"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
@@ -436,6 +486,8 @@
# specific context. A context here relates to where something ultimately serves
# (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
# or the type of auction).
+ "status": "A String", # The status of the creative in this context (for example, it has been
+ # explicitly disapproved or is pending review).
"disapprovalReasons": [ # Any disapprovals bound to this restriction.
# Only present if status=DISAPPROVED.
# Can be used to filter the response of the
@@ -445,44 +497,10 @@
# disapproval
# field instead.
{ # Output only. The reason and details for a disapproval.
+ "reason": "A String", # The categorized reason for disapproval.
"details": [ # Additional details about the reason for disapproval.
"A String",
],
- "reason": "A String", # The categorized reason for disapproval.
- },
- ],
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- "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",
- ],
- },
- "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",
- ],
- },
- "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,
- ],
- },
},
],
"disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
@@ -490,52 +508,25 @@
# 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",
],
- "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).
- },
- ],
- "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.
- },
- "agencyId": "A String", # The agency ID for this creative.
- "clickThroughUrls": [ # The set of destination URLs for the creative.
- "A String",
- ],
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "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,
- ],
- "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
- "A String",
- ],
- "corrections": [ # Output only. Shows any corrections that were applied to this creative.
- { # Output only. Shows any corrections that were applied to this creative.
- "type": "A String", # The type of correction that was applied to the creative.
- "contexts": [ # The contexts for the correction.
+ "contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
- "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.
+ "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.
"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.
+ "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",
],
},
@@ -553,20 +544,12 @@
42,
],
},
+ "all": "A String", # Matches all contexts.
},
],
- "details": [ # Additional details about what was corrected.
- "A String",
- ],
},
],
- "version": 42, # Output only. The version of this creative.
"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
@@ -584,33 +567,22 @@
# 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.
},
- "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,
- ],
- "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
- "A String",
- ],
- "html": { # HTML content for a creative. # An HTML creative.
- "height": 42, # The height of the HTML snippet in pixels.
- "width": 42, # The width of the HTML snippet in pixels.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- },
- "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.
+ "creativeId": "A String", # The buyer-defined creative ID of this creative.
# Can be used to filter the response of the
# creatives.list
# method.
- "detectedProductCategories": [ # Output only. Detected product categories, if any.
- # See the ad-product-categories.txt file in the technical documentation
- # for a list of IDs.
- 42,
- ],
+ "version": 42, # Output only. The version of this creative.
+ "video": { # Video content for a creative. # A video creative.
+ "videoVastXml": "A String", # The contents of a VAST document for a video ad.
+ # This document should conform to the VAST 2.0 or 3.0 standard.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ },
"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
@@ -619,13 +591,41 @@
# Can be used to filter the response of the
# creatives.list
# method.
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
- "A String",
- ],
- "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.
+ "height": 42, # The height of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ },
+ "native": { # Native content for a creative. # A native creative.
+ "body": "A String", # A long description of the ad.
+ "appIcon": { # An image resource. You may provide a larger image than was requested, # The app icon, for app download ads.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "headline": "A String", # A short title for the ad.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "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.
+ "image": { # An image resource. You may provide a larger image than was requested, # A large image.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ },
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"A String",
],
@@ -648,56 +648,106 @@
An object of the form:
{ # A creative and its classification data.
+ "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
+ "A String",
+ ],
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "corrections": [ # Output only. Shows any corrections that were applied to this creative.
+ { # Output only. Shows any corrections that were applied to this creative.
+ "type": "A String", # The type of correction that was applied to the creative.
+ "details": [ # Additional details about what was corrected.
+ "A String",
+ ],
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ },
+ ],
+ },
+ ],
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "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,
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "agencyId": "A String", # The agency ID for this creative.
+ "detectedDomains": [ # Output only. The detected domains for 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.
+ 42,
+ ],
+ "detectedProductCategories": [ # Output only. Detected product categories, if any.
+ # See the ad-product-categories.txt file in the technical documentation
+ # for a list of IDs.
+ 42,
+ ],
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
+ "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.
+ "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",
+ ],
"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",
],
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "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",
- ],
- "creativeId": "A String", # The buyer-defined creative ID of this creative.
- # 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.
- "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.
- "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
- "headline": "A String", # A short title for the ad.
- "appIcon": { # An image resource. You may provide a larger image than was requested, # The app icon, for app download ads.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "callToAction": "A String", # A label for the button that the user is supposed to click.
- "body": "A String", # A long description of the ad.
- "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "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.
- "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "priceDisplayText": "A String", # The price of the promoted app including currency info.
- "image": { # An image resource. You may provide a larger image than was requested, # A large image.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- },
"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
@@ -706,6 +756,8 @@
# specific context. A context here relates to where something ultimately serves
# (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
# or the type of auction).
+ "status": "A String", # The status of the creative in this context (for example, it has been
+ # explicitly disapproved or is pending review).
"disapprovalReasons": [ # Any disapprovals bound to this restriction.
# Only present if status=DISAPPROVED.
# Can be used to filter the response of the
@@ -715,44 +767,10 @@
# disapproval
# field instead.
{ # Output only. The reason and details for a disapproval.
+ "reason": "A String", # The categorized reason for disapproval.
"details": [ # Additional details about the reason for disapproval.
"A String",
],
- "reason": "A String", # The categorized reason for disapproval.
- },
- ],
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- "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",
- ],
- },
- "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",
- ],
- },
- "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,
- ],
- },
},
],
"disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
@@ -760,52 +778,25 @@
# 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",
],
- "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).
- },
- ],
- "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.
- },
- "agencyId": "A String", # The agency ID for this creative.
- "clickThroughUrls": [ # The set of destination URLs for the creative.
- "A String",
- ],
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "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,
- ],
- "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
- "A String",
- ],
- "corrections": [ # Output only. Shows any corrections that were applied to this creative.
- { # Output only. Shows any corrections that were applied to this creative.
- "type": "A String", # The type of correction that was applied to the creative.
- "contexts": [ # The contexts for the correction.
+ "contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
- "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.
+ "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.
"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.
+ "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",
],
},
@@ -823,20 +814,12 @@
42,
],
},
+ "all": "A String", # Matches all contexts.
},
],
- "details": [ # Additional details about what was corrected.
- "A String",
- ],
},
],
- "version": 42, # Output only. The version of this creative.
"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
@@ -854,33 +837,22 @@
# 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.
},
- "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,
- ],
- "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
- "A String",
- ],
- "html": { # HTML content for a creative. # An HTML creative.
- "height": 42, # The height of the HTML snippet in pixels.
- "width": 42, # The width of the HTML snippet in pixels.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- },
- "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.
+ "creativeId": "A String", # The buyer-defined creative ID of this creative.
# Can be used to filter the response of the
# creatives.list
# method.
- "detectedProductCategories": [ # Output only. Detected product categories, if any.
- # See the ad-product-categories.txt file in the technical documentation
- # for a list of IDs.
- 42,
- ],
+ "version": 42, # Output only. The version of this creative.
+ "video": { # Video content for a creative. # A video creative.
+ "videoVastXml": "A String", # The contents of a VAST document for a video ad.
+ # This document should conform to the VAST 2.0 or 3.0 standard.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ },
"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
@@ -889,13 +861,41 @@
# Can be used to filter the response of the
# creatives.list
# method.
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
- "A String",
- ],
- "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.
+ "height": 42, # The height of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ },
+ "native": { # Native content for a creative. # A native creative.
+ "body": "A String", # A long description of the ad.
+ "appIcon": { # An image resource. You may provide a larger image than was requested, # The app icon, for app download ads.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "headline": "A String", # A short title for the ad.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "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.
+ "image": { # An image resource. You may provide a larger image than was requested, # A large image.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ },
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"A String",
],
@@ -903,7 +903,7 @@
</div>
<div class="method">
- <code class="details" id="list">list(accountId, pageToken=None, pageSize=None, query=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(accountId, pageToken=None, query=None, pageSize=None, x__xgafv=None)</code>
<pre>Lists creatives.
Args:
@@ -913,10 +913,6 @@
Typically, this is the value of
ListCreativesResponse.next_page_token
returned from the previous call to 'ListCreatives' method.
- pageSize: integer, Requested page size. The server may return fewer creatives than requested
-(due to timeout constraint) even if more are available via another call.
-If unspecified, server will pick an appropriate default.
-Acceptable values are 1 to 1000, inclusive.
query: string, An optional query string to filter creatives. If no filter is specified,
all active creatives will be returned.
<p>Supported queries are:
@@ -933,6 +929,10 @@
</ul>
Example: 'accountId=12345 AND (dealsStatus:disapproved AND
disapprovalReason:unacceptable_content) OR attribute:47'
+ pageSize: integer, Requested page size. The server may return fewer creatives than requested
+(due to timeout constraint) even if more are available via another call.
+If unspecified, server will pick an appropriate default.
+Acceptable values are 1 to 1000, inclusive.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -944,56 +944,106 @@
{ # A response for listing creatives.
"creatives": [ # The list of creatives.
{ # A creative and its classification data.
+ "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
+ "A String",
+ ],
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "corrections": [ # Output only. Shows any corrections that were applied to this creative.
+ { # Output only. Shows any corrections that were applied to this creative.
+ "type": "A String", # The type of correction that was applied to the creative.
+ "details": [ # Additional details about what was corrected.
+ "A String",
+ ],
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ },
+ ],
+ },
+ ],
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "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,
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "agencyId": "A String", # The agency ID for this creative.
+ "detectedDomains": [ # Output only. The detected domains for 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.
+ 42,
+ ],
+ "detectedProductCategories": [ # Output only. Detected product categories, if any.
+ # See the ad-product-categories.txt file in the technical documentation
+ # for a list of IDs.
+ 42,
+ ],
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
+ "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.
+ "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",
+ ],
"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",
],
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "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",
- ],
- "creativeId": "A String", # The buyer-defined creative ID of this creative.
- # 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.
- "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.
- "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
- "headline": "A String", # A short title for the ad.
- "appIcon": { # An image resource. You may provide a larger image than was requested, # The app icon, for app download ads.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "callToAction": "A String", # A label for the button that the user is supposed to click.
- "body": "A String", # A long description of the ad.
- "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "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.
- "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "priceDisplayText": "A String", # The price of the promoted app including currency info.
- "image": { # An image resource. You may provide a larger image than was requested, # A large image.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- },
"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
@@ -1002,6 +1052,8 @@
# specific context. A context here relates to where something ultimately serves
# (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
# or the type of auction).
+ "status": "A String", # The status of the creative in this context (for example, it has been
+ # explicitly disapproved or is pending review).
"disapprovalReasons": [ # Any disapprovals bound to this restriction.
# Only present if status=DISAPPROVED.
# Can be used to filter the response of the
@@ -1011,44 +1063,10 @@
# disapproval
# field instead.
{ # Output only. The reason and details for a disapproval.
+ "reason": "A String", # The categorized reason for disapproval.
"details": [ # Additional details about the reason for disapproval.
"A String",
],
- "reason": "A String", # The categorized reason for disapproval.
- },
- ],
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- "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",
- ],
- },
- "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",
- ],
- },
- "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,
- ],
- },
},
],
"disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
@@ -1056,52 +1074,25 @@
# 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",
],
- "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).
- },
- ],
- "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.
- },
- "agencyId": "A String", # The agency ID for this creative.
- "clickThroughUrls": [ # The set of destination URLs for the creative.
- "A String",
- ],
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "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,
- ],
- "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
- "A String",
- ],
- "corrections": [ # Output only. Shows any corrections that were applied to this creative.
- { # Output only. Shows any corrections that were applied to this creative.
- "type": "A String", # The type of correction that was applied to the creative.
- "contexts": [ # The contexts for the correction.
+ "contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
- "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.
+ "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.
"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.
+ "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",
],
},
@@ -1119,20 +1110,12 @@
42,
],
},
+ "all": "A String", # Matches all contexts.
},
],
- "details": [ # Additional details about what was corrected.
- "A String",
- ],
},
],
- "version": 42, # Output only. The version of this creative.
"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
@@ -1150,33 +1133,22 @@
# 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.
},
- "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,
- ],
- "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
- "A String",
- ],
- "html": { # HTML content for a creative. # An HTML creative.
- "height": 42, # The height of the HTML snippet in pixels.
- "width": 42, # The width of the HTML snippet in pixels.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- },
- "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.
+ "creativeId": "A String", # The buyer-defined creative ID of this creative.
# Can be used to filter the response of the
# creatives.list
# method.
- "detectedProductCategories": [ # Output only. Detected product categories, if any.
- # See the ad-product-categories.txt file in the technical documentation
- # for a list of IDs.
- 42,
- ],
+ "version": 42, # Output only. The version of this creative.
+ "video": { # Video content for a creative. # A video creative.
+ "videoVastXml": "A String", # The contents of a VAST document for a video ad.
+ # This document should conform to the VAST 2.0 or 3.0 standard.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ },
"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
@@ -1185,13 +1157,41 @@
# Can be used to filter the response of the
# creatives.list
# method.
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
- "A String",
- ],
- "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.
+ "height": 42, # The height of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ },
+ "native": { # Native content for a creative. # A native creative.
+ "body": "A String", # A long description of the ad.
+ "appIcon": { # An image resource. You may provide a larger image than was requested, # The app icon, for app download ads.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "headline": "A String", # A short title for the ad.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "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.
+ "image": { # An image resource. You may provide a larger image than was requested, # A large image.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ },
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"A String",
],
@@ -1271,56 +1271,106 @@
The object takes the form of:
{ # A creative and its classification data.
+ "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
+ "A String",
+ ],
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "corrections": [ # Output only. Shows any corrections that were applied to this creative.
+ { # Output only. Shows any corrections that were applied to this creative.
+ "type": "A String", # The type of correction that was applied to the creative.
+ "details": [ # Additional details about what was corrected.
+ "A String",
+ ],
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ },
+ ],
+ },
+ ],
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "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,
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "agencyId": "A String", # The agency ID for this creative.
+ "detectedDomains": [ # Output only. The detected domains for 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.
+ 42,
+ ],
+ "detectedProductCategories": [ # Output only. Detected product categories, if any.
+ # See the ad-product-categories.txt file in the technical documentation
+ # for a list of IDs.
+ 42,
+ ],
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
+ "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.
+ "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",
+ ],
"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",
],
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "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",
- ],
- "creativeId": "A String", # The buyer-defined creative ID of this creative.
- # 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.
- "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.
- "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
- "headline": "A String", # A short title for the ad.
- "appIcon": { # An image resource. You may provide a larger image than was requested, # The app icon, for app download ads.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "callToAction": "A String", # A label for the button that the user is supposed to click.
- "body": "A String", # A long description of the ad.
- "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "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.
- "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "priceDisplayText": "A String", # The price of the promoted app including currency info.
- "image": { # An image resource. You may provide a larger image than was requested, # A large image.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- },
"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
@@ -1329,6 +1379,8 @@
# specific context. A context here relates to where something ultimately serves
# (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
# or the type of auction).
+ "status": "A String", # The status of the creative in this context (for example, it has been
+ # explicitly disapproved or is pending review).
"disapprovalReasons": [ # Any disapprovals bound to this restriction.
# Only present if status=DISAPPROVED.
# Can be used to filter the response of the
@@ -1338,44 +1390,10 @@
# disapproval
# field instead.
{ # Output only. The reason and details for a disapproval.
+ "reason": "A String", # The categorized reason for disapproval.
"details": [ # Additional details about the reason for disapproval.
"A String",
],
- "reason": "A String", # The categorized reason for disapproval.
- },
- ],
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- "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",
- ],
- },
- "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",
- ],
- },
- "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,
- ],
- },
},
],
"disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
@@ -1383,52 +1401,25 @@
# 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",
],
- "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).
- },
- ],
- "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.
- },
- "agencyId": "A String", # The agency ID for this creative.
- "clickThroughUrls": [ # The set of destination URLs for the creative.
- "A String",
- ],
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "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,
- ],
- "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
- "A String",
- ],
- "corrections": [ # Output only. Shows any corrections that were applied to this creative.
- { # Output only. Shows any corrections that were applied to this creative.
- "type": "A String", # The type of correction that was applied to the creative.
- "contexts": [ # The contexts for the correction.
+ "contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
- "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.
+ "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.
"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.
+ "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",
],
},
@@ -1446,20 +1437,12 @@
42,
],
},
+ "all": "A String", # Matches all contexts.
},
],
- "details": [ # Additional details about what was corrected.
- "A String",
- ],
},
],
- "version": 42, # Output only. The version of this creative.
"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
@@ -1477,33 +1460,22 @@
# 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.
},
- "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,
- ],
- "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
- "A String",
- ],
- "html": { # HTML content for a creative. # An HTML creative.
- "height": 42, # The height of the HTML snippet in pixels.
- "width": 42, # The width of the HTML snippet in pixels.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- },
- "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.
+ "creativeId": "A String", # The buyer-defined creative ID of this creative.
# Can be used to filter the response of the
# creatives.list
# method.
- "detectedProductCategories": [ # Output only. Detected product categories, if any.
- # See the ad-product-categories.txt file in the technical documentation
- # for a list of IDs.
- 42,
- ],
+ "version": 42, # Output only. The version of this creative.
+ "video": { # Video content for a creative. # A video creative.
+ "videoVastXml": "A String", # The contents of a VAST document for a video ad.
+ # This document should conform to the VAST 2.0 or 3.0 standard.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ },
"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
@@ -1512,13 +1484,41 @@
# Can be used to filter the response of the
# creatives.list
# method.
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
- "A String",
- ],
- "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.
+ "height": 42, # The height of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ },
+ "native": { # Native content for a creative. # A native creative.
+ "body": "A String", # A long description of the ad.
+ "appIcon": { # An image resource. You may provide a larger image than was requested, # The app icon, for app download ads.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "headline": "A String", # A short title for the ad.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "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.
+ "image": { # An image resource. You may provide a larger image than was requested, # A large image.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ },
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"A String",
],
@@ -1533,56 +1533,106 @@
An object of the form:
{ # A creative and its classification data.
+ "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
+ "A String",
+ ],
+ "advertiserName": "A String", # The name of the company being advertised in the creative.
+ "corrections": [ # Output only. Shows any corrections that were applied to this creative.
+ { # Output only. Shows any corrections that were applied to this creative.
+ "type": "A String", # The type of correction that was applied to the creative.
+ "details": [ # Additional details about what was corrected.
+ "A String",
+ ],
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ },
+ ],
+ },
+ ],
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "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,
+ ],
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "agencyId": "A String", # The agency ID for this creative.
+ "detectedDomains": [ # Output only. The detected domains for 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.
+ 42,
+ ],
+ "detectedProductCategories": [ # Output only. Detected product categories, if any.
+ # See the ad-product-categories.txt file in the technical documentation
+ # for a list of IDs.
+ 42,
+ ],
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
+ "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.
+ "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",
+ ],
"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",
],
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "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",
- ],
- "creativeId": "A String", # The buyer-defined creative ID of this creative.
- # 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.
- "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.
- "storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
- "headline": "A String", # A short title for the ad.
- "appIcon": { # An image resource. You may provide a larger image than was requested, # The app icon, for app download ads.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "callToAction": "A String", # A label for the button that the user is supposed to click.
- "body": "A String", # A long description of the ad.
- "starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "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.
- "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "priceDisplayText": "A String", # The price of the promoted app including currency info.
- "image": { # An image resource. You may provide a larger image than was requested, # A large image.
- # so long as the aspect ratio is preserved.
- "height": 42, # Image height in pixels.
- "width": 42, # Image width in pixels.
- "url": "A String", # The URL of the image.
- },
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
- },
"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
@@ -1591,6 +1641,8 @@
# specific context. A context here relates to where something ultimately serves
# (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
# or the type of auction).
+ "status": "A String", # The status of the creative in this context (for example, it has been
+ # explicitly disapproved or is pending review).
"disapprovalReasons": [ # Any disapprovals bound to this restriction.
# Only present if status=DISAPPROVED.
# Can be used to filter the response of the
@@ -1600,44 +1652,10 @@
# disapproval
# field instead.
{ # Output only. The reason and details for a disapproval.
+ "reason": "A String", # The categorized reason for disapproval.
"details": [ # Additional details about the reason for disapproval.
"A String",
],
- "reason": "A String", # The categorized reason for disapproval.
- },
- ],
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "auctionType": { # Output only. The auction type the restriction applies to. # Matches impressions for a particular auction type.
- "auctionTypes": [ # The auction types this restriction applies to.
- "A String",
- ],
- },
- "all": "A String", # Matches all contexts.
- "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",
- ],
- },
- "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",
- ],
- },
- "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,
- ],
- },
},
],
"disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
@@ -1645,52 +1663,25 @@
# 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",
],
- "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).
- },
- ],
- "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.
- },
- "agencyId": "A String", # The agency ID for this creative.
- "clickThroughUrls": [ # The set of destination URLs for the creative.
- "A String",
- ],
- "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
- "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,
- ],
- "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
- "A String",
- ],
- "corrections": [ # Output only. Shows any corrections that were applied to this creative.
- { # Output only. Shows any corrections that were applied to this creative.
- "type": "A String", # The type of correction that was applied to the creative.
- "contexts": [ # The contexts for the correction.
+ "contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
- "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.
+ "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.
"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.
+ "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",
],
},
@@ -1708,20 +1699,12 @@
42,
],
},
+ "all": "A String", # Matches all contexts.
},
],
- "details": [ # Additional details about what was corrected.
- "A String",
- ],
},
],
- "version": 42, # Output only. The version of this creative.
"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
@@ -1739,33 +1722,22 @@
# 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.
},
- "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,
- ],
- "impressionTrackingUrls": [ # The set of URLs to be called to record an impression.
- "A String",
- ],
- "html": { # HTML content for a creative. # An HTML creative.
- "height": 42, # The height of the HTML snippet in pixels.
- "width": 42, # The width of the HTML snippet in pixels.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- },
- "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.
+ "creativeId": "A String", # The buyer-defined creative ID of this creative.
# Can be used to filter the response of the
# creatives.list
# method.
- "detectedProductCategories": [ # Output only. Detected product categories, if any.
- # See the ad-product-categories.txt file in the technical documentation
- # for a list of IDs.
- 42,
- ],
+ "version": 42, # Output only. The version of this creative.
+ "video": { # Video content for a creative. # A video creative.
+ "videoVastXml": "A String", # The contents of a VAST document for a video ad.
+ # This document should conform to the VAST 2.0 or 3.0 standard.
+ "videoUrl": "A String", # The URL to fetch a video ad.
+ },
"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
@@ -1774,13 +1746,41 @@
# Can be used to filter the response of the
# creatives.list
# method.
- "advertiserName": "A String", # The name of the company being advertised in the creative.
- "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
- "A String",
- ],
- "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.
+ "height": 42, # The height of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ },
+ "native": { # Native content for a creative. # A native creative.
+ "body": "A String", # A long description of the ad.
+ "appIcon": { # An image resource. You may provide a larger image than was requested, # The app icon, for app download ads.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "headline": "A String", # A short title for the ad.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
+ "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "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.
+ "image": { # An image resource. You may provide a larger image than was requested, # A large image.
+ # so long as the aspect ratio is preserved.
+ "url": "A String", # The URL of the image.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ },
+ "videoUrl": "A String", # The URL to fetch a native video ad.
+ },
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"A String",
],