chore: regens API reference docs (#889)
diff --git a/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html b/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html
index 667d53a..9d9f666 100644
--- a/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html
+++ b/docs/dyn/adexchangebuyer2_v2beta1.accounts.creatives.html
@@ -80,7 +80,7 @@
<p class="firstline">Returns the dealAssociations Resource.</p>
<p class="toc_element">
- <code><a href="#create">create(accountId, body, duplicateIdMode=None, x__xgafv=None)</a></code></p>
+ <code><a href="#create">create(accountId, body=None, duplicateIdMode=None, x__xgafv=None)</a></code></p>
<p class="firstline">Creates a creative.</p>
<p class="toc_element">
<code><a href="#get">get(accountId, creativeId, x__xgafv=None)</a></code></p>
@@ -95,14 +95,14 @@
<code><a href="#stopWatching">stopWatching(accountId, creativeId, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Stops watching a creative. Will stop push notifications being sent to the</p>
<p class="toc_element">
- <code><a href="#update">update(accountId, creativeId, body, x__xgafv=None)</a></code></p>
+ <code><a href="#update">update(accountId, creativeId, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Updates a creative.</p>
<p class="toc_element">
- <code><a href="#watch">watch(accountId, creativeId, body, x__xgafv=None)</a></code></p>
+ <code><a href="#watch">watch(accountId, creativeId, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Watches a creative. Will result in push notifications being sent to the</p>
<h3>Method Details</h3>
<div class="method">
- <code class="details" id="create">create(accountId, body, duplicateIdMode=None, x__xgafv=None)</code>
+ <code class="details" id="create">create(accountId, body=None, duplicateIdMode=None, x__xgafv=None)</code>
<pre>Creates a creative.
Args:
@@ -110,7 +110,7 @@
Can be used to filter the response of the
creatives.list
method. (required)
- body: object, The request body. (required)
+ body: object, The request body.
The object takes the form of:
{ # A creative and its classification data.
@@ -146,8 +146,25 @@
"A String",
],
"adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "accountId": "A String", # The account that this creative belongs to.
+ # 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,
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "html": { # HTML content for a creative. # An HTML creative.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "height": 42, # The height of the HTML snippet in pixels.
+ },
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
"native": { # Native content for a creative. # A native creative.
"body": "A String", # A long description of the ad.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
"videoUrl": "A String", # The URL to fetch a native video ad.
"headline": "A String", # A short title for the ad.
"image": { # An image resource. You may provide a larger image than was requested, # A large image.
@@ -156,9 +173,8 @@
"width": 42, # Image width in pixels.
"height": 42, # Image height in pixels.
},
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
"starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "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.
"priceDisplayText": "A String", # The price of the promoted app including currency info.
"callToAction": "A String", # A label for the button that the user is supposed to click.
"logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
@@ -176,22 +192,6 @@
"storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
"clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
},
- "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,
- ],
- "agencyId": "A String", # The agency ID for this creative.
- "html": { # HTML content for a creative. # An HTML creative.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- "width": 42, # The width of the HTML snippet in pixels.
- "height": 42, # The height of the HTML snippet in pixels.
- },
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "accountId": "A String", # The account that this creative belongs to.
- # Can be used to filter the response of the
- # creatives.list
- # method.
"detectedProductCategories": [ # Output only. Detected product categories, if any.
# See the ad-product-categories.txt file in the technical documentation
# for a list of IDs.
@@ -224,14 +224,16 @@
"detectedDomains": [ # Output only. The detected domains for this creative.
"A String",
],
- "attributes": [ # All attributes for the ads that may be shown from this creative.
+ "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.
- "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
+ "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative.
+ # If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in
# serving_restrictions will also exist. Note
# that this may be nuanced with other contextual restrictions, in which case,
# it may be preferable to read from serving_restrictions directly.
@@ -246,6 +248,8 @@
# specific context. A context here relates to where something ultimately serves
# (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
# or the type of auction).
+ "status": "A String", # The status of the creative in this context (for example, it has been
+ # explicitly disapproved or is pending review).
"contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
"all": "A String", # Matches all contexts.
@@ -280,8 +284,6 @@
},
},
],
- "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
@@ -357,14 +359,12 @@
],
},
],
- "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative.
- # If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in
- # serving_restrictions will also exist. Note
- # that this may be nuanced with other contextual restrictions, in which case,
- # it may be preferable to read from serving_restrictions directly.
+ "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",
+ ],
}
duplicateIdMode: string, Indicates if multiple creatives can share an ID or not. Default is
@@ -410,8 +410,25 @@
"A String",
],
"adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "accountId": "A String", # The account that this creative belongs to.
+ # 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,
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "html": { # HTML content for a creative. # An HTML creative.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "height": 42, # The height of the HTML snippet in pixels.
+ },
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
"native": { # Native content for a creative. # A native creative.
"body": "A String", # A long description of the ad.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
"videoUrl": "A String", # The URL to fetch a native video ad.
"headline": "A String", # A short title for the ad.
"image": { # An image resource. You may provide a larger image than was requested, # A large image.
@@ -420,9 +437,8 @@
"width": 42, # Image width in pixels.
"height": 42, # Image height in pixels.
},
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
"starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "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.
"priceDisplayText": "A String", # The price of the promoted app including currency info.
"callToAction": "A String", # A label for the button that the user is supposed to click.
"logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
@@ -440,22 +456,6 @@
"storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
"clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
},
- "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,
- ],
- "agencyId": "A String", # The agency ID for this creative.
- "html": { # HTML content for a creative. # An HTML creative.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- "width": 42, # The width of the HTML snippet in pixels.
- "height": 42, # The height of the HTML snippet in pixels.
- },
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "accountId": "A String", # The account that this creative belongs to.
- # Can be used to filter the response of the
- # creatives.list
- # method.
"detectedProductCategories": [ # Output only. Detected product categories, if any.
# See the ad-product-categories.txt file in the technical documentation
# for a list of IDs.
@@ -488,14 +488,16 @@
"detectedDomains": [ # Output only. The detected domains for this creative.
"A String",
],
- "attributes": [ # All attributes for the ads that may be shown from this creative.
+ "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.
- "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
+ "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative.
+ # If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in
# serving_restrictions will also exist. Note
# that this may be nuanced with other contextual restrictions, in which case,
# it may be preferable to read from serving_restrictions directly.
@@ -510,6 +512,8 @@
# specific context. A context here relates to where something ultimately serves
# (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
# or the type of auction).
+ "status": "A String", # The status of the creative in this context (for example, it has been
+ # explicitly disapproved or is pending review).
"contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
"all": "A String", # Matches all contexts.
@@ -544,8 +548,6 @@
},
},
],
- "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
@@ -621,14 +623,12 @@
],
},
],
- "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative.
- # If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in
- # serving_restrictions will also exist. Note
- # that this may be nuanced with other contextual restrictions, in which case,
- # it may be preferable to read from serving_restrictions directly.
+ "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",
+ ],
}</pre>
</div>
@@ -680,8 +680,25 @@
"A String",
],
"adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "accountId": "A String", # The account that this creative belongs to.
+ # 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,
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "html": { # HTML content for a creative. # An HTML creative.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "height": 42, # The height of the HTML snippet in pixels.
+ },
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
"native": { # Native content for a creative. # A native creative.
"body": "A String", # A long description of the ad.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
"videoUrl": "A String", # The URL to fetch a native video ad.
"headline": "A String", # A short title for the ad.
"image": { # An image resource. You may provide a larger image than was requested, # A large image.
@@ -690,9 +707,8 @@
"width": 42, # Image width in pixels.
"height": 42, # Image height in pixels.
},
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
"starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "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.
"priceDisplayText": "A String", # The price of the promoted app including currency info.
"callToAction": "A String", # A label for the button that the user is supposed to click.
"logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
@@ -710,22 +726,6 @@
"storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
"clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
},
- "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,
- ],
- "agencyId": "A String", # The agency ID for this creative.
- "html": { # HTML content for a creative. # An HTML creative.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- "width": 42, # The width of the HTML snippet in pixels.
- "height": 42, # The height of the HTML snippet in pixels.
- },
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "accountId": "A String", # The account that this creative belongs to.
- # Can be used to filter the response of the
- # creatives.list
- # method.
"detectedProductCategories": [ # Output only. Detected product categories, if any.
# See the ad-product-categories.txt file in the technical documentation
# for a list of IDs.
@@ -758,14 +758,16 @@
"detectedDomains": [ # Output only. The detected domains for this creative.
"A String",
],
- "attributes": [ # All attributes for the ads that may be shown from this creative.
+ "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.
- "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
+ "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative.
+ # If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in
# serving_restrictions will also exist. Note
# that this may be nuanced with other contextual restrictions, in which case,
# it may be preferable to read from serving_restrictions directly.
@@ -780,6 +782,8 @@
# specific context. A context here relates to where something ultimately serves
# (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
# or the type of auction).
+ "status": "A String", # The status of the creative in this context (for example, it has been
+ # explicitly disapproved or is pending review).
"contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
"all": "A String", # Matches all contexts.
@@ -814,8 +818,6 @@
},
},
],
- "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
@@ -891,14 +893,12 @@
],
},
],
- "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative.
- # If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in
- # serving_restrictions will also exist. Note
- # that this may be nuanced with other contextual restrictions, in which case,
- # it may be preferable to read from serving_restrictions directly.
+ "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",
+ ],
}</pre>
</div>
@@ -919,18 +919,18 @@
returned from the previous call to 'ListCreatives' method.
query: string, An optional query string to filter creatives. If no filter is specified,
all active creatives will be returned.
-<p>Supported queries are:
-<ul>
-<li>accountId=<i>account_id_string</i>
-<li>creativeId=<i>creative_id_string</i>
-<li>dealsStatus: {approved, conditionally_approved, disapproved,
+<p>Supported queries are:
+<ul>
+<li>accountId=<i>account_id_string</i>
+<li>creativeId=<i>creative_id_string</i>
+<li>dealsStatus: {approved, conditionally_approved, disapproved,
not_checked}
-<li>openAuctionStatus: {approved, conditionally_approved, disapproved,
+<li>openAuctionStatus: {approved, conditionally_approved, disapproved,
not_checked}
-<li>attribute: {a numeric attribute from the list of attributes}
-<li>disapprovalReason: {a reason from
+<li>attribute: {a numeric attribute from the list of attributes}
+<li>disapprovalReason: {a reason from
DisapprovalReason}
-</ul>
+</ul>
Example: 'accountId=12345 AND (dealsStatus:disapproved AND
disapprovalReason:unacceptable_content) OR attribute:47'
x__xgafv: string, V1 error format.
@@ -981,8 +981,25 @@
"A String",
],
"adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "accountId": "A String", # The account that this creative belongs to.
+ # 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,
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "html": { # HTML content for a creative. # An HTML creative.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "height": 42, # The height of the HTML snippet in pixels.
+ },
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
"native": { # Native content for a creative. # A native creative.
"body": "A String", # A long description of the ad.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
"videoUrl": "A String", # The URL to fetch a native video ad.
"headline": "A String", # A short title for the ad.
"image": { # An image resource. You may provide a larger image than was requested, # A large image.
@@ -991,9 +1008,8 @@
"width": 42, # Image width in pixels.
"height": 42, # Image height in pixels.
},
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
"starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "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.
"priceDisplayText": "A String", # The price of the promoted app including currency info.
"callToAction": "A String", # A label for the button that the user is supposed to click.
"logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
@@ -1011,22 +1027,6 @@
"storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
"clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
},
- "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,
- ],
- "agencyId": "A String", # The agency ID for this creative.
- "html": { # HTML content for a creative. # An HTML creative.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- "width": 42, # The width of the HTML snippet in pixels.
- "height": 42, # The height of the HTML snippet in pixels.
- },
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "accountId": "A String", # The account that this creative belongs to.
- # Can be used to filter the response of the
- # creatives.list
- # method.
"detectedProductCategories": [ # Output only. Detected product categories, if any.
# See the ad-product-categories.txt file in the technical documentation
# for a list of IDs.
@@ -1059,14 +1059,16 @@
"detectedDomains": [ # Output only. The detected domains for this creative.
"A String",
],
- "attributes": [ # All attributes for the ads that may be shown from this creative.
+ "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.
- "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
+ "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative.
+ # If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in
# serving_restrictions will also exist. Note
# that this may be nuanced with other contextual restrictions, in which case,
# it may be preferable to read from serving_restrictions directly.
@@ -1081,6 +1083,8 @@
# specific context. A context here relates to where something ultimately serves
# (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
# or the type of auction).
+ "status": "A String", # The status of the creative in this context (for example, it has been
+ # explicitly disapproved or is pending review).
"contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
"all": "A String", # Matches all contexts.
@@ -1115,8 +1119,6 @@
},
},
],
- "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
@@ -1192,14 +1194,12 @@
],
},
],
- "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative.
- # If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in
- # serving_restrictions will also exist. Note
- # that this may be nuanced with other contextual restrictions, in which case,
- # it may be preferable to read from serving_restrictions directly.
+ "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",
+ ],
},
],
}</pre>
@@ -1255,7 +1255,7 @@
</div>
<div class="method">
- <code class="details" id="update">update(accountId, creativeId, body, x__xgafv=None)</code>
+ <code class="details" id="update">update(accountId, creativeId, body=None, x__xgafv=None)</code>
<pre>Updates a creative.
Args:
@@ -1267,7 +1267,7 @@
Can be used to filter the response of the
creatives.list
method. (required)
- body: object, The request body. (required)
+ body: object, The request body.
The object takes the form of:
{ # A creative and its classification data.
@@ -1303,8 +1303,25 @@
"A String",
],
"adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "accountId": "A String", # The account that this creative belongs to.
+ # 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,
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "html": { # HTML content for a creative. # An HTML creative.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "height": 42, # The height of the HTML snippet in pixels.
+ },
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
"native": { # Native content for a creative. # A native creative.
"body": "A String", # A long description of the ad.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
"videoUrl": "A String", # The URL to fetch a native video ad.
"headline": "A String", # A short title for the ad.
"image": { # An image resource. You may provide a larger image than was requested, # A large image.
@@ -1313,9 +1330,8 @@
"width": 42, # Image width in pixels.
"height": 42, # Image height in pixels.
},
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
"starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "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.
"priceDisplayText": "A String", # The price of the promoted app including currency info.
"callToAction": "A String", # A label for the button that the user is supposed to click.
"logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
@@ -1333,22 +1349,6 @@
"storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
"clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
},
- "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,
- ],
- "agencyId": "A String", # The agency ID for this creative.
- "html": { # HTML content for a creative. # An HTML creative.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- "width": 42, # The width of the HTML snippet in pixels.
- "height": 42, # The height of the HTML snippet in pixels.
- },
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "accountId": "A String", # The account that this creative belongs to.
- # Can be used to filter the response of the
- # creatives.list
- # method.
"detectedProductCategories": [ # Output only. Detected product categories, if any.
# See the ad-product-categories.txt file in the technical documentation
# for a list of IDs.
@@ -1381,14 +1381,16 @@
"detectedDomains": [ # Output only. The detected domains for this creative.
"A String",
],
- "attributes": [ # All attributes for the ads that may be shown from this creative.
+ "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.
- "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
+ "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative.
+ # If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in
# serving_restrictions will also exist. Note
# that this may be nuanced with other contextual restrictions, in which case,
# it may be preferable to read from serving_restrictions directly.
@@ -1403,6 +1405,8 @@
# specific context. A context here relates to where something ultimately serves
# (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
# or the type of auction).
+ "status": "A String", # The status of the creative in this context (for example, it has been
+ # explicitly disapproved or is pending review).
"contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
"all": "A String", # Matches all contexts.
@@ -1437,8 +1441,6 @@
},
},
],
- "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
@@ -1514,14 +1516,12 @@
],
},
],
- "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative.
- # If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in
- # serving_restrictions will also exist. Note
- # that this may be nuanced with other contextual restrictions, in which case,
- # it may be preferable to read from serving_restrictions directly.
+ "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",
+ ],
}
x__xgafv: string, V1 error format.
@@ -1565,8 +1565,25 @@
"A String",
],
"adChoicesDestinationUrl": "A String", # The link to AdChoices destination page.
+ "accountId": "A String", # The account that this creative belongs to.
+ # 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,
+ ],
+ "agencyId": "A String", # The agency ID for this creative.
+ "html": { # HTML content for a creative. # An HTML creative.
+ "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
+ "width": 42, # The width of the HTML snippet in pixels.
+ "height": 42, # The height of the HTML snippet in pixels.
+ },
+ "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
"native": { # Native content for a creative. # A native creative.
"body": "A String", # A long description of the ad.
+ "advertiserName": "A String", # The name of the advertiser or sponsor, to be displayed in the ad creative.
"videoUrl": "A String", # The URL to fetch a native video ad.
"headline": "A String", # A short title for the ad.
"image": { # An image resource. You may provide a larger image than was requested, # A large image.
@@ -1575,9 +1592,8 @@
"width": 42, # Image width in pixels.
"height": 42, # Image height in pixels.
},
- "clickTrackingUrl": "A String", # The URL to use for click tracking.
"starRating": 3.14, # The app rating in the app store. Must be in the range [0-5].
- "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.
"priceDisplayText": "A String", # The price of the promoted app including currency info.
"callToAction": "A String", # A label for the button that the user is supposed to click.
"logo": { # An image resource. You may provide a larger image than was requested, # A smaller image, for the advertiser's logo.
@@ -1595,22 +1611,6 @@
"storeUrl": "A String", # The URL to the app store to purchase/download the promoted app.
"clickLinkUrl": "A String", # The URL that the browser/SDK will load when the user clicks the ad.
},
- "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,
- ],
- "agencyId": "A String", # The agency ID for this creative.
- "html": { # HTML content for a creative. # An HTML creative.
- "snippet": "A String", # The HTML snippet that displays the ad when inserted in the web page.
- "width": 42, # The width of the HTML snippet in pixels.
- "height": 42, # The height of the HTML snippet in pixels.
- },
- "apiUpdateTime": "A String", # Output only. The last update timestamp of the creative via API.
- "accountId": "A String", # The account that this creative belongs to.
- # Can be used to filter the response of the
- # creatives.list
- # method.
"detectedProductCategories": [ # Output only. Detected product categories, if any.
# See the ad-product-categories.txt file in the technical documentation
# for a list of IDs.
@@ -1643,14 +1643,16 @@
"detectedDomains": [ # Output only. The detected domains for this creative.
"A String",
],
- "attributes": [ # All attributes for the ads that may be shown from this creative.
+ "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.
- "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
+ "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative.
+ # If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in
# serving_restrictions will also exist. Note
# that this may be nuanced with other contextual restrictions, in which case,
# it may be preferable to read from serving_restrictions directly.
@@ -1665,6 +1667,8 @@
# specific context. A context here relates to where something ultimately serves
# (for example, a user or publisher geo, a platform, an HTTPS vs HTTP request,
# or the type of auction).
+ "status": "A String", # The status of the creative in this context (for example, it has been
+ # explicitly disapproved or is pending review).
"contexts": [ # The contexts for the restriction.
{ # The serving context for this restriction.
"all": "A String", # Matches all contexts.
@@ -1699,8 +1703,6 @@
},
},
],
- "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
@@ -1776,19 +1778,17 @@
],
},
],
- "openAuctionStatus": "A String", # Output only. The top-level open auction status of this creative.
- # If disapproved, an entry for 'auctionType = OPEN_AUCTION' (or 'ALL') in
- # serving_restrictions will also exist. Note
- # that this may be nuanced with other contextual restrictions, in which case,
- # it may be preferable to read from serving_restrictions directly.
+ "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",
+ ],
}</pre>
</div>
<div class="method">
- <code class="details" id="watch">watch(accountId, creativeId, body, x__xgafv=None)</code>
+ <code class="details" id="watch">watch(accountId, creativeId, body=None, x__xgafv=None)</code>
<pre>Watches a creative. Will result in push notifications being sent to the
topic when the creative changes status.
@@ -1799,7 +1799,7 @@
If both creative-level and account-level notifications are
sent, only a single notification will be sent to the
creative-level notification topic. (required)
- body: object, The request body. (required)
+ body: object, The request body.
The object takes the form of:
{ # A request for watching changes to creative Status.