Skip to content

Commit f676365

Browse files
chore(content): update the api
#### content:v2.1 The following keys were deleted: - schemas.AccountLabel.properties.accountId (Total Keys: 1) The following keys were added: - resources.accounts.resources.credentials.methods.create (Total Keys: 12) - resources.accounts.resources.returncarrier.methods.create (Total Keys: 12) - resources.accounts.resources.returncarrier.methods.delete (Total Keys: 14) - resources.accounts.resources.returncarrier.methods.list (Total Keys: 11) - resources.accounts.resources.returncarrier.methods.patch (Total Keys: 16) - resources.buyongoogleprograms.methods.get (Total Keys: 14) - resources.buyongoogleprograms.methods.onboard (Total Keys: 14) - resources.collections.methods.create (Total Keys: 12) - resources.collections.methods.delete (Total Keys: 13) - resources.collections.methods.get (Total Keys: 14) - resources.collections.methods.list (Total Keys: 16) - resources.collectionstatuses.methods.get (Total Keys: 14) - resources.collectionstatuses.methods.list (Total Keys: 16) - resources.productstatuses.resources.repricingreports.methods.list (Total Keys: 25) - resources.reports.methods.search (Total Keys: 12) - resources.repricingrules.resources.repricingreports.methods.list (Total Keys: 23) - resources.returnpolicyonline.methods.create (Total Keys: 12) - resources.returnpolicyonline.methods.delete (Total Keys: 13) - resources.returnpolicyonline.methods.get (Total Keys: 14) - resources.returnpolicyonline.methods.list (Total Keys: 11) - resources.returnpolicyonline.methods.patch (Total Keys: 15) - schemas.Account.properties.automaticLabelIds (Total Keys: 3) - schemas.AccountCredentials (Total Keys: 6) - schemas.AccountLabel.properties.labelType (Total Keys: 2) - schemas.AccountReturnCarrier (Total Keys: 8) - schemas.BuyOnGoogleProgramStatus (Total Keys: 5) - schemas.Collection (Total Keys: 46) - schemas.Date (Total Keys: 8) - schemas.InapplicabilityDetails (Total Keys: 5) - schemas.ListAccountReturnCarrierResponse (Total Keys: 4) - schemas.ListCollectionStatusesResponse (Total Keys: 5) - schemas.ListCollectionsResponse (Total Keys: 5) - schemas.ListRepricingProductReportsResponse (Total Keys: 5) - schemas.ListRepricingRuleReportsResponse (Total Keys: 5) - schemas.ListReturnPolicyOnlineResponse (Total Keys: 4) - schemas.Metrics (Total Keys: 8) - schemas.OnboardBuyOnGoogleProgramRequest (Total Keys: 3) - schemas.OrdersCustomBatchRequestEntryUpdateShipmentScheduledDeliveryDetails (Total Keys: 3) - schemas.OrdersUpdateShipmentRequest.properties.scheduledDeliveryDetails (Total Keys: 1) - schemas.ReportRow (Total Keys: 4) - schemas.RepricingProductReport (Total Keys: 20) - schemas.RepricingRule.properties.cogsBasedRule (Total Keys: 1) - schemas.RepricingRule.properties.statsBasedRule (Total Keys: 1) - schemas.RepricingRuleCostOfGoodsSaleRule (Total Keys: 5) - schemas.RepricingRuleEligibleOfferMatcher.properties.skipWhenOnPromotion (Total Keys: 1) - schemas.RepricingRuleReport (Total Keys: 19) - schemas.RepricingRuleStatsBasedRule (Total Keys: 5) - schemas.ReturnPolicy.properties.returnShippingFee (Total Keys: 1) - schemas.ReturnPolicyOnline (Total Keys: 36) - schemas.SearchRequest (Total Keys: 6) - schemas.SearchResponse (Total Keys: 5) - schemas.Segments (Total Keys: 5) - schemas.TestOrderDeliveryDetails.properties.isScheduledDelivery (Total Keys: 1)
1 parent 4b55158 commit f676365

26 files changed

+26562
-22836
lines changed

