Skip to content

Commit fbfe2be

Browse files
feat(content): update the api
#### content:v2 The following keys were deleted: - resources.inventory.methods.custombatch (Total Keys: 10) - resources.inventory.methods.set (Total Keys: 20) - schemas.Inventory (Total Keys: 70) #### content:v2.1 The following keys were added: - schemas.Product.properties.externalSellerId.type (Total Keys: 1)
1 parent bc197df commit fbfe2be

File tree

8 files changed

+82
-380
lines changed

8 files changed

+82
-380
lines changed

docs/dyn/content_v2.html

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -99,11 +99,6 @@ <h2>Instance Methods</h2>
9999
</p>
100100
<p class="firstline">Returns the datafeedstatuses Resource.</p>
101101

102-
<p class="toc_element">
103-
<code><a href="content_v2.inventory.html">inventory()</a></code>
104-
</p>
105-
<p class="firstline">Returns the inventory Resource.</p>
106-
107102
<p class="toc_element">
108103
<code><a href="content_v2.liasettings.html">liasettings()</a></code>
109104
</p>

docs/dyn/content_v2_1.freelistingsprogram.html

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
8282
<p class="firstline">Retrieves the status and review eligibility for the free listing program.</p>
8383
<p class="toc_element">
8484
<code><a href="#requestreview">requestreview(merchantId, body=None, x__xgafv=None)</a></code></p>
85-
<p class="firstline">Requests a review for Free Listings program in the provided region. Important: This method is only whitelisted for selected merchants.</p>
85+
<p class="firstline">Requests a review of free listings in a specific region Important: This method is only whitelisted for selected merchants.</p>
8686
<h3>Method Details</h3>
8787
<div class="method">
8888
<code class="details" id="close">close()</code>
@@ -104,24 +104,24 @@ <h3>Method Details</h3>
104104
An object of the form:
105105

