docs: update generated docs (#981)
diff --git a/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html b/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html
index 4a1fff1..038cfc9 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, query=None, pageSize=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(accountId, pageToken=None, pageSize=None, query=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>
@@ -117,174 +117,6 @@
"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",
- ],
- "accountId": "A String", # The account that this creative belongs to.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts.
- # A context here relates to where something ultimately serves (for example,
- # a physical location, a platform, an HTTPS vs HTTP request, or the type
- # of auction).
- { # Output only. A representation of the status of an ad in a
- # specific context. A context here relates to where something ultimately serves
- # (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
- # or the type of auction).
- "status": "A String", # The status of the creative in this context (for example, it has been
- # explicitly disapproved or is pending review).
- "disapprovalReasons": [ # Any disapprovals bound to this restriction.
- # Only present if status=DISAPPROVED.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- # Deprecated; please use
- # disapproval
- # field instead.
- { # Output only. The reason and details for a disapproval.
- "reason": "A String", # The categorized reason for disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- },
- ],
- "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
- # Only present if status=DISAPPROVED.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- "reason": "A String", # The categorized reason for disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- },
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "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.
- },
- ],
- },
- ],
"adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
"detectedProviderIds": [ # The detected ad technology provider IDs for this creative.
# See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for
@@ -309,16 +141,27 @@
# impression that will serve to an EEA user will be filtered before the
# auction.
},
+ "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",
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
"creativeId": "A String", # The buyer-defined creative ID of this creative.
# Can be used to filter the response of the
# creatives.list
# method.
- "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.
- },
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "accountId": "A String", # The account that this creative belongs to.
+ # 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.
"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
@@ -327,44 +170,201 @@
# Can be used to filter the response of the
# creatives.list
# method.
- "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.
- },
+ "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",
+ ],
+ "version": 42, # Output only. The version of this creative.
+ "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any.
+ # See the ad-sensitive-categories.txt file in the technical documentation for
+ # a list of IDs. You should use these IDs along with the
+ # excluded-sensitive-category field in the bid request to filter your bids.
+ 42,
+ ],
"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.
+ "url": "A String", # The URL of the image.
},
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
+ # so long as the aspect ratio is preserved.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ "url": "A String", # The URL of the image.
+ },
+ "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.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ "url": "A String", # The URL of the image.
+ },
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
"videoUrl": "A String", # The URL to fetch a native video ad.
+ "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.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "headline": "A String", # A short title for the ad.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
},
+ "clickThroughUrls": [ # The set of destination URLs for the creative.
+ "A String",
+ ],
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"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.
+ "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,
+ ],
+ "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.
+ },
+ "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts.
+ # A context here relates to where something ultimately serves (for example,
+ # a physical location, a platform, an HTTPS vs HTTP request, or the type
+ # of auction).
+ { # Output only. A representation of the status of an ad in a
+ # specific context. A context here relates to where something ultimately serves
+ # (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
+ # or the type of auction).
+ "disapprovalReasons": [ # Any disapprovals bound to this restriction.
+ # Only present if status=DISAPPROVED.
+ # Can be used to filter the response of the
+ # creatives.list
+ # method.
+ # Deprecated; please use
+ # disapproval
+ # field instead.
+ { # Output only. The reason and details for a disapproval.
+ "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).
+ "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
+ # Only present if status=DISAPPROVED.
+ # Can be used to filter the response of the
+ # creatives.list
+ # method.
+ "details": [ # Additional details about the reason for disapproval.
+ "A String",
+ ],
+ "reason": "A String", # The categorized reason for disapproval.
+ },
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "detectedDomains": [ # Output only. The detected domains for 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.
+ "details": [ # Additional details about what was corrected.
+ "A String",
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "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,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "html": { # HTML content for a creative. # An HTML creative.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ "height": 42, # The height of the HTML snippet in pixels.
+ },
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
}
duplicateIdMode: string, Indicates if multiple creatives can share an ID or not. Default is
@@ -381,174 +381,6 @@
"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",
- ],
- "accountId": "A String", # The account that this creative belongs to.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts.
- # A context here relates to where something ultimately serves (for example,
- # a physical location, a platform, an HTTPS vs HTTP request, or the type
- # of auction).
- { # Output only. A representation of the status of an ad in a
- # specific context. A context here relates to where something ultimately serves
- # (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
- # or the type of auction).
- "status": "A String", # The status of the creative in this context (for example, it has been
- # explicitly disapproved or is pending review).
- "disapprovalReasons": [ # Any disapprovals bound to this restriction.
- # Only present if status=DISAPPROVED.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- # Deprecated; please use
- # disapproval
- # field instead.
- { # Output only. The reason and details for a disapproval.
- "reason": "A String", # The categorized reason for disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- },
- ],
- "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
- # Only present if status=DISAPPROVED.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- "reason": "A String", # The categorized reason for disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- },
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "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.
- },
- ],
- },
- ],
"adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
"detectedProviderIds": [ # The detected ad technology provider IDs for this creative.
# See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for
@@ -573,16 +405,27 @@
# impression that will serve to an EEA user will be filtered before the
# auction.
},
+ "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",
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
"creativeId": "A String", # The buyer-defined creative ID of this creative.
# Can be used to filter the response of the
# creatives.list
# method.
- "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.
- },
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "accountId": "A String", # The account that this creative belongs to.
+ # 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.
"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
@@ -591,44 +434,201 @@
# Can be used to filter the response of the
# creatives.list
# method.
- "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.
- },
+ "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",
+ ],
+ "version": 42, # Output only. The version of this creative.
+ "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any.
+ # See the ad-sensitive-categories.txt file in the technical documentation for
+ # a list of IDs. You should use these IDs along with the
+ # excluded-sensitive-category field in the bid request to filter your bids.
+ 42,
+ ],
"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.
+ "url": "A String", # The URL of the image.
},
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
+ # so long as the aspect ratio is preserved.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ "url": "A String", # The URL of the image.
+ },
+ "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.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ "url": "A String", # The URL of the image.
+ },
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
"videoUrl": "A String", # The URL to fetch a native video ad.
+ "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.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "headline": "A String", # A short title for the ad.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
},
+ "clickThroughUrls": [ # The set of destination URLs for the creative.
+ "A String",
+ ],
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"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.
+ "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,
+ ],
+ "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.
+ },
+ "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts.
+ # A context here relates to where something ultimately serves (for example,
+ # a physical location, a platform, an HTTPS vs HTTP request, or the type
+ # of auction).
+ { # Output only. A representation of the status of an ad in a
+ # specific context. A context here relates to where something ultimately serves
+ # (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
+ # or the type of auction).
+ "disapprovalReasons": [ # Any disapprovals bound to this restriction.
+ # Only present if status=DISAPPROVED.
+ # Can be used to filter the response of the
+ # creatives.list
+ # method.
+ # Deprecated; please use
+ # disapproval
+ # field instead.
+ { # Output only. The reason and details for a disapproval.
+ "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).
+ "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
+ # Only present if status=DISAPPROVED.
+ # Can be used to filter the response of the
+ # creatives.list
+ # method.
+ "details": [ # Additional details about the reason for disapproval.
+ "A String",
+ ],
+ "reason": "A String", # The categorized reason for disapproval.
+ },
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "detectedDomains": [ # Output only. The detected domains for 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.
+ "details": [ # Additional details about what was corrected.
+ "A String",
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "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,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "html": { # HTML content for a creative. # An HTML creative.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ "height": 42, # The height of the HTML snippet in pixels.
+ },
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
}</pre>
</div>
@@ -651,174 +651,6 @@
"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",
- ],
- "accountId": "A String", # The account that this creative belongs to.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts.
- # A context here relates to where something ultimately serves (for example,
- # a physical location, a platform, an HTTPS vs HTTP request, or the type
- # of auction).
- { # Output only. A representation of the status of an ad in a
- # specific context. A context here relates to where something ultimately serves
- # (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
- # or the type of auction).
- "status": "A String", # The status of the creative in this context (for example, it has been
- # explicitly disapproved or is pending review).
- "disapprovalReasons": [ # Any disapprovals bound to this restriction.
- # Only present if status=DISAPPROVED.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- # Deprecated; please use
- # disapproval
- # field instead.
- { # Output only. The reason and details for a disapproval.
- "reason": "A String", # The categorized reason for disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- },
- ],
- "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
- # Only present if status=DISAPPROVED.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- "reason": "A String", # The categorized reason for disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- },
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "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.
- },
- ],
- },
- ],
"adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
"detectedProviderIds": [ # The detected ad technology provider IDs for this creative.
# See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for
@@ -843,16 +675,27 @@
# impression that will serve to an EEA user will be filtered before the
# auction.
},
+ "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",
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
"creativeId": "A String", # The buyer-defined creative ID of this creative.
# Can be used to filter the response of the
# creatives.list
# method.
- "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.
- },
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "accountId": "A String", # The account that this creative belongs to.
+ # 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.
"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
@@ -861,49 +704,206 @@
# Can be used to filter the response of the
# creatives.list
# method.
- "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.
- },
+ "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",
+ ],
+ "version": 42, # Output only. The version of this creative.
+ "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any.
+ # See the ad-sensitive-categories.txt file in the technical documentation for
+ # a list of IDs. You should use these IDs along with the
+ # excluded-sensitive-category field in the bid request to filter your bids.
+ 42,
+ ],
"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.
+ "url": "A String", # The URL of the image.
},
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
+ # so long as the aspect ratio is preserved.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ "url": "A String", # The URL of the image.
+ },
+ "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.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ "url": "A String", # The URL of the image.
+ },
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
"videoUrl": "A String", # The URL to fetch a native video ad.
+ "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.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "headline": "A String", # A short title for the ad.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
},
+ "clickThroughUrls": [ # The set of destination URLs for the creative.
+ "A String",
+ ],
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"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.
+ "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,
+ ],
+ "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.
+ },
+ "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts.
+ # A context here relates to where something ultimately serves (for example,
+ # a physical location, a platform, an HTTPS vs HTTP request, or the type
+ # of auction).
+ { # Output only. A representation of the status of an ad in a
+ # specific context. A context here relates to where something ultimately serves
+ # (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
+ # or the type of auction).
+ "disapprovalReasons": [ # Any disapprovals bound to this restriction.
+ # Only present if status=DISAPPROVED.
+ # Can be used to filter the response of the
+ # creatives.list
+ # method.
+ # Deprecated; please use
+ # disapproval
+ # field instead.
+ { # Output only. The reason and details for a disapproval.
+ "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).
+ "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
+ # Only present if status=DISAPPROVED.
+ # Can be used to filter the response of the
+ # creatives.list
+ # method.
+ "details": [ # Additional details about the reason for disapproval.
+ "A String",
+ ],
+ "reason": "A String", # The categorized reason for disapproval.
+ },
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "detectedDomains": [ # Output only. The detected domains for 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.
+ "details": [ # Additional details about what was corrected.
+ "A String",
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "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,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "html": { # HTML content for a creative. # An HTML creative.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ "height": 42, # The height of the HTML snippet in pixels.
+ },
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(accountId, pageToken=None, query=None, pageSize=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(accountId, pageToken=None, pageSize=None, query=None, x__xgafv=None)</code>
<pre>Lists creatives.
Args:
@@ -913,6 +913,10 @@
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:
@@ -929,10 +933,6 @@
</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
@@ -947,174 +947,6 @@
"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",
- ],
- "accountId": "A String", # The account that this creative belongs to.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts.
- # A context here relates to where something ultimately serves (for example,
- # a physical location, a platform, an HTTPS vs HTTP request, or the type
- # of auction).
- { # Output only. A representation of the status of an ad in a
- # specific context. A context here relates to where something ultimately serves
- # (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
- # or the type of auction).
- "status": "A String", # The status of the creative in this context (for example, it has been
- # explicitly disapproved or is pending review).
- "disapprovalReasons": [ # Any disapprovals bound to this restriction.
- # Only present if status=DISAPPROVED.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- # Deprecated; please use
- # disapproval
- # field instead.
- { # Output only. The reason and details for a disapproval.
- "reason": "A String", # The categorized reason for disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- },
- ],
- "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
- # Only present if status=DISAPPROVED.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- "reason": "A String", # The categorized reason for disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- },
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "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.
- },
- ],
- },
- ],
"adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
"detectedProviderIds": [ # The detected ad technology provider IDs for this creative.
# See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for
@@ -1139,16 +971,27 @@
# impression that will serve to an EEA user will be filtered before the
# auction.
},
+ "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",
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
"creativeId": "A String", # The buyer-defined creative ID of this creative.
# Can be used to filter the response of the
# creatives.list
# method.
- "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.
- },
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "accountId": "A String", # The account that this creative belongs to.
+ # 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.
"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
@@ -1157,44 +1000,201 @@
# Can be used to filter the response of the
# creatives.list
# method.
- "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.
- },
+ "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",
+ ],
+ "version": 42, # Output only. The version of this creative.
+ "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any.
+ # See the ad-sensitive-categories.txt file in the technical documentation for
+ # a list of IDs. You should use these IDs along with the
+ # excluded-sensitive-category field in the bid request to filter your bids.
+ 42,
+ ],
"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.
+ "url": "A String", # The URL of the image.
},
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
+ # so long as the aspect ratio is preserved.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ "url": "A String", # The URL of the image.
+ },
+ "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.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ "url": "A String", # The URL of the image.
+ },
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
"videoUrl": "A String", # The URL to fetch a native video ad.
+ "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.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "headline": "A String", # A short title for the ad.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
},
+ "clickThroughUrls": [ # The set of destination URLs for the creative.
+ "A String",
+ ],
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"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.
+ "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,
+ ],
+ "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.
+ },
+ "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts.
+ # A context here relates to where something ultimately serves (for example,
+ # a physical location, a platform, an HTTPS vs HTTP request, or the type
+ # of auction).
+ { # Output only. A representation of the status of an ad in a
+ # specific context. A context here relates to where something ultimately serves
+ # (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
+ # or the type of auction).
+ "disapprovalReasons": [ # Any disapprovals bound to this restriction.
+ # Only present if status=DISAPPROVED.
+ # Can be used to filter the response of the
+ # creatives.list
+ # method.
+ # Deprecated; please use
+ # disapproval
+ # field instead.
+ { # Output only. The reason and details for a disapproval.
+ "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).
+ "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
+ # Only present if status=DISAPPROVED.
+ # Can be used to filter the response of the
+ # creatives.list
+ # method.
+ "details": [ # Additional details about the reason for disapproval.
+ "A String",
+ ],
+ "reason": "A String", # The categorized reason for disapproval.
+ },
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "detectedDomains": [ # Output only. The detected domains for 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.
+ "details": [ # Additional details about what was corrected.
+ "A String",
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "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,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "html": { # HTML content for a creative. # An HTML creative.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ "height": 42, # The height of the HTML snippet in pixels.
+ },
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
},
],
"nextPageToken": "A String", # A token to retrieve the next page of results.
@@ -1274,174 +1274,6 @@
"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",
- ],
- "accountId": "A String", # The account that this creative belongs to.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts.
- # A context here relates to where something ultimately serves (for example,
- # a physical location, a platform, an HTTPS vs HTTP request, or the type
- # of auction).
- { # Output only. A representation of the status of an ad in a
- # specific context. A context here relates to where something ultimately serves
- # (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
- # or the type of auction).
- "status": "A String", # The status of the creative in this context (for example, it has been
- # explicitly disapproved or is pending review).
- "disapprovalReasons": [ # Any disapprovals bound to this restriction.
- # Only present if status=DISAPPROVED.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- # Deprecated; please use
- # disapproval
- # field instead.
- { # Output only. The reason and details for a disapproval.
- "reason": "A String", # The categorized reason for disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- },
- ],
- "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
- # Only present if status=DISAPPROVED.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- "reason": "A String", # The categorized reason for disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- },
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "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.
- },
- ],
- },
- ],
"adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
"detectedProviderIds": [ # The detected ad technology provider IDs for this creative.
# See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for
@@ -1466,16 +1298,27 @@
# impression that will serve to an EEA user will be filtered before the
# auction.
},
+ "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",
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
"creativeId": "A String", # The buyer-defined creative ID of this creative.
# Can be used to filter the response of the
# creatives.list
# method.
- "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.
- },
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "accountId": "A String", # The account that this creative belongs to.
+ # 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.
"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
@@ -1484,44 +1327,201 @@
# Can be used to filter the response of the
# creatives.list
# method.
- "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.
- },
+ "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",
+ ],
+ "version": 42, # Output only. The version of this creative.
+ "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any.
+ # See the ad-sensitive-categories.txt file in the technical documentation for
+ # a list of IDs. You should use these IDs along with the
+ # excluded-sensitive-category field in the bid request to filter your bids.
+ 42,
+ ],
"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.
+ "url": "A String", # The URL of the image.
},
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
+ # so long as the aspect ratio is preserved.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ "url": "A String", # The URL of the image.
+ },
+ "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.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ "url": "A String", # The URL of the image.
+ },
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
"videoUrl": "A String", # The URL to fetch a native video ad.
+ "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.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "headline": "A String", # A short title for the ad.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
},
+ "clickThroughUrls": [ # The set of destination URLs for the creative.
+ "A String",
+ ],
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"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.
+ "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,
+ ],
+ "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.
+ },
+ "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts.
+ # A context here relates to where something ultimately serves (for example,
+ # a physical location, a platform, an HTTPS vs HTTP request, or the type
+ # of auction).
+ { # Output only. A representation of the status of an ad in a
+ # specific context. A context here relates to where something ultimately serves
+ # (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
+ # or the type of auction).
+ "disapprovalReasons": [ # Any disapprovals bound to this restriction.
+ # Only present if status=DISAPPROVED.
+ # Can be used to filter the response of the
+ # creatives.list
+ # method.
+ # Deprecated; please use
+ # disapproval
+ # field instead.
+ { # Output only. The reason and details for a disapproval.
+ "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).
+ "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
+ # Only present if status=DISAPPROVED.
+ # Can be used to filter the response of the
+ # creatives.list
+ # method.
+ "details": [ # Additional details about the reason for disapproval.
+ "A String",
+ ],
+ "reason": "A String", # The categorized reason for disapproval.
+ },
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "detectedDomains": [ # Output only. The detected domains for 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.
+ "details": [ # Additional details about what was corrected.
+ "A String",
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "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,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "html": { # HTML content for a creative. # An HTML creative.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ "height": 42, # The height of the HTML snippet in pixels.
+ },
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
}
x__xgafv: string, V1 error format.
@@ -1536,174 +1536,6 @@
"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",
- ],
- "accountId": "A String", # The account that this creative belongs to.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts.
- # A context here relates to where something ultimately serves (for example,
- # a physical location, a platform, an HTTPS vs HTTP request, or the type
- # of auction).
- { # Output only. A representation of the status of an ad in a
- # specific context. A context here relates to where something ultimately serves
- # (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
- # or the type of auction).
- "status": "A String", # The status of the creative in this context (for example, it has been
- # explicitly disapproved or is pending review).
- "disapprovalReasons": [ # Any disapprovals bound to this restriction.
- # Only present if status=DISAPPROVED.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- # Deprecated; please use
- # disapproval
- # field instead.
- { # Output only. The reason and details for a disapproval.
- "reason": "A String", # The categorized reason for disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- },
- ],
- "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
- # Only present if status=DISAPPROVED.
- # Can be used to filter the response of the
- # creatives.list
- # method.
- "reason": "A String", # The categorized reason for disapproval.
- "details": [ # Additional details about the reason for disapproval.
- "A String",
- ],
- },
- "contexts": [ # The contexts for the restriction.
- { # The serving context for this restriction.
- "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.
- },
- ],
- },
- ],
"adTechnologyProviders": { # Detected ad technology provider information. # Output only. The detected ad technology providers.
"detectedProviderIds": [ # The detected ad technology provider IDs for this creative.
# See https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for
@@ -1728,16 +1560,27 @@
# impression that will serve to an EEA user will be filtered before the
# auction.
},
+ "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",
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "declaredClickThroughUrls": [ # The set of declared destination URLs for the creative.
+ "A String",
+ ],
"creativeId": "A String", # The buyer-defined creative ID of this creative.
# Can be used to filter the response of the
# creatives.list
# method.
- "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.
- },
+ "restrictedCategories": [ # All restricted categories for the ads that may be shown from this creative.
+ "A String",
+ ],
+ "accountId": "A String", # The account that this creative belongs to.
+ # 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.
"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
@@ -1746,44 +1589,201 @@
# Can be used to filter the response of the
# creatives.list
# method.
- "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.
- },
+ "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",
+ ],
+ "version": 42, # Output only. The version of this creative.
+ "detectedSensitiveCategories": [ # Output only. Detected sensitive categories, if any.
+ # See the ad-sensitive-categories.txt file in the technical documentation for
+ # a list of IDs. You should use these IDs along with the
+ # excluded-sensitive-category field in the bid request to filter your bids.
+ 42,
+ ],
"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.
+ "url": "A String", # The URL of the image.
},
+ "priceDisplayText": "A String", # The price of the promoted app including currency info.
+ "logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
+ # so long as the aspect ratio is preserved.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ "url": "A String", # The URL of the image.
+ },
+ "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.
+ "width": 42, # Image width in pixels.
+ "height": 42, # Image height in pixels.
+ "url": "A String", # The URL of the image.
+ },
+ "clickTrackingUrl": "A String", # The URL to use for click tracking.
"videoUrl": "A String", # The URL to fetch a native video ad.
+ "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.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
+ "headline": "A String", # A short title for the ad.
+ "clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
+ "callToAction": "A String", # A label for the button that the user is supposed to click.
},
+ "clickThroughUrls": [ # The set of destination URLs for the creative.
+ "A String",
+ ],
"detectedAdvertiserIds": [ # Output only. Detected advertiser IDs, if any.
"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.
+ "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,
+ ],
+ "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.
+ },
+ "servingRestrictions": [ # Output only. The granular status of this ad in specific contexts.
+ # A context here relates to where something ultimately serves (for example,
+ # a physical location, a platform, an HTTPS vs HTTP request, or the type
+ # of auction).
+ { # Output only. A representation of the status of an ad in a
+ # specific context. A context here relates to where something ultimately serves
+ # (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
+ # or the type of auction).
+ "disapprovalReasons": [ # Any disapprovals bound to this restriction.
+ # Only present if status=DISAPPROVED.
+ # Can be used to filter the response of the
+ # creatives.list
+ # method.
+ # Deprecated; please use
+ # disapproval
+ # field instead.
+ { # Output only. The reason and details for a disapproval.
+ "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).
+ "disapproval": { # Output only. The reason and details for a disapproval. # Disapproval bound to this restriction.
+ # Only present if status=DISAPPROVED.
+ # Can be used to filter the response of the
+ # creatives.list
+ # method.
+ "details": [ # Additional details about the reason for disapproval.
+ "A String",
+ ],
+ "reason": "A String", # The categorized reason for disapproval.
+ },
+ "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",
+ ],
+ },
+ "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,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "detectedDomains": [ # Output only. The detected domains for 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.
+ "details": [ # Additional details about what was corrected.
+ "A String",
+ ],
+ "type": "A String", # The type of correction that was applied to the creative.
+ "contexts": [ # The contexts for the correction.
+ { # The serving context for this restriction.
+ "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,
+ ],
+ },
+ "appType": { # Output only. The app type the restriction applies to for mobile device. # Matches impressions for a particular app type.
+ "appTypes": [ # The app types this restriction applies to.
+ "A String",
+ ],
+ },
+ "all": "A String", # Matches all contexts.
+ "securityType": { # Output only. A security context. # Matches impressions for a particular security type.
+ "securities": [ # The security types in this context.
+ "A String",
+ ],
+ },
+ },
+ ],
+ },
+ ],
+ "html": { # HTML content for a creative. # An HTML creative.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ "height": 42, # The height of the HTML snippet in pixels.
+ },
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
}</pre>
</div>