docs/dyn/content_v2.liasettings.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -194,7 +194,7 @@ <h3>Method Details</h3>
194194
],
195195
&quot;message&quot;: &quot;A String&quot;, # The message of the first error in `errors`.
196196
},
197-
&quot;gmbAccounts&quot;: { # The the list of accessible GMB accounts.
197+
&quot;gmbAccounts&quot;: { # The list of accessible GMB accounts.
198198
&quot;accountId&quot;: &quot;A String&quot;, # The ID of the Merchant Center account.
199199
&quot;gmbAccounts&quot;: [ # A list of GMB accounts which are available to the merchant.
200200
{

docs/dyn/content_v2.orders.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2067,7 +2067,7 @@ <h3>Method Details</h3>
20672067
&quot;lineItemId&quot;: &quot;A String&quot;, # The ID of the line item to return. Either lineItemId or productId is required.
20682068
&quot;operationId&quot;: &quot;A String&quot;, # The ID of the operation. Unique across all operations for a given order.
20692069
&quot;productId&quot;: &quot;A String&quot;, # The ID of the product to return. This is the REST ID used in the products service. Either lineItemId or productId is required.
2070-
&quot;quantity&quot;: 42, # The quantity to return and refund.
2070+
&quot;quantity&quot;: 42, # The quantity to return and refund. Quantity is required.
20712071
&quot;reason&quot;: &quot;A String&quot;, # The reason for the return. Acceptable values are: - &quot;`customerDiscretionaryReturn`&quot; - &quot;`customerInitiatedMerchantCancel`&quot; - &quot;`deliveredTooLate`&quot; - &quot;`expiredItem`&quot; - &quot;`invalidCoupon`&quot; - &quot;`malformedShippingAddress`&quot; - &quot;`other`&quot; - &quot;`productArrivedDamaged`&quot; - &quot;`productNotAsDescribed`&quot; - &quot;`qualityNotAsExpected`&quot; - &quot;`undeliverableShippingAddress`&quot; - &quot;`unsupportedPoBoxAddress`&quot; - &quot;`wrongProductShipped`&quot;
20722072
&quot;reasonText&quot;: &quot;A String&quot;, # The explanation of the reason.
20732073
}

docs/dyn/content_v2.products.html

Lines changed: 12 additions & 12 deletions
Large diffs are not rendered by default.

docs/dyn/content_v2.productstatuses.html

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -209,7 +209,7 @@ <h3>Method Details</h3>
209209
&quot;canonicalLink&quot;: &quot;A String&quot;, # URL for the canonical version of your item&#x27;s landing page.
210210
&quot;channel&quot;: &quot;A String&quot;, # Required. The item&#x27;s channel (online or local). Acceptable values are: - &quot;`local`&quot; - &quot;`online`&quot;
211211
&quot;color&quot;: &quot;A String&quot;, # Color of the item.
212-
&quot;condition&quot;: &quot;A String&quot;, # Condition or state of the item. Acceptable values are: - &quot;`local`&quot; - &quot;`online`&quot;
212+
&quot;condition&quot;: &quot;A String&quot;, # Condition or state of the item. Acceptable values are: - &quot;`new`&quot; - &quot;`refurbished`&quot; - &quot;`used`&quot;
213213
&quot;contentLanguage&quot;: &quot;A String&quot;, # Required. The two-letter ISO 639-1 language code for the item.
214214
&quot;costOfGoodsSold&quot;: { # Cost of goods sold. Used for gross profit reporting.
215215
&quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
@@ -258,7 +258,7 @@ <h3>Method Details</h3>
258258
&quot;energyEfficiencyClass&quot;: &quot;A String&quot;, # The energy efficiency class as defined in EU directive 2010/30/EU. Acceptable values are: - &quot;`A`&quot; - &quot;`A+`&quot; - &quot;`A++`&quot; - &quot;`A+++`&quot; - &quot;`B`&quot; - &quot;`C`&quot; - &quot;`D`&quot; - &quot;`E`&quot; - &quot;`F`&quot; - &quot;`G`&quot;
259259
&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.
260260
&quot;gender&quot;: &quot;A String&quot;, # Target gender of the item. Acceptable values are: - &quot;`female`&quot; - &quot;`male`&quot; - &quot;`unisex`&quot;
261-
&quot;googleProductCategory&quot;: &quot;A String&quot;, # Google&#x27;s category of the item (see Google product taxonomy).
261+
&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.
262262
&quot;gtin&quot;: &quot;A String&quot;, # Global Trade Item Number (GTIN) of the item.
263263
&quot;id&quot;: &quot;A String&quot;, # The REST ID of the product. Content API methods that operate on products take this as their `productId` parameter. The REST ID for a product is of the form channel:contentLanguage: targetCountry: offerId.
264264
&quot;identifierExists&quot;: True or False, # False when the item does not have unique product identifiers appropriate to its category, such as GTIN, MPN, and brand. Required according to the Unique Product Identifier Rules for all target countries except for Canada.
@@ -464,7 +464,7 @@ <h3>Method Details</h3>
464464
&quot;canonicalLink&quot;: &quot;A String&quot;, # URL for the canonical version of your item&#x27;s landing page.
465465
&quot;channel&quot;: &quot;A String&quot;, # Required. The item&#x27;s channel (online or local). Acceptable values are: - &quot;`local`&quot; - &quot;`online`&quot;
466466
&quot;color&quot;: &quot;A String&quot;, # Color of the item.
467-
&quot;condition&quot;: &quot;A String&quot;, # Condition or state of the item. Acceptable values are: - &quot;`local`&quot; - &quot;`online`&quot;
467+
&quot;condition&quot;: &quot;A String&quot;, # Condition or state of the item. Acceptable values are: - &quot;`new`&quot; - &quot;`refurbished`&quot; - &quot;`used`&quot;
468468
&quot;contentLanguage&quot;: &quot;A String&quot;, # Required. The two-letter ISO 639-1 language code for the item.
469469
&quot;costOfGoodsSold&quot;: { # Cost of goods sold. Used for gross profit reporting.
470470
&quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
@@ -513,7 +513,7 @@ <h3>Method Details</h3>
513513
&quot;energyEfficiencyClass&quot;: &quot;A String&quot;, # The energy efficiency class as defined in EU directive 2010/30/EU. Acceptable values are: - &quot;`A`&quot; - &quot;`A+`&quot; - &quot;`A++`&quot; - &quot;`A+++`&quot; - &quot;`B`&quot; - &quot;`C`&quot; - &quot;`D`&quot; - &quot;`E`&quot; - &quot;`F`&quot; - &quot;`G`&quot;
514514
&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.
515515
&quot;gender&quot;: &quot;A String&quot;, # Target gender of the item. Acceptable values are: - &quot;`female`&quot; - &quot;`male`&quot; - &quot;`unisex`&quot;
516-
&quot;googleProductCategory&quot;: &quot;A String&quot;, # Google&#x27;s category of the item (see Google product taxonomy).
516+
&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.
517517
&quot;gtin&quot;: &quot;A String&quot;, # Global Trade Item Number (GTIN) of the item.
518518
&quot;id&quot;: &quot;A String&quot;, # The REST ID of the product. Content API methods that operate on products take this as their `productId` parameter. The REST ID for a product is of the form channel:contentLanguage: targetCountry: offerId.
519519
&quot;identifierExists&quot;: True or False, # False when the item does not have unique product identifiers appropriate to its category, such as GTIN, MPN, and brand. Required according to the Unique Product Identifier Rules for all target countries except for Canada.
@@ -721,7 +721,7 @@ <h3>Method Details</h3>
721721
&quot;canonicalLink&quot;: &quot;A String&quot;, # URL for the canonical version of your item&#x27;s landing page.
722722
&quot;channel&quot;: &quot;A String&quot;, # Required. The item&#x27;s channel (online or local). Acceptable values are: - &quot;`local`&quot; - &quot;`online`&quot;
723723
&quot;color&quot;: &quot;A String&quot;, # Color of the item.
724-
&quot;condition&quot;: &quot;A String&quot;, # Condition or state of the item. Acceptable values are: - &quot;`local`&quot; - &quot;`online`&quot;
724+
&quot;condition&quot;: &quot;A String&quot;, # Condition or state of the item. Acceptable values are: - &quot;`new`&quot; - &quot;`refurbished`&quot; - &quot;`used`&quot;
725725
&quot;contentLanguage&quot;: &quot;A String&quot;, # Required. The two-letter ISO 639-1 language code for the item.
726726
&quot;costOfGoodsSold&quot;: { # Cost of goods sold. Used for gross profit reporting.
727727
&quot;currency&quot;: &quot;A String&quot;, # The currency of the price.
@@ -770,7 +770,7 @@ <h3>Method Details</h3>
770770
&quot;energyEfficiencyClass&quot;: &quot;A String&quot;, # The energy efficiency class as defined in EU directive 2010/30/EU. Acceptable values are: - &quot;`A`&quot; - &quot;`A+`&quot; - &quot;`A++`&quot; - &quot;`A+++`&quot; - &quot;`B`&quot; - &quot;`C`&quot; - &quot;`D`&quot; - &quot;`E`&quot; - &quot;`F`&quot; - &quot;`G`&quot;
771771
&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.
772772
&quot;gender&quot;: &quot;A String&quot;, # Target gender of the item. Acceptable values are: - &quot;`female`&quot; - &quot;`male`&quot; - &quot;`unisex`&quot;
773-
&quot;googleProductCategory&quot;: &quot;A String&quot;, # Google&#x27;s category of the item (see Google product taxonomy).
773+
&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.
774774
&quot;gtin&quot;: &quot;A String&quot;, # Global Trade Item Number (GTIN) of the item.
775775
&quot;id&quot;: &quot;A String&quot;, # The REST ID of the product. Content API methods that operate on products take this as their `productId` parameter. The REST ID for a product is of the form channel:contentLanguage: targetCountry: offerId.
776776
&quot;identifierExists&quot;: True or False, # False when the item does not have unique product identifiers appropriate to its category, such as GTIN, MPN, and brand. Required according to the Unique Product Identifier Rules for all target countries except for Canada.
Lines changed: 119 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,119 @@
1+
<html><body>
2+
<style>
3+
4+
body, h1, h2, h3, div, span, p, pre, a {
5+
margin: 0;
6+
padding: 0;
7+
border: 0;
8+
font-weight: inherit;
9+
font-style: inherit;
10+
font-size: 100%;
11+
font-family: inherit;
12+
vertical-align: baseline;
13+
}
14+
15+
body {
16+
font-size: 13px;
17+
padding: 1em;
18+
}
19+
20+
h1 {
21+
font-size: 26px;
22+
margin-bottom: 1em;
23+
}
24+
25+
h2 {
26+
font-size: 24px;
27+
margin-bottom: 1em;
28+
}
29+
30+
h3 {
31+
font-size: 20px;
32+
margin-bottom: 1em;
33+
margin-top: 1em;
34+
}
35+
36+
pre, code {
37+
line-height: 1.5;
38+
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39+
}
40+
41+
pre {
42+
margin-top: 0.5em;
43+
}
44+
45+
h1, h2, h3, p {
46+
font-family: Arial, sans serif;
47+
}
48+
49+
h1, h2, h3 {
50+
border-bottom: solid #CCC 1px;
51+
}
52+
53+
.toc_element {
54+
margin-top: 0.5em;
55+
}
56+
57+
.firstline {
58+
margin-left: 2 em;
59+
}
60+
61+
.method {
62+
margin-top: 1em;
63+
border: solid 1px #CCC;
64+
padding: 1em;
65+
background: #EEE;
66+
}
67+
68+
.details {
69+
font-weight: bold;
70+
font-size: 14px;
71+
}
72+
73+
</style>
74+
75+
<h1><a href="content_v2_1.html">Content API for Shopping</a> . <a href="content_v2_1.accounts.html">accounts</a> . <a href="content_v2_1.accounts.credentials.html">credentials</a></h1>
76+
<h2>Instance Methods</h2>
77+
<p class="toc_element">
78+
<code><a href="#close">close()</a></code></p>
79+
<p class="firstline">Close httplib2 connections.</p>
80+
<p class="toc_element">
81+
<code><a href="#create">create(accountId, body=None, x__xgafv=None)</a></code></p>
82+
<p class="firstline">Uploads credentials for the Merchant Center account. If credentials already exist for this Merchant Center account and purpose, this method updates them.</p>
83+
<h3>Method Details</h3>
84+
<div class="method">
85+
<code class="details" id="close">close()</code>
86+
<pre>Close httplib2 connections.</pre>
87+
</div>
88+
89+
<div class="method">
90+
<code class="details" id="create">create(accountId, body=None, x__xgafv=None)</code>
91+
<pre>Uploads credentials for the Merchant Center account. If credentials already exist for this Merchant Center account and purpose, this method updates them.
92+
93+
Args:
94+
accountId: string, Required. The merchant id of the account these credentials belong to. (required)
95+
body: object, The request body.
96+
The object takes the form of:
97+
98+
{ # Credentials allowing Google to call a partner&#x27;s API on behalf of a merchant.
99+
&quot;accessToken&quot;: &quot;A String&quot;, # An OAuth access token.
100+
&quot;expiresIn&quot;: &quot;A String&quot;, # The amount of time, in seconds, after which the access token is no longer valid.
101+
&quot;purpose&quot;: &quot;A String&quot;, # Indicates to Google how Google should use these OAuth tokens.
102+
}
103+
104+
x__xgafv: string, V1 error format.
105+
Allowed values
106+
1 - v1 error format
107+
2 - v2 error format
108+
109+
Returns:
110+
An object of the form:
111+
112+
{ # Credentials allowing Google to call a partner&#x27;s API on behalf of a merchant.
113+
&quot;accessToken&quot;: &quot;A String&quot;, # An OAuth access token.
114+
&quot;expiresIn&quot;: &quot;A String&quot;, # The amount of time, in seconds, after which the access token is no longer valid.
115+
&quot;purpose&quot;: &quot;A String&quot;, # Indicates to Google how Google should use these OAuth tokens.
116+
}</pre>
117+
</div>
118+
119+
</body></html>

0 commit comments

Comments
 (0)