106106
{ # Response message for GetFreeListingsProgramStatus.
107-
&quot;globalState&quot;: &quot;A String&quot;, # State of the program, It is set to enabled if there are offers for at least one region.
107+
&quot;globalState&quot;: &quot;A String&quot;, # State of the program. `ENABLED` if there are offers for at least one region.
108108
&quot;regionStatuses&quot;: [ # Status of the program in each region. Regions with the same status and review eligibility are grouped together in `regionCodes`.
109109
{ # Status of program and region.
110-
&quot;disapprovalDate&quot;: &quot;A String&quot;, # Date by which `eligibility_status` will go from `WARNING` to `DISAPPROVED`. It will be present when `eligibility_status` is `WARNING`. Date will be provided in ISO 8601 format: YYYY-MM-DD
110+
&quot;disapprovalDate&quot;: &quot;A String&quot;, # Date by which eligibilityStatus will go from `WARNING` to `DISAPPROVED`. Only visible when your eligibilityStatus is WARNING. In [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DD`.
111111
&quot;eligibilityStatus&quot;: &quot;A String&quot;, # Eligibility status of the standard free listing program.
112-
&quot;onboardingIssues&quot;: [ # These issues must be fixed to become eligible for the review.
112+
&quot;onboardingIssues&quot;: [ # Issues that must be fixed to be eligible for review.
113113
&quot;A String&quot;,
114114
],
115115
&quot;regionCodes&quot;: [ # The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) codes for all the regions with the same `eligibilityStatus` and `reviewEligibility`.
116116
&quot;A String&quot;,
117117
],
118-
&quot;reviewEligibilityStatus&quot;: &quot;A String&quot;, # If a program in a given country is eligible for review. It will be present only if eligibility status is `DISAPPROVED`.
118+
&quot;reviewEligibilityStatus&quot;: &quot;A String&quot;, # If a program is eligible for review in a specific region. Only visible if `eligibilityStatus` is `DISAPPROVED`.
119119
&quot;reviewIneligibilityReason&quot;: &quot;A String&quot;, # Review ineligibility reason if account is not eligible for review.
120-
&quot;reviewIneligibilityReasonDescription&quot;: &quot;A String&quot;, # Reason if a program in a given country is not eligible for review. Populated only if `review_eligibility_status` is `INELIGIBLE`.
121-
&quot;reviewIneligibilityReasonDetails&quot;: { # Additional details for review ineligibility reasons. # This contains additional information specific to review ineligibility reasons. If review is ineligible because of `IN_COOLDOWN_PERIOD`, it will contain timestamp for cooldown period.
120+
&quot;reviewIneligibilityReasonDescription&quot;: &quot;A String&quot;, # Reason a program in a specific region isn’t eligible for review. Only visible if `reviewEligibilityStatus` is `INELIGIBLE`.
121+
&quot;reviewIneligibilityReasonDetails&quot;: { # Additional details for review ineligibility reasons. # Additional information for ineligibility. If `reviewIneligibilityReason` is `IN_COOLDOWN_PERIOD`, a timestamp for the end of the cooldown period is provided.
122122
&quot;cooldownTime&quot;: &quot;A String&quot;, # This timestamp represents end of cooldown period for review ineligbility reason `IN_COOLDOWN_PERIOD`.
123123
},
124-
&quot;reviewIssues&quot;: [ # These issues will be evaluated in review process. Fix all the issues before requesting the review.
124+
&quot;reviewIssues&quot;: [ # Issues evaluated in the review process. Fix all issues before requesting a review.
125125
&quot;A String&quot;,
126126
],
127127
},
@@ -131,7 +131,7 @@ <h3>Method Details</h3>
131131

132132
<div class="method">
133133
<code class="details" id="requestreview">requestreview(merchantId, body=None, x__xgafv=None)</code>
134-
<pre>Requests a review for Free Listings program in the provided region. Important: This method is only whitelisted for selected merchants.
134+
<pre>Requests a review of free listings in a specific region Important: This method is only whitelisted for selected merchants.
135135

136136
Args:
137137
merchantId: string, Required. The ID of the account. (required)

docs/dyn/content_v2_1.products.html

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -170,6 +170,7 @@ <h3>Method Details</h3>
170170
&quot;A String&quot;,
171171
],
172172
&quot;expirationDate&quot;: &quot;A String&quot;, # Date on which the item should expire, as specified upon insertion, in ISO 8601 format. The actual expiration date in Google Shopping is exposed in `productstatuses` as `googleExpirationDate` and might be earlier if `expirationDate` is too far in the future.
173+
&quot;externalSellerId&quot;: &quot;A String&quot;, # Required for multi-seller accounts. Use this attribute if you&#x27;re a marketplace uploading products for various sellers to your multi-seller account.
173174
&quot;gender&quot;: &quot;A String&quot;, # Target gender of the item.
174175
&quot;googleProductCategory&quot;: &quot;A String&quot;, # Google&#x27;s category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
175176
&quot;gtin&quot;: &quot;A String&quot;, # Global Trade Item Number (GTIN) of the item.
@@ -407,6 +408,7 @@ <h3>Method Details</h3>
407408
&quot;A String&quot;,
408409
],
409410
&quot;expirationDate&quot;: &quot;A String&quot;, # Date on which the item should expire, as specified upon insertion, in ISO 8601 format. The actual expiration date in Google Shopping is exposed in `productstatuses` as `googleExpirationDate` and might be earlier if `expirationDate` is too far in the future.
411+
&quot;externalSellerId&quot;: &quot;A String&quot;, # Required for multi-seller accounts. Use this attribute if you&#x27;re a marketplace uploading products for various sellers to your multi-seller account.
410412
&quot;gender&quot;: &quot;A String&quot;, # Target gender of the item.
411413
&quot;googleProductCategory&quot;: &quot;A String&quot;, # Google&#x27;s category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
412414
&quot;gtin&quot;: &quot;A String&quot;, # Global Trade Item Number (GTIN) of the item.
@@ -650,6 +652,7 @@ <h3>Method Details</h3>
650652
&quot;A String&quot;,
651653
],
652654
&quot;expirationDate&quot;: &quot;A String&quot;, # Date on which the item should expire, as specified upon insertion, in ISO 8601 format. The actual expiration date in Google Shopping is exposed in `productstatuses` as `googleExpirationDate` and might be earlier if `expirationDate` is too far in the future.
655+
&quot;externalSellerId&quot;: &quot;A String&quot;, # Required for multi-seller accounts. Use this attribute if you&#x27;re a marketplace uploading products for various sellers to your multi-seller account.
653656
&quot;gender&quot;: &quot;A String&quot;, # Target gender of the item.
654657
&quot;googleProductCategory&quot;: &quot;A String&quot;, # Google&#x27;s category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
655658
&quot;gtin&quot;: &quot;A String&quot;, # Global Trade Item Number (GTIN) of the item.
@@ -868,6 +871,7 @@ <h3>Method Details</h3>
868871
&quot;A String&quot;,
869872
],
870873
&quot;expirationDate&quot;: &quot;A String&quot;, # Date on which the item should expire, as specified upon insertion, in ISO 8601 format. The actual expiration date in Google Shopping is exposed in `productstatuses` as `googleExpirationDate` and might be earlier if `expirationDate` is too far in the future.
874+
&quot;externalSellerId&quot;: &quot;A String&quot;, # Required for multi-seller accounts. Use this attribute if you&#x27;re a marketplace uploading products for various sellers to your multi-seller account.
871875
&quot;gender&quot;: &quot;A String&quot;, # Target gender of the item.
872876
&quot;googleProductCategory&quot;: &quot;A String&quot;, # Google&#x27;s category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
873877
&quot;gtin&quot;: &quot;A String&quot;, # Global Trade Item Number (GTIN) of the item.
@@ -1085,6 +1089,7 @@ <h3>Method Details</h3>
10851089
&quot;A String&quot;,
10861090
],
10871091
&quot;expirationDate&quot;: &quot;A String&quot;, # Date on which the item should expire, as specified upon insertion, in ISO 8601 format. The actual expiration date in Google Shopping is exposed in `productstatuses` as `googleExpirationDate` and might be earlier if `expirationDate` is too far in the future.
1092+
&quot;externalSellerId&quot;: &quot;A String&quot;, # Required for multi-seller accounts. Use this attribute if you&#x27;re a marketplace uploading products for various sellers to your multi-seller account.
10881093
&quot;gender&quot;: &quot;A String&quot;, # Target gender of the item.
10891094
&quot;googleProductCategory&quot;: &quot;A String&quot;, # Google&#x27;s category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
10901095
&quot;gtin&quot;: &quot;A String&quot;, # Global Trade Item Number (GTIN) of the item.
@@ -1314,6 +1319,7 @@ <h3>Method Details</h3>
13141319
&quot;A String&quot;,
13151320
],
13161321
&quot;expirationDate&quot;: &quot;A String&quot;, # Date on which the item should expire, as specified upon insertion, in ISO 8601 format. The actual expiration date in Google Shopping is exposed in `productstatuses` as `googleExpirationDate` and might be earlier if `expirationDate` is too far in the future.
1322+
&quot;externalSellerId&quot;: &quot;A String&quot;, # Required for multi-seller accounts. Use this attribute if you&#x27;re a marketplace uploading products for various sellers to your multi-seller account.
13171323
&quot;gender&quot;: &quot;A String&quot;, # Target gender of the item.
13181324
&quot;googleProductCategory&quot;: &quot;A String&quot;, # Google&#x27;s category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
13191325
&quot;gtin&quot;: &quot;A String&quot;, # Global Trade Item Number (GTIN) of the item.
@@ -1549,6 +1555,7 @@ <h3>Method Details</h3>
15491555
&quot;A String&quot;,
15501556
],
15511557
&quot;expirationDate&quot;: &quot;A String&quot;, # Date on which the item should expire, as specified upon insertion, in ISO 8601 format. The actual expiration date in Google Shopping is exposed in `productstatuses` as `googleExpirationDate` and might be earlier if `expirationDate` is too far in the future.
1558+
&quot;externalSellerId&quot;: &quot;A String&quot;, # Required for multi-seller accounts. Use this attribute if you&#x27;re a marketplace uploading products for various sellers to your multi-seller account.
15521559
&quot;gender&quot;: &quot;A String&quot;, # Target gender of the item.
15531560
&quot;googleProductCategory&quot;: &quot;A String&quot;, # Google&#x27;s category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
15541561
&quot;gtin&quot;: &quot;A String&quot;, # Global Trade Item Number (GTIN) of the item.
@@ -1766,6 +1773,7 @@ <h3>Method Details</h3>
17661773
&quot;A String&quot;,
17671774
],
17681775
&quot;expirationDate&quot;: &quot;A String&quot;, # Date on which the item should expire, as specified upon insertion, in ISO 8601 format. The actual expiration date in Google Shopping is exposed in `productstatuses` as `googleExpirationDate` and might be earlier if `expirationDate` is too far in the future.
1776+
&quot;externalSellerId&quot;: &quot;A String&quot;, # Required for multi-seller accounts. Use this attribute if you&#x27;re a marketplace uploading products for various sellers to your multi-seller account.
17691777
&quot;gender&quot;: &quot;A String&quot;, # Target gender of the item.
17701778
&quot;googleProductCategory&quot;: &quot;A String&quot;, # Google&#x27;s category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
17711779
&quot;gtin&quot;: &quot;A String&quot;, # Global Trade Item Number (GTIN) of the item.

