• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<html><body>
2<style>
3
4body, 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
15body {
16  font-size: 13px;
17  padding: 1em;
18}
19
20h1 {
21  font-size: 26px;
22  margin-bottom: 1em;
23}
24
25h2 {
26  font-size: 24px;
27  margin-bottom: 1em;
28}
29
30h3 {
31  font-size: 20px;
32  margin-bottom: 1em;
33  margin-top: 1em;
34}
35
36pre, code {
37  line-height: 1.5;
38  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42  margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46  font-family: Arial, sans serif;
47}
48
49h1, 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.html">Content API for Shopping</a> . <a href="content_v2.orderreturns.html">orderreturns</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78  <code><a href="#get">get(merchantId, returnId)</a></code></p>
79<p class="firstline">Retrieves an order return from your Merchant Center account.</p>
80<p class="toc_element">
81  <code><a href="#list">list(merchantId, orderBy=None, pageToken=None, createdEndDate=None, maxResults=None, createdStartDate=None)</a></code></p>
82<p class="firstline">Lists order returns in your Merchant Center account.</p>
83<p class="toc_element">
84  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
85<p class="firstline">Retrieves the next page of results.</p>
86<h3>Method Details</h3>
87<div class="method">
88    <code class="details" id="get">get(merchantId, returnId)</code>
89  <pre>Retrieves an order return from your Merchant Center account.
90
91Args:
92  merchantId: string, The ID of the account that manages the order. This cannot be a multi-client account. (required)
93  returnId: string, Merchant order return ID generated by Google. (required)
94
95Returns:
96  An object of the form:
97
98    {
99    "orderId": "A String",
100    "returnShipments": [
101      {
102        "returnMethodType": "A String",
103        "state": "A String",
104        "shipmentTrackingInfos": [
105          {
106            "trackingNumber": "A String",
107            "carrier": "A String",
108          },
109        ],
110        "shipmentId": "A String",
111        "deliveryDate": "A String",
112        "creationDate": "A String",
113        "shippingDate": "A String",
114      },
115    ],
116    "orderReturnId": "A String",
117    "returnItems": [
118      {
119        "itemId": "A String",
120        "product": {
121          "targetCountry": "A String", # The CLDR territory code of the target country of the product.
122          "shownImage": "A String", # URL to the cached image shown to the user when order was placed.
123          "contentLanguage": "A String", # The two-letter ISO 639-1 language code for the item.
124          "title": "A String", # The title of the product.
125          "mpn": "A String", # Manufacturer Part Number (MPN) of the item.
126          "variantAttributes": [ # Variant attributes for the item. These are dimensions of the product, such as color, gender, material, pattern, and size. You can find a comprehensive list of variant attributes here.
127            {
128              "dimension": "A String", # The dimension of the variant.
129              "value": "A String", # The value for the dimension.
130            },
131          ],
132          "brand": "A String", # Brand of the item.
133          "itemGroupId": "A String", # Shared identifier for all variants of the same product.
134          "offerId": "A String", # An identifier of the item.
135          "price": { # Price of the item.
136            "currency": "A String", # The currency of the price.
137            "value": "A String", # The price represented as a number.
138          },
139          "imageLink": "A String", # URL of an image of the item.
140          "gtin": "A String", # Global Trade Item Number (GTIN) of the item.
141          "channel": "A String", # The item's channel (online or local).
142          "fees": [ # Associated fees at order creation time.
143            {
144              "amount": { # Amount of the fee.
145                "currency": "A String", # The currency of the price.
146                "value": "A String", # The price represented as a number.
147              },
148              "name": "A String", # Name of the fee.
149            },
150          ],
151          "id": "A String", # The REST ID of the product.
152          "condition": "A String", # Condition or state of the item.
153        },
154        "returnShipmentIds": [
155          "A String",
156        ],
157        "state": "A String",
158        "customerReturnReason": {
159          "reasonCode": "A String",
160          "description": "A String",
161        },
162        "merchantReturnReason": {
163          "reasonCode": "A String",
164          "description": "A String",
165        },
166      },
167    ],
168    "merchantOrderId": "A String",
169    "creationDate": "A String",
170  }</pre>
171</div>
172
173<div class="method">
174    <code class="details" id="list">list(merchantId, orderBy=None, pageToken=None, createdEndDate=None, maxResults=None, createdStartDate=None)</code>
175  <pre>Lists order returns in your Merchant Center account.
176
177Args:
178  merchantId: string, The ID of the account that manages the order. This cannot be a multi-client account. (required)
179  orderBy: string, Return the results in the specified order.
180    Allowed values
181      returnCreationTimeAsc -
182      returnCreationTimeDesc -
183  pageToken: string, The token returned by the previous request.
184  createdEndDate: string, Obtains order returns created before this date (inclusively), in ISO 8601 format.
185  maxResults: integer, The maximum number of order returns to return in the response, used for paging. The default value is 25 returns per page, and the maximum allowed value is 250 returns per page.
186  createdStartDate: string, Obtains order returns created after this date (inclusively), in ISO 8601 format.
187
188Returns:
189  An object of the form:
190
191    {
192    "nextPageToken": "A String", # The token for the retrieval of the next page of returns.
193    "kind": "content#orderreturnsListResponse", # Identifies what kind of resource this is. Value: the fixed string "content#orderreturnsListResponse".
194    "resources": [
195      {
196        "orderId": "A String",
197        "returnShipments": [
198          {
199            "returnMethodType": "A String",
200            "state": "A String",
201            "shipmentTrackingInfos": [
202              {
203                "trackingNumber": "A String",
204                "carrier": "A String",
205              },
206            ],
207            "shipmentId": "A String",
208            "deliveryDate": "A String",
209            "creationDate": "A String",
210            "shippingDate": "A String",
211          },
212        ],
213        "orderReturnId": "A String",
214        "returnItems": [
215          {
216            "itemId": "A String",
217            "product": {
218              "targetCountry": "A String", # The CLDR territory code of the target country of the product.
219              "shownImage": "A String", # URL to the cached image shown to the user when order was placed.
220              "contentLanguage": "A String", # The two-letter ISO 639-1 language code for the item.
221              "title": "A String", # The title of the product.
222              "mpn": "A String", # Manufacturer Part Number (MPN) of the item.
223              "variantAttributes": [ # Variant attributes for the item. These are dimensions of the product, such as color, gender, material, pattern, and size. You can find a comprehensive list of variant attributes here.
224                {
225                  "dimension": "A String", # The dimension of the variant.
226                  "value": "A String", # The value for the dimension.
227                },
228              ],
229              "brand": "A String", # Brand of the item.
230              "itemGroupId": "A String", # Shared identifier for all variants of the same product.
231              "offerId": "A String", # An identifier of the item.
232              "price": { # Price of the item.
233                "currency": "A String", # The currency of the price.
234                "value": "A String", # The price represented as a number.
235              },
236              "imageLink": "A String", # URL of an image of the item.
237              "gtin": "A String", # Global Trade Item Number (GTIN) of the item.
238              "channel": "A String", # The item's channel (online or local).
239              "fees": [ # Associated fees at order creation time.
240                {
241                  "amount": { # Amount of the fee.
242                    "currency": "A String", # The currency of the price.
243                    "value": "A String", # The price represented as a number.
244                  },
245                  "name": "A String", # Name of the fee.
246                },
247              ],
248              "id": "A String", # The REST ID of the product.
249              "condition": "A String", # Condition or state of the item.
250            },
251            "returnShipmentIds": [
252              "A String",
253            ],
254            "state": "A String",
255            "customerReturnReason": {
256              "reasonCode": "A String",
257              "description": "A String",
258            },
259            "merchantReturnReason": {
260              "reasonCode": "A String",
261              "description": "A String",
262            },
263          },
264        ],
265        "merchantOrderId": "A String",
266        "creationDate": "A String",
267      },
268    ],
269  }</pre>
270</div>
271
272<div class="method">
273    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
274  <pre>Retrieves the next page of results.
275
276Args:
277  previous_request: The request for the previous page. (required)
278  previous_response: The response from the request for the previous page. (required)
279
280Returns:
281  A request object that you can call 'execute()' on to request the next
282  page. Returns None if there are no more items in the collection.
283    </pre>
284</div>
285
286</body></html>