docs/dyn/content_v2_1.productstatuses.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -115,7 +115,7 @@ <h3>Method Details</h3>
115115
&quot;destinations&quot;: [ # If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.
116116
&quot;A String&quot;,
117117
],
118-
&quot;includeAttributes&quot;: True or False,
118+
&quot;includeAttributes&quot;: True or False, # Deprecated: Setting this field has no effect and attributes are never included.
119119
&quot;merchantId&quot;: &quot;A String&quot;, # The ID of the managing account.
120120
&quot;method&quot;: &quot;A String&quot;, # The method of the batch entry. Acceptable values are: - &quot;`get`&quot;
121121
&quot;productId&quot;: &quot;A String&quot;, # The ID of the product whose status to get.

docs/dyn/content_v2_1.promotions.html

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,7 @@ <h3>Method Details</h3>
105105
&quot;brandExclusion&quot;: [ # Product filter by brand exclusion for the promotion.
106106
&quot;A String&quot;,
107107
],
108-
&quot;contentLanguage&quot;: &quot;A String&quot;, # Required. The content language used as part of the unique identifier.
108+
&quot;contentLanguage&quot;: &quot;A String&quot;, # Required. The content language used as part of the unique identifier. Currently only en value is supported.
109109
&quot;couponValueType&quot;: &quot;A String&quot;, # Required. Coupon value type for the promotion.
110110
&quot;freeGiftDescription&quot;: &quot;A String&quot;, # Free gift description for the promotion.
111111
&quot;freeGiftItemId&quot;: &quot;A String&quot;, # Free gift item id for the promotion.
@@ -177,7 +177,7 @@ <h3>Method Details</h3>
177177
&quot;shippingServiceNames&quot;: [ # Shipping service names for thse promotion.
178178
&quot;A String&quot;,
179179
],
180-
&quot;targetCountry&quot;: &quot;A String&quot;, # Required. The target country used as part of the unique identifier.
180+
&quot;targetCountry&quot;: &quot;A String&quot;, # Required. The target country used as part of the unique identifier. Currently only US and CA are supported.
181181
}
182182

183183
x__xgafv: string, V1 error format.
@@ -195,7 +195,7 @@ <h3>Method Details</h3>
195195
&quot;brandExclusion&quot;: [ # Product filter by brand exclusion for the promotion.
196196
&quot;A String&quot;,
197197
],
198-
&quot;contentLanguage&quot;: &quot;A String&quot;, # Required. The content language used as part of the unique identifier.
198+
&quot;contentLanguage&quot;: &quot;A String&quot;, # Required. The content language used as part of the unique identifier. Currently only en value is supported.
199199
&quot;couponValueType&quot;: &quot;A String&quot;, # Required. Coupon value type for the promotion.
200200
&quot;freeGiftDescription&quot;: &quot;A String&quot;, # Free gift description for the promotion.
201201
&quot;freeGiftItemId&quot;: &quot;A String&quot;, # Free gift item id for the promotion.
@@ -267,7 +267,7 @@ <h3>Method Details</h3>
267267
&quot;shippingServiceNames&quot;: [ # Shipping service names for thse promotion.
268268
&quot;A String&quot;,
269269
],
270-
&quot;targetCountry&quot;: &quot;A String&quot;, # Required. The target country used as part of the unique identifier.
270+
&quot;targetCountry&quot;: &quot;A String&quot;, # Required. The target country used as part of the unique identifier. Currently only US and CA are supported.
271271
}</pre>
272272
</div>
273273

@@ -293,7 +293,7 @@ <h3>Method Details</h3>
293293
&quot;brandExclusion&quot;: [ # Product filter by brand exclusion for the promotion.
294294
&quot;A String&quot;,
295295
],
296-
&quot;contentLanguage&quot;: &quot;A String&quot;, # Required. The content language used as part of the unique identifier.
296+
&quot;contentLanguage&quot;: &quot;A String&quot;, # Required. The content language used as part of the unique identifier. Currently only en value is supported.
297297
&quot;couponValueType&quot;: &quot;A String&quot;, # Required. Coupon value type for the promotion.
298298
&quot;freeGiftDescription&quot;: &quot;A String&quot;, # Free gift description for the promotion.
299299
&quot;freeGiftItemId&quot;: &quot;A String&quot;, # Free gift item id for the promotion.
@@ -365,7 +365,7 @@ <h3>Method Details</h3>
365365
&quot;shippingServiceNames&quot;: [ # Shipping service names for thse promotion.
366366
&quot;A String&quot;,
367367
],
368-
&quot;targetCountry&quot;: &quot;A String&quot;, # Required. The target country used as part of the unique identifier.
368+
&quot;targetCountry&quot;: &quot;A String&quot;, # Required. The target country used as part of the unique identifier. Currently only US and CA are supported.
369369
}</pre>
370370
</div>
371371

0 commit comments

Comments
 (0)