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_v2sandbox.html">Content API for Shopping</a> . <a href="content_v2sandbox.orders.html">orders</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#acknowledge">acknowledge(merchantId, orderId, body)</a></code></p> 79<p class="firstline">Marks an order as acknowledged. This method can only be called for non-multi-client accounts.</p> 80<p class="toc_element"> 81 <code><a href="#advancetestorder">advancetestorder(merchantId, orderId)</a></code></p> 82<p class="firstline">Sandbox only. Moves a test order from state "inProgress" to state "pendingShipment". This method can only be called for non-multi-client accounts.</p> 83<p class="toc_element"> 84 <code><a href="#cancel">cancel(merchantId, orderId, body)</a></code></p> 85<p class="firstline">Cancels all line items in an order, making a full refund. This method can only be called for non-multi-client accounts.</p> 86<p class="toc_element"> 87 <code><a href="#cancellineitem">cancellineitem(merchantId, orderId, body)</a></code></p> 88<p class="firstline">Cancels a line item, making a full refund. This method can only be called for non-multi-client accounts.</p> 89<p class="toc_element"> 90 <code><a href="#createtestorder">createtestorder(merchantId, body)</a></code></p> 91<p class="firstline">Sandbox only. Creates a test order. This method can only be called for non-multi-client accounts.</p> 92<p class="toc_element"> 93 <code><a href="#custombatch">custombatch(body)</a></code></p> 94<p class="firstline">Retrieves or modifies multiple orders in a single request. This method can only be called for non-multi-client accounts.</p> 95<p class="toc_element"> 96 <code><a href="#get">get(merchantId, orderId)</a></code></p> 97<p class="firstline">Retrieves an order from your Merchant Center account. This method can only be called for non-multi-client accounts.</p> 98<p class="toc_element"> 99 <code><a href="#getbymerchantorderid">getbymerchantorderid(merchantId, merchantOrderId)</a></code></p> 100<p class="firstline">Retrieves an order using merchant order id. This method can only be called for non-multi-client accounts.</p> 101<p class="toc_element"> 102 <code><a href="#gettestordertemplate">gettestordertemplate(merchantId, templateName)</a></code></p> 103<p class="firstline">Sandbox only. Retrieves an order template that can be used to quickly create a new order in sandbox. This method can only be called for non-multi-client accounts.</p> 104<p class="toc_element"> 105 <code><a href="#list">list(merchantId, orderBy=None, pageToken=None, placedDateEnd=None, acknowledged=None, maxResults=None, placedDateStart=None, statuses=None)</a></code></p> 106<p class="firstline">Lists the orders in your Merchant Center account. This method can only be called for non-multi-client accounts.</p> 107<p class="toc_element"> 108 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> 109<p class="firstline">Retrieves the next page of results.</p> 110<p class="toc_element"> 111 <code><a href="#refund">refund(merchantId, orderId, body)</a></code></p> 112<p class="firstline">Refund a portion of the order, up to the full amount paid. This method can only be called for non-multi-client accounts.</p> 113<p class="toc_element"> 114 <code><a href="#returnlineitem">returnlineitem(merchantId, orderId, body)</a></code></p> 115<p class="firstline">Returns a line item. This method can only be called for non-multi-client accounts.</p> 116<p class="toc_element"> 117 <code><a href="#shiplineitems">shiplineitems(merchantId, orderId, body)</a></code></p> 118<p class="firstline">Marks line item(s) as shipped. This method can only be called for non-multi-client accounts.</p> 119<p class="toc_element"> 120 <code><a href="#updatemerchantorderid">updatemerchantorderid(merchantId, orderId, body)</a></code></p> 121<p class="firstline">Updates the merchant order ID for a given order. This method can only be called for non-multi-client accounts.</p> 122<p class="toc_element"> 123 <code><a href="#updateshipment">updateshipment(merchantId, orderId, body)</a></code></p> 124<p class="firstline">Updates a shipment's status, carrier, and/or tracking ID. This method can only be called for non-multi-client accounts.</p> 125<h3>Method Details</h3> 126<div class="method"> 127 <code class="details" id="acknowledge">acknowledge(merchantId, orderId, body)</code> 128 <pre>Marks an order as acknowledged. This method can only be called for non-multi-client accounts. 129 130Args: 131 merchantId: string, The ID of the managing account. (required) 132 orderId: string, The ID of the order. (required) 133 body: object, The request body. (required) 134 The object takes the form of: 135 136{ 137 "operationId": "A String", # The ID of the operation. Unique across all operations for a given order. 138 } 139 140 141Returns: 142 An object of the form: 143 144 { 145 "kind": "content#ordersAcknowledgeResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersAcknowledgeResponse". 146 "executionStatus": "A String", # The status of the execution. 147 }</pre> 148</div> 149 150<div class="method"> 151 <code class="details" id="advancetestorder">advancetestorder(merchantId, orderId)</code> 152 <pre>Sandbox only. Moves a test order from state "inProgress" to state "pendingShipment". This method can only be called for non-multi-client accounts. 153 154Args: 155 merchantId: string, The ID of the managing account. (required) 156 orderId: string, The ID of the test order to modify. (required) 157 158Returns: 159 An object of the form: 160 161 { 162 "kind": "content#ordersAdvanceTestOrderResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersAdvanceTestOrderResponse". 163 }</pre> 164</div> 165 166<div class="method"> 167 <code class="details" id="cancel">cancel(merchantId, orderId, body)</code> 168 <pre>Cancels all line items in an order, making a full refund. This method can only be called for non-multi-client accounts. 169 170Args: 171 merchantId: string, The ID of the managing account. (required) 172 orderId: string, The ID of the order to cancel. (required) 173 body: object, The request body. (required) 174 The object takes the form of: 175 176{ 177 "reason": "A String", # The reason for the cancellation. 178 "reasonText": "A String", # The explanation of the reason. 179 "operationId": "A String", # The ID of the operation. Unique across all operations for a given order. 180 } 181 182 183Returns: 184 An object of the form: 185 186 { 187 "kind": "content#ordersCancelResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersCancelResponse". 188 "executionStatus": "A String", # The status of the execution. 189 }</pre> 190</div> 191 192<div class="method"> 193 <code class="details" id="cancellineitem">cancellineitem(merchantId, orderId, body)</code> 194 <pre>Cancels a line item, making a full refund. This method can only be called for non-multi-client accounts. 195 196Args: 197 merchantId: string, The ID of the managing account. (required) 198 orderId: string, The ID of the order. (required) 199 body: object, The request body. (required) 200 The object takes the form of: 201 202{ 203 "reason": "A String", # The reason for the cancellation. 204 "amount": { # Amount to refund for the cancelation. Optional. If not set, Google will calculate the default based on the price and tax of the items involved. The amount must not be larger than the net amount left on the order. 205 "currency": "A String", # The currency of the price. 206 "value": "A String", # The price represented as a number. 207 }, 208 "reasonText": "A String", # The explanation of the reason. 209 "lineItemId": "A String", # The ID of the line item to cancel. 210 "operationId": "A String", # The ID of the operation. Unique across all operations for a given order. 211 "quantity": 42, # The quantity to cancel. 212 } 213 214 215Returns: 216 An object of the form: 217 218 { 219 "kind": "content#ordersCancelLineItemResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersCancelLineItemResponse". 220 "executionStatus": "A String", # The status of the execution. 221 }</pre> 222</div> 223 224<div class="method"> 225 <code class="details" id="createtestorder">createtestorder(merchantId, body)</code> 226 <pre>Sandbox only. Creates a test order. This method can only be called for non-multi-client accounts. 227 228Args: 229 merchantId: string, The ID of the managing account. (required) 230 body: object, The request body. (required) 231 The object takes the form of: 232 233{ 234 "testOrder": { # The test order to create. 235 "customer": { # The details of the customer who placed the order. 236 "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow. Optional. 237 "fullName": "A String", # Full name of the customer. 238 "email": "A String", # Email address of the customer. 239 }, 240 "promotions": [ # The details of the merchant provided promotions applied to the order. More details about the program are here. 241 { 242 "benefits": [ 243 { 244 "offerIds": [ # The OfferId(s) that were purchased in this order and map to this specific benefit of the promotion. 245 "A String", 246 ], 247 "discount": { # The discount in the order price when the promotion is applied. 248 "currency": "A String", # The currency of the price. 249 "value": "A String", # The price represented as a number. 250 }, 251 "type": "A String", # Describes whether the promotion applies to products (e.g. 20% off) or to shipping (e.g. Free Shipping). 252 "taxImpact": { # The impact on tax when the promotion is applied. 253 "currency": "A String", # The currency of the price. 254 "value": "A String", # The price represented as a number. 255 }, 256 "subType": "A String", # Further describes the benefit of the promotion. Note that we will expand on this enumeration as we support new promotion sub-types. 257 }, 258 ], 259 "longTitle": "A String", # The full title of the promotion. 260 "genericRedemptionCode": "A String", # Optional. The text code that corresponds to the promotion when applied on the retailer?s website. 261 "redemptionChannel": "A String", # Indicates that the promotion is valid online. 262 "productApplicability": "A String", # Whether the promotion is applicable to all products or only specific products. 263 "effectiveDates": "A String", # The date and time frame when the promotion is active and ready for validation review. Note that the promotion live time may be delayed for a few hours due to the validation review. 264 # Start date and end date are separated by a forward slash (/). The start date is specified by the format (YYYY-MM-DD), followed by the letter ?T?, the time of the day when the sale starts (in Greenwich Mean Time, GMT), followed by an expression of the time zone for the sale. The end date is in the same format. 265 "id": "A String", # The unique ID of the promotion. 266 }, 267 ], 268 "kind": "content#testOrder", # Identifies what kind of resource this is. Value: the fixed string "content#testOrder". 269 "shippingCostTax": { # The tax for the total shipping cost. 270 "currency": "A String", # The currency of the price. 271 "value": "A String", # The price represented as a number. 272 }, 273 "predefinedDeliveryAddress": "A String", # Identifier of one of the predefined delivery addresses for the delivery. 274 "shippingCost": { # The total cost of shipping for all items. 275 "currency": "A String", # The currency of the price. 276 "value": "A String", # The price represented as a number. 277 }, 278 "shippingOption": "A String", # The requested shipping option. 279 "lineItems": [ # Line items that are ordered. At least one line item must be provided. 280 { 281 "returnInfo": { # Details of the return policy for the line item. 282 "policyUrl": "A String", # URL of the item return policy. 283 "isReturnable": True or False, # Whether the item is returnable. 284 "daysToReturn": 42, # How many days later the item can be returned. 285 }, 286 "product": { # Product data from the time of the order placement. 287 "targetCountry": "A String", # The CLDR territory code of the target country of the product. 288 "contentLanguage": "A String", # The two-letter ISO 639-1 language code for the item. 289 "title": "A String", # The title of the product. 290 "mpn": "A String", # Manufacturer Part Number (MPN) of the item. Optional. 291 "variantAttributes": [ # Variant attributes for the item. Optional. 292 { 293 "dimension": "A String", # The dimension of the variant. 294 "value": "A String", # The value for the dimension. 295 }, 296 ], 297 "brand": "A String", # Brand of the item. 298 "itemGroupId": "A String", # Shared identifier for all variants of the same product. Optional. 299 "offerId": "A String", # An identifier of the item. 300 "imageLink": "A String", # URL of an image of the item. 301 "gtin": "A String", # Global Trade Item Number (GTIN) of the item. Optional. 302 "channel": "A String", # The item's channel. 303 "price": { # The price for the product. 304 "currency": "A String", # The currency of the price. 305 "value": "A String", # The price represented as a number. 306 }, 307 "condition": "A String", # Condition or state of the item. 308 }, 309 "unitTax": { # Unit tax for the line item. 310 "currency": "A String", # The currency of the price. 311 "value": "A String", # The price represented as a number. 312 }, 313 "quantityOrdered": 42, # Number of items ordered. 314 "shippingDetails": { # Details of the requested shipping for the line item. 315 "deliverByDate": "A String", # The delivery by date, in ISO 8601 format. 316 "method": { # Details of the shipping method. 317 "minDaysInTransit": 42, # Minimum transit time. 318 "carrier": "A String", # The carrier for the shipping. Optional. 319 "methodName": "A String", # The name of the shipping method. 320 "maxDaysInTransit": 42, # Maximum transit time. 321 }, 322 "shipByDate": "A String", # The ship by date, in ISO 8601 format. 323 }, 324 }, 325 ], 326 "paymentMethod": { # The details of the payment method. 327 "expirationMonth": 42, # The card expiration month (January = 1, February = 2 etc.). 328 "type": "A String", # The type of instrument. Note that real orders might have different values than the four values accepted by createTestOrder. 329 "expirationYear": 42, # The card expiration year (4-digit, e.g. 2015). 330 "lastFourDigits": "A String", # The last four digits of the card number. 331 "predefinedBillingAddress": "A String", # The billing address. 332 }, 333 }, 334 "templateName": "A String", # The test order template to use. Specify as an alternative to testOrder as a shortcut for retrieving a template and then creating an order using that template. 335 } 336 337 338Returns: 339 An object of the form: 340 341 { 342 "orderId": "A String", # The ID of the newly created test order. 343 "kind": "content#ordersCreateTestOrderResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersCreateTestOrderResponse". 344 }</pre> 345</div> 346 347<div class="method"> 348 <code class="details" id="custombatch">custombatch(body)</code> 349 <pre>Retrieves or modifies multiple orders in a single request. This method can only be called for non-multi-client accounts. 350 351Args: 352 body: object, The request body. (required) 353 The object takes the form of: 354 355{ 356 "entries": [ # The request entries to be processed in the batch. 357 { 358 "orderId": "A String", # The ID of the order. Required for all methods beside getByMerchantOrderId. 359 "merchantOrderId": "A String", # The merchant order id. Required for updateMerchantOrderId and getByMerchantOrderId methods. 360 "shipLineItems": { # Required for shipLineItems method. 361 "lineItems": [ # Line items to ship. 362 { 363 "lineItemId": "A String", # The id of the line item that is shipped. 364 "quantity": 42, # The quantity that is shipped. 365 }, 366 ], 367 "carrier": "A String", # The carrier handling the shipment. 368 "trackingId": "A String", # The tracking id for the shipment. 369 "shipmentId": "A String", # The ID of the shipment. 370 }, 371 "updateShipment": { # Required for updateShipment method. 372 "status": "A String", # New status for the shipment. Not updated if missing. 373 "carrier": "A String", # The carrier handling the shipment. Not updated if missing. 374 "trackingId": "A String", # The tracking id for the shipment. Not updated if missing. 375 "shipmentId": "A String", # The ID of the shipment. 376 }, 377 "method": "A String", # The method to apply. 378 "batchId": 42, # An entry ID, unique within the batch request. 379 "cancelLineItem": { # Required for cancelLineItem method. 380 "amount": { # Amount to refund for the cancelation. Optional. If not set, Google will calculate the default based on the price and tax of the items involved. The amount must not be larger than the net amount left on the order. 381 "currency": "A String", # The currency of the price. 382 "value": "A String", # The price represented as a number. 383 }, 384 "reasonText": "A String", # The explanation of the reason. 385 "reason": "A String", # The reason for the cancellation. 386 "lineItemId": "A String", # The ID of the line item to cancel. 387 "quantity": 42, # The quantity to cancel. 388 }, 389 "refund": { # Required for refund method. 390 "amount": { # The amount that is refunded. 391 "currency": "A String", # The currency of the price. 392 "value": "A String", # The price represented as a number. 393 }, 394 "reasonText": "A String", # The explanation of the reason. 395 "reason": "A String", # The reason for the refund. 396 }, 397 "cancel": { # Required for cancel method. 398 "reason": "A String", # The reason for the cancellation. 399 "reasonText": "A String", # The explanation of the reason. 400 }, 401 "returnLineItem": { # Required for returnLineItem method. 402 "reason": "A String", # The reason for the return. 403 "reasonText": "A String", # The explanation of the reason. 404 "lineItemId": "A String", # The ID of the line item to return. 405 "quantity": 42, # The quantity to return. 406 }, 407 "merchantId": "A String", # The ID of the managing account. 408 "operationId": "A String", # The ID of the operation. Unique across all operations for a given order. Required for all methods beside get and getByMerchantOrderId. 409 }, 410 ], 411 } 412 413 414Returns: 415 An object of the form: 416 417 { 418 "kind": "content#ordersCustomBatchResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersCustomBatchResponse". 419 "entries": [ # The result of the execution of the batch requests. 420 { 421 "batchId": 42, # The ID of the request entry this entry responds to. 422 "kind": "content#ordersCustomBatchResponseEntry", # Identifies what kind of resource this is. Value: the fixed string "content#ordersCustomBatchResponseEntry". 423 "errors": { # A list of errors returned by a failed batch entry. # A list of errors defined if and only if the request failed. 424 "message": "A String", # The message of the first error in errors. 425 "code": 42, # The HTTP status of the first error in errors. 426 "errors": [ # A list of errors. 427 { # An error returned by the API. 428 "reason": "A String", # The error code. 429 "domain": "A String", # The domain of the error. 430 "message": "A String", # A description of the error. 431 }, 432 ], 433 }, 434 "order": { # The retrieved order. Only defined if the method is get and if the request was successful. 435 "customer": { # The details of the customer who placed the order. 436 "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow. 437 "fullName": "A String", # Full name of the customer. 438 "email": "A String", # Email address of the customer. 439 }, 440 "promotions": [ # The details of the merchant provided promotions applied to the order. More details about the program are here. 441 { 442 "benefits": [ 443 { 444 "offerIds": [ # The OfferId(s) that were purchased in this order and map to this specific benefit of the promotion. 445 "A String", 446 ], 447 "discount": { # The discount in the order price when the promotion is applied. 448 "currency": "A String", # The currency of the price. 449 "value": "A String", # The price represented as a number. 450 }, 451 "type": "A String", # Describes whether the promotion applies to products (e.g. 20% off) or to shipping (e.g. Free Shipping). 452 "taxImpact": { # The impact on tax when the promotion is applied. 453 "currency": "A String", # The currency of the price. 454 "value": "A String", # The price represented as a number. 455 }, 456 "subType": "A String", # Further describes the benefit of the promotion. Note that we will expand on this enumeration as we support new promotion sub-types. 457 }, 458 ], 459 "longTitle": "A String", # The full title of the promotion. 460 "genericRedemptionCode": "A String", # Optional. The text code that corresponds to the promotion when applied on the retailer?s website. 461 "redemptionChannel": "A String", # Indicates that the promotion is valid online. 462 "productApplicability": "A String", # Whether the promotion is applicable to all products or only specific products. 463 "effectiveDates": "A String", # The date and time frame when the promotion is active and ready for validation review. Note that the promotion live time may be delayed for a few hours due to the validation review. 464 # Start date and end date are separated by a forward slash (/). The start date is specified by the format (YYYY-MM-DD), followed by the letter ?T?, the time of the day when the sale starts (in Greenwich Mean Time, GMT), followed by an expression of the time zone for the sale. The end date is in the same format. 465 "id": "A String", # The unique ID of the promotion. 466 }, 467 ], 468 "kind": "content#order", # Identifies what kind of resource this is. Value: the fixed string "content#order". 469 "shippingCostTax": { # The tax for the total shipping cost. 470 "currency": "A String", # The currency of the price. 471 "value": "A String", # The price represented as a number. 472 }, 473 "shipments": [ # Shipments of the order. 474 { 475 "status": "A String", # The status of the shipment. 476 "creationDate": "A String", # Date on which the shipment has been created, in ISO 8601 format. 477 "carrier": "A String", # The carrier handling the shipment. 478 "trackingId": "A String", # The tracking id for the shipment. 479 "deliveryDate": "A String", # Date on which the shipment has been delivered, in ISO 8601 format. Present only if status is delievered 480 "lineItems": [ # The line items that are shipped. 481 { 482 "lineItemId": "A String", # The id of the line item that is shipped. 483 "quantity": 42, # The quantity that is shipped. 484 }, 485 ], 486 "id": "A String", # The id of the shipment. 487 }, 488 ], 489 "refunds": [ # Refunds for the order. 490 { 491 "amount": { # The amount that is refunded. 492 "currency": "A String", # The currency of the price. 493 "value": "A String", # The price represented as a number. 494 }, 495 "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format. 496 "reason": "A String", # The reason for the refund. 497 "actor": "A String", # The actor that created the refund. 498 "reasonText": "A String", # The explanation of the reason. 499 }, 500 ], 501 "paymentMethod": { # The details of the payment method. 502 "expirationMonth": 42, # The card expiration month (January = 1, February = 2 etc.). 503 "lastFourDigits": "A String", # The last four digits of the card number. 504 "expirationYear": 42, # The card expiration year (4-digit, e.g. 2015). 505 "phoneNumber": "A String", # The billing phone number. 506 "billingAddress": { # The billing address. 507 "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). 508 "country": "A String", # CLDR country code (e.g. "US"). 509 "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: 510 # John Smith 511 # 1600 Amphitheatre Parkway 512 # Mountain View, CA, 94043 513 # United States 514 "A String", 515 ], 516 "streetAddress": [ # Street-level part of the address. 517 "A String", 518 ], 519 "postalCode": "A String", # Postal Code or ZIP (e.g. "94043"). 520 "recipientName": "A String", # Name of the recipient. 521 "isPostOfficeBox": True or False, # Whether the address is a post office box. 522 "region": "A String", # Top-level administrative subdivision of the country (e.g. "CA"). 523 }, 524 "type": "A String", # The type of instrument (VISA, Mastercard, etc). 525 }, 526 "shippingCost": { # The total cost of shipping for all items. 527 "currency": "A String", # The currency of the price. 528 "value": "A String", # The price represented as a number. 529 }, 530 "acknowledged": True or False, # Whether the order was acknowledged. 531 "paymentStatus": "A String", # The status of the payment. 532 "merchantId": "A String", 533 "merchantOrderId": "A String", # Merchant-provided id of the order. 534 "shippingOption": "A String", # The requested shipping option. 535 "status": "A String", # The status of the order. 536 "deliveryDetails": { # The details for the delivery. 537 "phoneNumber": "A String", # The phone number of the person receiving the delivery. 538 "address": { # The delivery address 539 "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). 540 "country": "A String", # CLDR country code (e.g. "US"). 541 "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: 542 # John Smith 543 # 1600 Amphitheatre Parkway 544 # Mountain View, CA, 94043 545 # United States 546 "A String", 547 ], 548 "streetAddress": [ # Street-level part of the address. 549 "A String", 550 ], 551 "postalCode": "A String", # Postal Code or ZIP (e.g. "94043"). 552 "recipientName": "A String", # Name of the recipient. 553 "isPostOfficeBox": True or False, # Whether the address is a post office box. 554 "region": "A String", # Top-level administrative subdivision of the country (e.g. "CA"). 555 }, 556 }, 557 "placedDate": "A String", # The date when the order was placed, in ISO 8601 format. 558 "channelType": "A String", # The channel type of the order: "purchaseOnGoogle" or "googleExpress". 559 "lineItems": [ # Line items that are ordered. 560 { 561 "product": { # Product data from the time of the order placement. 562 "targetCountry": "A String", # The CLDR territory code of the target country of the product. 563 "shownImage": "A String", # URL to the cached image shown to the user when order was placed. 564 "contentLanguage": "A String", # The two-letter ISO 639-1 language code for the item. 565 "title": "A String", # The title of the product. 566 "mpn": "A String", # Manufacturer Part Number (MPN) of the item. 567 "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. 568 { 569 "dimension": "A String", # The dimension of the variant. 570 "value": "A String", # The value for the dimension. 571 }, 572 ], 573 "brand": "A String", # Brand of the item. 574 "itemGroupId": "A String", # Shared identifier for all variants of the same product. 575 "offerId": "A String", # An identifier of the item. 576 "price": { # Price of the item. 577 "currency": "A String", # The currency of the price. 578 "value": "A String", # The price represented as a number. 579 }, 580 "imageLink": "A String", # URL of an image of the item. 581 "gtin": "A String", # Global Trade Item Number (GTIN) of the item. 582 "channel": "A String", # The item's channel (online or local). 583 "id": "A String", # The REST id of the product. 584 "condition": "A String", # Condition or state of the item. 585 }, 586 "quantityDelivered": 42, # Number of items delivered. 587 "returnInfo": { # Details of the return policy for the line item. 588 "policyUrl": "A String", # URL of the item return policy. 589 "isReturnable": True or False, # Whether the item is returnable. 590 "daysToReturn": 42, # How many days later the item can be returned. 591 }, 592 "price": { # Total price for the line item. For example, if two items for $10 are purchased, the total price will be $20. 593 "currency": "A String", # The currency of the price. 594 "value": "A String", # The price represented as a number. 595 }, 596 "quantityPending": 42, # Number of items pending. 597 "tax": { # Total tax amount for the line item. For example, if two items are purchased, and each have a cost tax of $2, the total tax amount will be $4. 598 "currency": "A String", # The currency of the price. 599 "value": "A String", # The price represented as a number. 600 }, 601 "cancellations": [ # Cancellations of the line item. 602 { 603 "reason": "A String", # The reason for the cancellation. Orders that are cancelled with a noInventory reason will lead to the removal of the product from POG until you make an update to that product. This will not affect your Shopping ads. 604 "creationDate": "A String", # Date on which the cancellation has been created, in ISO 8601 format. 605 "reasonText": "A String", # The explanation of the reason. 606 "actor": "A String", # The actor that created the cancellation. 607 "quantity": 42, # The quantity that was canceled. 608 }, 609 ], 610 "quantityCanceled": 42, # Number of items canceled. 611 "quantityOrdered": 42, # Number of items ordered. 612 "returns": [ # Returns of the line item. 613 { 614 "reason": "A String", # The reason for the return. 615 "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format. 616 "reasonText": "A String", # The explanation of the reason. 617 "actor": "A String", # The actor that created the refund. 618 "quantity": 42, # Quantity that is returned. 619 }, 620 ], 621 "quantityShipped": 42, # Number of items shipped. 622 "quantityReturned": 42, # Number of items returned. 623 "id": "A String", # The id of the line item. 624 "shippingDetails": { # Details of the requested shipping for the line item. 625 "deliverByDate": "A String", # The delivery by date, in ISO 8601 format. 626 "method": { # Details of the shipping method. 627 "minDaysInTransit": 42, # Minimum transit time. 628 "carrier": "A String", # The carrier for the shipping. Optional. 629 "methodName": "A String", # The name of the shipping method. 630 "maxDaysInTransit": 42, # Maximum transit time. 631 }, 632 "shipByDate": "A String", # The ship by date, in ISO 8601 format. 633 }, 634 }, 635 ], 636 "netAmount": { # The net amount for the order. For example, if an order was originally for a grand total of $100 and a refund was issued for $20, the net amount will be $80. 637 "currency": "A String", # The currency of the price. 638 "value": "A String", # The price represented as a number. 639 }, 640 "id": "A String", # The REST id of the order. Globally unique. 641 }, 642 "executionStatus": "A String", # The status of the execution. Only defined if the method is not get or getByMerchantOrderId and if the request was successful. 643 }, 644 ], 645 }</pre> 646</div> 647 648<div class="method"> 649 <code class="details" id="get">get(merchantId, orderId)</code> 650 <pre>Retrieves an order from your Merchant Center account. This method can only be called for non-multi-client accounts. 651 652Args: 653 merchantId: string, The ID of the managing account. (required) 654 orderId: string, The ID of the order. (required) 655 656Returns: 657 An object of the form: 658 659 { 660 "customer": { # The details of the customer who placed the order. 661 "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow. 662 "fullName": "A String", # Full name of the customer. 663 "email": "A String", # Email address of the customer. 664 }, 665 "promotions": [ # The details of the merchant provided promotions applied to the order. More details about the program are here. 666 { 667 "benefits": [ 668 { 669 "offerIds": [ # The OfferId(s) that were purchased in this order and map to this specific benefit of the promotion. 670 "A String", 671 ], 672 "discount": { # The discount in the order price when the promotion is applied. 673 "currency": "A String", # The currency of the price. 674 "value": "A String", # The price represented as a number. 675 }, 676 "type": "A String", # Describes whether the promotion applies to products (e.g. 20% off) or to shipping (e.g. Free Shipping). 677 "taxImpact": { # The impact on tax when the promotion is applied. 678 "currency": "A String", # The currency of the price. 679 "value": "A String", # The price represented as a number. 680 }, 681 "subType": "A String", # Further describes the benefit of the promotion. Note that we will expand on this enumeration as we support new promotion sub-types. 682 }, 683 ], 684 "longTitle": "A String", # The full title of the promotion. 685 "genericRedemptionCode": "A String", # Optional. The text code that corresponds to the promotion when applied on the retailer?s website. 686 "redemptionChannel": "A String", # Indicates that the promotion is valid online. 687 "productApplicability": "A String", # Whether the promotion is applicable to all products or only specific products. 688 "effectiveDates": "A String", # The date and time frame when the promotion is active and ready for validation review. Note that the promotion live time may be delayed for a few hours due to the validation review. 689 # Start date and end date are separated by a forward slash (/). The start date is specified by the format (YYYY-MM-DD), followed by the letter ?T?, the time of the day when the sale starts (in Greenwich Mean Time, GMT), followed by an expression of the time zone for the sale. The end date is in the same format. 690 "id": "A String", # The unique ID of the promotion. 691 }, 692 ], 693 "kind": "content#order", # Identifies what kind of resource this is. Value: the fixed string "content#order". 694 "shippingCostTax": { # The tax for the total shipping cost. 695 "currency": "A String", # The currency of the price. 696 "value": "A String", # The price represented as a number. 697 }, 698 "shipments": [ # Shipments of the order. 699 { 700 "status": "A String", # The status of the shipment. 701 "creationDate": "A String", # Date on which the shipment has been created, in ISO 8601 format. 702 "carrier": "A String", # The carrier handling the shipment. 703 "trackingId": "A String", # The tracking id for the shipment. 704 "deliveryDate": "A String", # Date on which the shipment has been delivered, in ISO 8601 format. Present only if status is delievered 705 "lineItems": [ # The line items that are shipped. 706 { 707 "lineItemId": "A String", # The id of the line item that is shipped. 708 "quantity": 42, # The quantity that is shipped. 709 }, 710 ], 711 "id": "A String", # The id of the shipment. 712 }, 713 ], 714 "refunds": [ # Refunds for the order. 715 { 716 "amount": { # The amount that is refunded. 717 "currency": "A String", # The currency of the price. 718 "value": "A String", # The price represented as a number. 719 }, 720 "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format. 721 "reason": "A String", # The reason for the refund. 722 "actor": "A String", # The actor that created the refund. 723 "reasonText": "A String", # The explanation of the reason. 724 }, 725 ], 726 "paymentMethod": { # The details of the payment method. 727 "expirationMonth": 42, # The card expiration month (January = 1, February = 2 etc.). 728 "lastFourDigits": "A String", # The last four digits of the card number. 729 "expirationYear": 42, # The card expiration year (4-digit, e.g. 2015). 730 "phoneNumber": "A String", # The billing phone number. 731 "billingAddress": { # The billing address. 732 "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). 733 "country": "A String", # CLDR country code (e.g. "US"). 734 "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: 735 # John Smith 736 # 1600 Amphitheatre Parkway 737 # Mountain View, CA, 94043 738 # United States 739 "A String", 740 ], 741 "streetAddress": [ # Street-level part of the address. 742 "A String", 743 ], 744 "postalCode": "A String", # Postal Code or ZIP (e.g. "94043"). 745 "recipientName": "A String", # Name of the recipient. 746 "isPostOfficeBox": True or False, # Whether the address is a post office box. 747 "region": "A String", # Top-level administrative subdivision of the country (e.g. "CA"). 748 }, 749 "type": "A String", # The type of instrument (VISA, Mastercard, etc). 750 }, 751 "shippingCost": { # The total cost of shipping for all items. 752 "currency": "A String", # The currency of the price. 753 "value": "A String", # The price represented as a number. 754 }, 755 "acknowledged": True or False, # Whether the order was acknowledged. 756 "paymentStatus": "A String", # The status of the payment. 757 "merchantId": "A String", 758 "merchantOrderId": "A String", # Merchant-provided id of the order. 759 "shippingOption": "A String", # The requested shipping option. 760 "status": "A String", # The status of the order. 761 "deliveryDetails": { # The details for the delivery. 762 "phoneNumber": "A String", # The phone number of the person receiving the delivery. 763 "address": { # The delivery address 764 "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). 765 "country": "A String", # CLDR country code (e.g. "US"). 766 "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: 767 # John Smith 768 # 1600 Amphitheatre Parkway 769 # Mountain View, CA, 94043 770 # United States 771 "A String", 772 ], 773 "streetAddress": [ # Street-level part of the address. 774 "A String", 775 ], 776 "postalCode": "A String", # Postal Code or ZIP (e.g. "94043"). 777 "recipientName": "A String", # Name of the recipient. 778 "isPostOfficeBox": True or False, # Whether the address is a post office box. 779 "region": "A String", # Top-level administrative subdivision of the country (e.g. "CA"). 780 }, 781 }, 782 "placedDate": "A String", # The date when the order was placed, in ISO 8601 format. 783 "channelType": "A String", # The channel type of the order: "purchaseOnGoogle" or "googleExpress". 784 "lineItems": [ # Line items that are ordered. 785 { 786 "product": { # Product data from the time of the order placement. 787 "targetCountry": "A String", # The CLDR territory code of the target country of the product. 788 "shownImage": "A String", # URL to the cached image shown to the user when order was placed. 789 "contentLanguage": "A String", # The two-letter ISO 639-1 language code for the item. 790 "title": "A String", # The title of the product. 791 "mpn": "A String", # Manufacturer Part Number (MPN) of the item. 792 "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. 793 { 794 "dimension": "A String", # The dimension of the variant. 795 "value": "A String", # The value for the dimension. 796 }, 797 ], 798 "brand": "A String", # Brand of the item. 799 "itemGroupId": "A String", # Shared identifier for all variants of the same product. 800 "offerId": "A String", # An identifier of the item. 801 "price": { # Price of the item. 802 "currency": "A String", # The currency of the price. 803 "value": "A String", # The price represented as a number. 804 }, 805 "imageLink": "A String", # URL of an image of the item. 806 "gtin": "A String", # Global Trade Item Number (GTIN) of the item. 807 "channel": "A String", # The item's channel (online or local). 808 "id": "A String", # The REST id of the product. 809 "condition": "A String", # Condition or state of the item. 810 }, 811 "quantityDelivered": 42, # Number of items delivered. 812 "returnInfo": { # Details of the return policy for the line item. 813 "policyUrl": "A String", # URL of the item return policy. 814 "isReturnable": True or False, # Whether the item is returnable. 815 "daysToReturn": 42, # How many days later the item can be returned. 816 }, 817 "price": { # Total price for the line item. For example, if two items for $10 are purchased, the total price will be $20. 818 "currency": "A String", # The currency of the price. 819 "value": "A String", # The price represented as a number. 820 }, 821 "quantityPending": 42, # Number of items pending. 822 "tax": { # Total tax amount for the line item. For example, if two items are purchased, and each have a cost tax of $2, the total tax amount will be $4. 823 "currency": "A String", # The currency of the price. 824 "value": "A String", # The price represented as a number. 825 }, 826 "cancellations": [ # Cancellations of the line item. 827 { 828 "reason": "A String", # The reason for the cancellation. Orders that are cancelled with a noInventory reason will lead to the removal of the product from POG until you make an update to that product. This will not affect your Shopping ads. 829 "creationDate": "A String", # Date on which the cancellation has been created, in ISO 8601 format. 830 "reasonText": "A String", # The explanation of the reason. 831 "actor": "A String", # The actor that created the cancellation. 832 "quantity": 42, # The quantity that was canceled. 833 }, 834 ], 835 "quantityCanceled": 42, # Number of items canceled. 836 "quantityOrdered": 42, # Number of items ordered. 837 "returns": [ # Returns of the line item. 838 { 839 "reason": "A String", # The reason for the return. 840 "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format. 841 "reasonText": "A String", # The explanation of the reason. 842 "actor": "A String", # The actor that created the refund. 843 "quantity": 42, # Quantity that is returned. 844 }, 845 ], 846 "quantityShipped": 42, # Number of items shipped. 847 "quantityReturned": 42, # Number of items returned. 848 "id": "A String", # The id of the line item. 849 "shippingDetails": { # Details of the requested shipping for the line item. 850 "deliverByDate": "A String", # The delivery by date, in ISO 8601 format. 851 "method": { # Details of the shipping method. 852 "minDaysInTransit": 42, # Minimum transit time. 853 "carrier": "A String", # The carrier for the shipping. Optional. 854 "methodName": "A String", # The name of the shipping method. 855 "maxDaysInTransit": 42, # Maximum transit time. 856 }, 857 "shipByDate": "A String", # The ship by date, in ISO 8601 format. 858 }, 859 }, 860 ], 861 "netAmount": { # The net amount for the order. For example, if an order was originally for a grand total of $100 and a refund was issued for $20, the net amount will be $80. 862 "currency": "A String", # The currency of the price. 863 "value": "A String", # The price represented as a number. 864 }, 865 "id": "A String", # The REST id of the order. Globally unique. 866 }</pre> 867</div> 868 869<div class="method"> 870 <code class="details" id="getbymerchantorderid">getbymerchantorderid(merchantId, merchantOrderId)</code> 871 <pre>Retrieves an order using merchant order id. This method can only be called for non-multi-client accounts. 872 873Args: 874 merchantId: string, The ID of the managing account. (required) 875 merchantOrderId: string, The merchant order id to be looked for. (required) 876 877Returns: 878 An object of the form: 879 880 { 881 "kind": "content#ordersGetByMerchantOrderIdResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersGetByMerchantOrderIdResponse". 882 "order": { # The requested order. 883 "customer": { # The details of the customer who placed the order. 884 "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow. 885 "fullName": "A String", # Full name of the customer. 886 "email": "A String", # Email address of the customer. 887 }, 888 "promotions": [ # The details of the merchant provided promotions applied to the order. More details about the program are here. 889 { 890 "benefits": [ 891 { 892 "offerIds": [ # The OfferId(s) that were purchased in this order and map to this specific benefit of the promotion. 893 "A String", 894 ], 895 "discount": { # The discount in the order price when the promotion is applied. 896 "currency": "A String", # The currency of the price. 897 "value": "A String", # The price represented as a number. 898 }, 899 "type": "A String", # Describes whether the promotion applies to products (e.g. 20% off) or to shipping (e.g. Free Shipping). 900 "taxImpact": { # The impact on tax when the promotion is applied. 901 "currency": "A String", # The currency of the price. 902 "value": "A String", # The price represented as a number. 903 }, 904 "subType": "A String", # Further describes the benefit of the promotion. Note that we will expand on this enumeration as we support new promotion sub-types. 905 }, 906 ], 907 "longTitle": "A String", # The full title of the promotion. 908 "genericRedemptionCode": "A String", # Optional. The text code that corresponds to the promotion when applied on the retailer?s website. 909 "redemptionChannel": "A String", # Indicates that the promotion is valid online. 910 "productApplicability": "A String", # Whether the promotion is applicable to all products or only specific products. 911 "effectiveDates": "A String", # The date and time frame when the promotion is active and ready for validation review. Note that the promotion live time may be delayed for a few hours due to the validation review. 912 # Start date and end date are separated by a forward slash (/). The start date is specified by the format (YYYY-MM-DD), followed by the letter ?T?, the time of the day when the sale starts (in Greenwich Mean Time, GMT), followed by an expression of the time zone for the sale. The end date is in the same format. 913 "id": "A String", # The unique ID of the promotion. 914 }, 915 ], 916 "kind": "content#order", # Identifies what kind of resource this is. Value: the fixed string "content#order". 917 "shippingCostTax": { # The tax for the total shipping cost. 918 "currency": "A String", # The currency of the price. 919 "value": "A String", # The price represented as a number. 920 }, 921 "shipments": [ # Shipments of the order. 922 { 923 "status": "A String", # The status of the shipment. 924 "creationDate": "A String", # Date on which the shipment has been created, in ISO 8601 format. 925 "carrier": "A String", # The carrier handling the shipment. 926 "trackingId": "A String", # The tracking id for the shipment. 927 "deliveryDate": "A String", # Date on which the shipment has been delivered, in ISO 8601 format. Present only if status is delievered 928 "lineItems": [ # The line items that are shipped. 929 { 930 "lineItemId": "A String", # The id of the line item that is shipped. 931 "quantity": 42, # The quantity that is shipped. 932 }, 933 ], 934 "id": "A String", # The id of the shipment. 935 }, 936 ], 937 "refunds": [ # Refunds for the order. 938 { 939 "amount": { # The amount that is refunded. 940 "currency": "A String", # The currency of the price. 941 "value": "A String", # The price represented as a number. 942 }, 943 "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format. 944 "reason": "A String", # The reason for the refund. 945 "actor": "A String", # The actor that created the refund. 946 "reasonText": "A String", # The explanation of the reason. 947 }, 948 ], 949 "paymentMethod": { # The details of the payment method. 950 "expirationMonth": 42, # The card expiration month (January = 1, February = 2 etc.). 951 "lastFourDigits": "A String", # The last four digits of the card number. 952 "expirationYear": 42, # The card expiration year (4-digit, e.g. 2015). 953 "phoneNumber": "A String", # The billing phone number. 954 "billingAddress": { # The billing address. 955 "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). 956 "country": "A String", # CLDR country code (e.g. "US"). 957 "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: 958 # John Smith 959 # 1600 Amphitheatre Parkway 960 # Mountain View, CA, 94043 961 # United States 962 "A String", 963 ], 964 "streetAddress": [ # Street-level part of the address. 965 "A String", 966 ], 967 "postalCode": "A String", # Postal Code or ZIP (e.g. "94043"). 968 "recipientName": "A String", # Name of the recipient. 969 "isPostOfficeBox": True or False, # Whether the address is a post office box. 970 "region": "A String", # Top-level administrative subdivision of the country (e.g. "CA"). 971 }, 972 "type": "A String", # The type of instrument (VISA, Mastercard, etc). 973 }, 974 "shippingCost": { # The total cost of shipping for all items. 975 "currency": "A String", # The currency of the price. 976 "value": "A String", # The price represented as a number. 977 }, 978 "acknowledged": True or False, # Whether the order was acknowledged. 979 "paymentStatus": "A String", # The status of the payment. 980 "merchantId": "A String", 981 "merchantOrderId": "A String", # Merchant-provided id of the order. 982 "shippingOption": "A String", # The requested shipping option. 983 "status": "A String", # The status of the order. 984 "deliveryDetails": { # The details for the delivery. 985 "phoneNumber": "A String", # The phone number of the person receiving the delivery. 986 "address": { # The delivery address 987 "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). 988 "country": "A String", # CLDR country code (e.g. "US"). 989 "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: 990 # John Smith 991 # 1600 Amphitheatre Parkway 992 # Mountain View, CA, 94043 993 # United States 994 "A String", 995 ], 996 "streetAddress": [ # Street-level part of the address. 997 "A String", 998 ], 999 "postalCode": "A String", # Postal Code or ZIP (e.g. "94043"). 1000 "recipientName": "A String", # Name of the recipient. 1001 "isPostOfficeBox": True or False, # Whether the address is a post office box. 1002 "region": "A String", # Top-level administrative subdivision of the country (e.g. "CA"). 1003 }, 1004 }, 1005 "placedDate": "A String", # The date when the order was placed, in ISO 8601 format. 1006 "channelType": "A String", # The channel type of the order: "purchaseOnGoogle" or "googleExpress". 1007 "lineItems": [ # Line items that are ordered. 1008 { 1009 "product": { # Product data from the time of the order placement. 1010 "targetCountry": "A String", # The CLDR territory code of the target country of the product. 1011 "shownImage": "A String", # URL to the cached image shown to the user when order was placed. 1012 "contentLanguage": "A String", # The two-letter ISO 639-1 language code for the item. 1013 "title": "A String", # The title of the product. 1014 "mpn": "A String", # Manufacturer Part Number (MPN) of the item. 1015 "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. 1016 { 1017 "dimension": "A String", # The dimension of the variant. 1018 "value": "A String", # The value for the dimension. 1019 }, 1020 ], 1021 "brand": "A String", # Brand of the item. 1022 "itemGroupId": "A String", # Shared identifier for all variants of the same product. 1023 "offerId": "A String", # An identifier of the item. 1024 "price": { # Price of the item. 1025 "currency": "A String", # The currency of the price. 1026 "value": "A String", # The price represented as a number. 1027 }, 1028 "imageLink": "A String", # URL of an image of the item. 1029 "gtin": "A String", # Global Trade Item Number (GTIN) of the item. 1030 "channel": "A String", # The item's channel (online or local). 1031 "id": "A String", # The REST id of the product. 1032 "condition": "A String", # Condition or state of the item. 1033 }, 1034 "quantityDelivered": 42, # Number of items delivered. 1035 "returnInfo": { # Details of the return policy for the line item. 1036 "policyUrl": "A String", # URL of the item return policy. 1037 "isReturnable": True or False, # Whether the item is returnable. 1038 "daysToReturn": 42, # How many days later the item can be returned. 1039 }, 1040 "price": { # Total price for the line item. For example, if two items for $10 are purchased, the total price will be $20. 1041 "currency": "A String", # The currency of the price. 1042 "value": "A String", # The price represented as a number. 1043 }, 1044 "quantityPending": 42, # Number of items pending. 1045 "tax": { # Total tax amount for the line item. For example, if two items are purchased, and each have a cost tax of $2, the total tax amount will be $4. 1046 "currency": "A String", # The currency of the price. 1047 "value": "A String", # The price represented as a number. 1048 }, 1049 "cancellations": [ # Cancellations of the line item. 1050 { 1051 "reason": "A String", # The reason for the cancellation. Orders that are cancelled with a noInventory reason will lead to the removal of the product from POG until you make an update to that product. This will not affect your Shopping ads. 1052 "creationDate": "A String", # Date on which the cancellation has been created, in ISO 8601 format. 1053 "reasonText": "A String", # The explanation of the reason. 1054 "actor": "A String", # The actor that created the cancellation. 1055 "quantity": 42, # The quantity that was canceled. 1056 }, 1057 ], 1058 "quantityCanceled": 42, # Number of items canceled. 1059 "quantityOrdered": 42, # Number of items ordered. 1060 "returns": [ # Returns of the line item. 1061 { 1062 "reason": "A String", # The reason for the return. 1063 "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format. 1064 "reasonText": "A String", # The explanation of the reason. 1065 "actor": "A String", # The actor that created the refund. 1066 "quantity": 42, # Quantity that is returned. 1067 }, 1068 ], 1069 "quantityShipped": 42, # Number of items shipped. 1070 "quantityReturned": 42, # Number of items returned. 1071 "id": "A String", # The id of the line item. 1072 "shippingDetails": { # Details of the requested shipping for the line item. 1073 "deliverByDate": "A String", # The delivery by date, in ISO 8601 format. 1074 "method": { # Details of the shipping method. 1075 "minDaysInTransit": 42, # Minimum transit time. 1076 "carrier": "A String", # The carrier for the shipping. Optional. 1077 "methodName": "A String", # The name of the shipping method. 1078 "maxDaysInTransit": 42, # Maximum transit time. 1079 }, 1080 "shipByDate": "A String", # The ship by date, in ISO 8601 format. 1081 }, 1082 }, 1083 ], 1084 "netAmount": { # The net amount for the order. For example, if an order was originally for a grand total of $100 and a refund was issued for $20, the net amount will be $80. 1085 "currency": "A String", # The currency of the price. 1086 "value": "A String", # The price represented as a number. 1087 }, 1088 "id": "A String", # The REST id of the order. Globally unique. 1089 }, 1090 }</pre> 1091</div> 1092 1093<div class="method"> 1094 <code class="details" id="gettestordertemplate">gettestordertemplate(merchantId, templateName)</code> 1095 <pre>Sandbox only. Retrieves an order template that can be used to quickly create a new order in sandbox. This method can only be called for non-multi-client accounts. 1096 1097Args: 1098 merchantId: string, The ID of the managing account. (required) 1099 templateName: string, The name of the template to retrieve. (required) 1100 Allowed values 1101 template1 - 1102 template1a - 1103 template1b - 1104 template2 - 1105 1106Returns: 1107 An object of the form: 1108 1109 { 1110 "kind": "content#ordersGetTestOrderTemplateResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersGetTestOrderTemplateResponse". 1111 "template": { # The requested test order template. 1112 "customer": { # The details of the customer who placed the order. 1113 "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow. Optional. 1114 "fullName": "A String", # Full name of the customer. 1115 "email": "A String", # Email address of the customer. 1116 }, 1117 "promotions": [ # The details of the merchant provided promotions applied to the order. More details about the program are here. 1118 { 1119 "benefits": [ 1120 { 1121 "offerIds": [ # The OfferId(s) that were purchased in this order and map to this specific benefit of the promotion. 1122 "A String", 1123 ], 1124 "discount": { # The discount in the order price when the promotion is applied. 1125 "currency": "A String", # The currency of the price. 1126 "value": "A String", # The price represented as a number. 1127 }, 1128 "type": "A String", # Describes whether the promotion applies to products (e.g. 20% off) or to shipping (e.g. Free Shipping). 1129 "taxImpact": { # The impact on tax when the promotion is applied. 1130 "currency": "A String", # The currency of the price. 1131 "value": "A String", # The price represented as a number. 1132 }, 1133 "subType": "A String", # Further describes the benefit of the promotion. Note that we will expand on this enumeration as we support new promotion sub-types. 1134 }, 1135 ], 1136 "longTitle": "A String", # The full title of the promotion. 1137 "genericRedemptionCode": "A String", # Optional. The text code that corresponds to the promotion when applied on the retailer?s website. 1138 "redemptionChannel": "A String", # Indicates that the promotion is valid online. 1139 "productApplicability": "A String", # Whether the promotion is applicable to all products or only specific products. 1140 "effectiveDates": "A String", # The date and time frame when the promotion is active and ready for validation review. Note that the promotion live time may be delayed for a few hours due to the validation review. 1141 # Start date and end date are separated by a forward slash (/). The start date is specified by the format (YYYY-MM-DD), followed by the letter ?T?, the time of the day when the sale starts (in Greenwich Mean Time, GMT), followed by an expression of the time zone for the sale. The end date is in the same format. 1142 "id": "A String", # The unique ID of the promotion. 1143 }, 1144 ], 1145 "kind": "content#testOrder", # Identifies what kind of resource this is. Value: the fixed string "content#testOrder". 1146 "shippingCostTax": { # The tax for the total shipping cost. 1147 "currency": "A String", # The currency of the price. 1148 "value": "A String", # The price represented as a number. 1149 }, 1150 "predefinedDeliveryAddress": "A String", # Identifier of one of the predefined delivery addresses for the delivery. 1151 "shippingCost": { # The total cost of shipping for all items. 1152 "currency": "A String", # The currency of the price. 1153 "value": "A String", # The price represented as a number. 1154 }, 1155 "shippingOption": "A String", # The requested shipping option. 1156 "lineItems": [ # Line items that are ordered. At least one line item must be provided. 1157 { 1158 "returnInfo": { # Details of the return policy for the line item. 1159 "policyUrl": "A String", # URL of the item return policy. 1160 "isReturnable": True or False, # Whether the item is returnable. 1161 "daysToReturn": 42, # How many days later the item can be returned. 1162 }, 1163 "product": { # Product data from the time of the order placement. 1164 "targetCountry": "A String", # The CLDR territory code of the target country of the product. 1165 "contentLanguage": "A String", # The two-letter ISO 639-1 language code for the item. 1166 "title": "A String", # The title of the product. 1167 "mpn": "A String", # Manufacturer Part Number (MPN) of the item. Optional. 1168 "variantAttributes": [ # Variant attributes for the item. Optional. 1169 { 1170 "dimension": "A String", # The dimension of the variant. 1171 "value": "A String", # The value for the dimension. 1172 }, 1173 ], 1174 "brand": "A String", # Brand of the item. 1175 "itemGroupId": "A String", # Shared identifier for all variants of the same product. Optional. 1176 "offerId": "A String", # An identifier of the item. 1177 "imageLink": "A String", # URL of an image of the item. 1178 "gtin": "A String", # Global Trade Item Number (GTIN) of the item. Optional. 1179 "channel": "A String", # The item's channel. 1180 "price": { # The price for the product. 1181 "currency": "A String", # The currency of the price. 1182 "value": "A String", # The price represented as a number. 1183 }, 1184 "condition": "A String", # Condition or state of the item. 1185 }, 1186 "unitTax": { # Unit tax for the line item. 1187 "currency": "A String", # The currency of the price. 1188 "value": "A String", # The price represented as a number. 1189 }, 1190 "quantityOrdered": 42, # Number of items ordered. 1191 "shippingDetails": { # Details of the requested shipping for the line item. 1192 "deliverByDate": "A String", # The delivery by date, in ISO 8601 format. 1193 "method": { # Details of the shipping method. 1194 "minDaysInTransit": 42, # Minimum transit time. 1195 "carrier": "A String", # The carrier for the shipping. Optional. 1196 "methodName": "A String", # The name of the shipping method. 1197 "maxDaysInTransit": 42, # Maximum transit time. 1198 }, 1199 "shipByDate": "A String", # The ship by date, in ISO 8601 format. 1200 }, 1201 }, 1202 ], 1203 "paymentMethod": { # The details of the payment method. 1204 "expirationMonth": 42, # The card expiration month (January = 1, February = 2 etc.). 1205 "type": "A String", # The type of instrument. Note that real orders might have different values than the four values accepted by createTestOrder. 1206 "expirationYear": 42, # The card expiration year (4-digit, e.g. 2015). 1207 "lastFourDigits": "A String", # The last four digits of the card number. 1208 "predefinedBillingAddress": "A String", # The billing address. 1209 }, 1210 }, 1211 }</pre> 1212</div> 1213 1214<div class="method"> 1215 <code class="details" id="list">list(merchantId, orderBy=None, pageToken=None, placedDateEnd=None, acknowledged=None, maxResults=None, placedDateStart=None, statuses=None)</code> 1216 <pre>Lists the orders in your Merchant Center account. This method can only be called for non-multi-client accounts. 1217 1218Args: 1219 merchantId: string, The ID of the managing account. (required) 1220 orderBy: string, The ordering of the returned list. The only supported value are placedDate desc and placedDate asc for now, which returns orders sorted by placement date. "placedDate desc" stands for listing orders by placement date, from oldest to most recent. "placedDate asc" stands for listing orders by placement date, from most recent to oldest. In future releases we'll support other sorting criteria. 1221 Allowed values 1222 placedDate asc - 1223 placedDate desc - 1224 pageToken: string, The token returned by the previous request. 1225 placedDateEnd: string, Obtains orders placed before this date (exclusively), in ISO 8601 format. 1226 acknowledged: boolean, Obtains orders that match the acknowledgement status. When set to true, obtains orders that have been acknowledged. When false, obtains orders that have not been acknowledged. 1227We recommend using this filter set to false, in conjunction with the acknowledge call, such that only un-acknowledged orders are returned. 1228 maxResults: integer, The maximum number of orders to return in the response, used for paging. The default value is 25 orders per page, and the maximum allowed value is 250 orders per page. 1229Known issue: All List calls will return all Orders without limit regardless of the value of this field. 1230 placedDateStart: string, Obtains orders placed after this date (inclusively), in ISO 8601 format. 1231 statuses: string, Obtains orders that match any of the specified statuses. Multiple values can be specified with comma separation. Additionally, please note that active is a shortcut for pendingShipment and partiallyShipped, and completed is a shortcut for shipped , partiallyDelivered, delivered, partiallyReturned, returned, and canceled. (repeated) 1232 Allowed values 1233 active - 1234 canceled - 1235 completed - 1236 delivered - 1237 inProgress - 1238 partiallyDelivered - 1239 partiallyReturned - 1240 partiallyShipped - 1241 pendingShipment - 1242 returned - 1243 shipped - 1244 1245Returns: 1246 An object of the form: 1247 1248 { 1249 "nextPageToken": "A String", # The token for the retrieval of the next page of orders. 1250 "kind": "content#ordersListResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersListResponse". 1251 "resources": [ 1252 { 1253 "customer": { # The details of the customer who placed the order. 1254 "explicitMarketingPreference": True or False, # If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow. 1255 "fullName": "A String", # Full name of the customer. 1256 "email": "A String", # Email address of the customer. 1257 }, 1258 "promotions": [ # The details of the merchant provided promotions applied to the order. More details about the program are here. 1259 { 1260 "benefits": [ 1261 { 1262 "offerIds": [ # The OfferId(s) that were purchased in this order and map to this specific benefit of the promotion. 1263 "A String", 1264 ], 1265 "discount": { # The discount in the order price when the promotion is applied. 1266 "currency": "A String", # The currency of the price. 1267 "value": "A String", # The price represented as a number. 1268 }, 1269 "type": "A String", # Describes whether the promotion applies to products (e.g. 20% off) or to shipping (e.g. Free Shipping). 1270 "taxImpact": { # The impact on tax when the promotion is applied. 1271 "currency": "A String", # The currency of the price. 1272 "value": "A String", # The price represented as a number. 1273 }, 1274 "subType": "A String", # Further describes the benefit of the promotion. Note that we will expand on this enumeration as we support new promotion sub-types. 1275 }, 1276 ], 1277 "longTitle": "A String", # The full title of the promotion. 1278 "genericRedemptionCode": "A String", # Optional. The text code that corresponds to the promotion when applied on the retailer?s website. 1279 "redemptionChannel": "A String", # Indicates that the promotion is valid online. 1280 "productApplicability": "A String", # Whether the promotion is applicable to all products or only specific products. 1281 "effectiveDates": "A String", # The date and time frame when the promotion is active and ready for validation review. Note that the promotion live time may be delayed for a few hours due to the validation review. 1282 # Start date and end date are separated by a forward slash (/). The start date is specified by the format (YYYY-MM-DD), followed by the letter ?T?, the time of the day when the sale starts (in Greenwich Mean Time, GMT), followed by an expression of the time zone for the sale. The end date is in the same format. 1283 "id": "A String", # The unique ID of the promotion. 1284 }, 1285 ], 1286 "kind": "content#order", # Identifies what kind of resource this is. Value: the fixed string "content#order". 1287 "shippingCostTax": { # The tax for the total shipping cost. 1288 "currency": "A String", # The currency of the price. 1289 "value": "A String", # The price represented as a number. 1290 }, 1291 "shipments": [ # Shipments of the order. 1292 { 1293 "status": "A String", # The status of the shipment. 1294 "creationDate": "A String", # Date on which the shipment has been created, in ISO 8601 format. 1295 "carrier": "A String", # The carrier handling the shipment. 1296 "trackingId": "A String", # The tracking id for the shipment. 1297 "deliveryDate": "A String", # Date on which the shipment has been delivered, in ISO 8601 format. Present only if status is delievered 1298 "lineItems": [ # The line items that are shipped. 1299 { 1300 "lineItemId": "A String", # The id of the line item that is shipped. 1301 "quantity": 42, # The quantity that is shipped. 1302 }, 1303 ], 1304 "id": "A String", # The id of the shipment. 1305 }, 1306 ], 1307 "refunds": [ # Refunds for the order. 1308 { 1309 "amount": { # The amount that is refunded. 1310 "currency": "A String", # The currency of the price. 1311 "value": "A String", # The price represented as a number. 1312 }, 1313 "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format. 1314 "reason": "A String", # The reason for the refund. 1315 "actor": "A String", # The actor that created the refund. 1316 "reasonText": "A String", # The explanation of the reason. 1317 }, 1318 ], 1319 "paymentMethod": { # The details of the payment method. 1320 "expirationMonth": 42, # The card expiration month (January = 1, February = 2 etc.). 1321 "lastFourDigits": "A String", # The last four digits of the card number. 1322 "expirationYear": 42, # The card expiration year (4-digit, e.g. 2015). 1323 "phoneNumber": "A String", # The billing phone number. 1324 "billingAddress": { # The billing address. 1325 "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). 1326 "country": "A String", # CLDR country code (e.g. "US"). 1327 "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: 1328 # John Smith 1329 # 1600 Amphitheatre Parkway 1330 # Mountain View, CA, 94043 1331 # United States 1332 "A String", 1333 ], 1334 "streetAddress": [ # Street-level part of the address. 1335 "A String", 1336 ], 1337 "postalCode": "A String", # Postal Code or ZIP (e.g. "94043"). 1338 "recipientName": "A String", # Name of the recipient. 1339 "isPostOfficeBox": True or False, # Whether the address is a post office box. 1340 "region": "A String", # Top-level administrative subdivision of the country (e.g. "CA"). 1341 }, 1342 "type": "A String", # The type of instrument (VISA, Mastercard, etc). 1343 }, 1344 "shippingCost": { # The total cost of shipping for all items. 1345 "currency": "A String", # The currency of the price. 1346 "value": "A String", # The price represented as a number. 1347 }, 1348 "acknowledged": True or False, # Whether the order was acknowledged. 1349 "paymentStatus": "A String", # The status of the payment. 1350 "merchantId": "A String", 1351 "merchantOrderId": "A String", # Merchant-provided id of the order. 1352 "shippingOption": "A String", # The requested shipping option. 1353 "status": "A String", # The status of the order. 1354 "deliveryDetails": { # The details for the delivery. 1355 "phoneNumber": "A String", # The phone number of the person receiving the delivery. 1356 "address": { # The delivery address 1357 "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). 1358 "country": "A String", # CLDR country code (e.g. "US"). 1359 "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: 1360 # John Smith 1361 # 1600 Amphitheatre Parkway 1362 # Mountain View, CA, 94043 1363 # United States 1364 "A String", 1365 ], 1366 "streetAddress": [ # Street-level part of the address. 1367 "A String", 1368 ], 1369 "postalCode": "A String", # Postal Code or ZIP (e.g. "94043"). 1370 "recipientName": "A String", # Name of the recipient. 1371 "isPostOfficeBox": True or False, # Whether the address is a post office box. 1372 "region": "A String", # Top-level administrative subdivision of the country (e.g. "CA"). 1373 }, 1374 }, 1375 "placedDate": "A String", # The date when the order was placed, in ISO 8601 format. 1376 "channelType": "A String", # The channel type of the order: "purchaseOnGoogle" or "googleExpress". 1377 "lineItems": [ # Line items that are ordered. 1378 { 1379 "product": { # Product data from the time of the order placement. 1380 "targetCountry": "A String", # The CLDR territory code of the target country of the product. 1381 "shownImage": "A String", # URL to the cached image shown to the user when order was placed. 1382 "contentLanguage": "A String", # The two-letter ISO 639-1 language code for the item. 1383 "title": "A String", # The title of the product. 1384 "mpn": "A String", # Manufacturer Part Number (MPN) of the item. 1385 "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. 1386 { 1387 "dimension": "A String", # The dimension of the variant. 1388 "value": "A String", # The value for the dimension. 1389 }, 1390 ], 1391 "brand": "A String", # Brand of the item. 1392 "itemGroupId": "A String", # Shared identifier for all variants of the same product. 1393 "offerId": "A String", # An identifier of the item. 1394 "price": { # Price of the item. 1395 "currency": "A String", # The currency of the price. 1396 "value": "A String", # The price represented as a number. 1397 }, 1398 "imageLink": "A String", # URL of an image of the item. 1399 "gtin": "A String", # Global Trade Item Number (GTIN) of the item. 1400 "channel": "A String", # The item's channel (online or local). 1401 "id": "A String", # The REST id of the product. 1402 "condition": "A String", # Condition or state of the item. 1403 }, 1404 "quantityDelivered": 42, # Number of items delivered. 1405 "returnInfo": { # Details of the return policy for the line item. 1406 "policyUrl": "A String", # URL of the item return policy. 1407 "isReturnable": True or False, # Whether the item is returnable. 1408 "daysToReturn": 42, # How many days later the item can be returned. 1409 }, 1410 "price": { # Total price for the line item. For example, if two items for $10 are purchased, the total price will be $20. 1411 "currency": "A String", # The currency of the price. 1412 "value": "A String", # The price represented as a number. 1413 }, 1414 "quantityPending": 42, # Number of items pending. 1415 "tax": { # Total tax amount for the line item. For example, if two items are purchased, and each have a cost tax of $2, the total tax amount will be $4. 1416 "currency": "A String", # The currency of the price. 1417 "value": "A String", # The price represented as a number. 1418 }, 1419 "cancellations": [ # Cancellations of the line item. 1420 { 1421 "reason": "A String", # The reason for the cancellation. Orders that are cancelled with a noInventory reason will lead to the removal of the product from POG until you make an update to that product. This will not affect your Shopping ads. 1422 "creationDate": "A String", # Date on which the cancellation has been created, in ISO 8601 format. 1423 "reasonText": "A String", # The explanation of the reason. 1424 "actor": "A String", # The actor that created the cancellation. 1425 "quantity": 42, # The quantity that was canceled. 1426 }, 1427 ], 1428 "quantityCanceled": 42, # Number of items canceled. 1429 "quantityOrdered": 42, # Number of items ordered. 1430 "returns": [ # Returns of the line item. 1431 { 1432 "reason": "A String", # The reason for the return. 1433 "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format. 1434 "reasonText": "A String", # The explanation of the reason. 1435 "actor": "A String", # The actor that created the refund. 1436 "quantity": 42, # Quantity that is returned. 1437 }, 1438 ], 1439 "quantityShipped": 42, # Number of items shipped. 1440 "quantityReturned": 42, # Number of items returned. 1441 "id": "A String", # The id of the line item. 1442 "shippingDetails": { # Details of the requested shipping for the line item. 1443 "deliverByDate": "A String", # The delivery by date, in ISO 8601 format. 1444 "method": { # Details of the shipping method. 1445 "minDaysInTransit": 42, # Minimum transit time. 1446 "carrier": "A String", # The carrier for the shipping. Optional. 1447 "methodName": "A String", # The name of the shipping method. 1448 "maxDaysInTransit": 42, # Maximum transit time. 1449 }, 1450 "shipByDate": "A String", # The ship by date, in ISO 8601 format. 1451 }, 1452 }, 1453 ], 1454 "netAmount": { # The net amount for the order. For example, if an order was originally for a grand total of $100 and a refund was issued for $20, the net amount will be $80. 1455 "currency": "A String", # The currency of the price. 1456 "value": "A String", # The price represented as a number. 1457 }, 1458 "id": "A String", # The REST id of the order. Globally unique. 1459 }, 1460 ], 1461 }</pre> 1462</div> 1463 1464<div class="method"> 1465 <code class="details" id="list_next">list_next(previous_request, previous_response)</code> 1466 <pre>Retrieves the next page of results. 1467 1468Args: 1469 previous_request: The request for the previous page. (required) 1470 previous_response: The response from the request for the previous page. (required) 1471 1472Returns: 1473 A request object that you can call 'execute()' on to request the next 1474 page. Returns None if there are no more items in the collection. 1475 </pre> 1476</div> 1477 1478<div class="method"> 1479 <code class="details" id="refund">refund(merchantId, orderId, body)</code> 1480 <pre>Refund a portion of the order, up to the full amount paid. This method can only be called for non-multi-client accounts. 1481 1482Args: 1483 merchantId: string, The ID of the managing account. (required) 1484 orderId: string, The ID of the order to refund. (required) 1485 body: object, The request body. (required) 1486 The object takes the form of: 1487 1488{ 1489 "amount": { # The amount that is refunded. 1490 "currency": "A String", # The currency of the price. 1491 "value": "A String", # The price represented as a number. 1492 }, 1493 "reasonText": "A String", # The explanation of the reason. 1494 "reason": "A String", # The reason for the refund. 1495 "operationId": "A String", # The ID of the operation. Unique across all operations for a given order. 1496 } 1497 1498 1499Returns: 1500 An object of the form: 1501 1502 { 1503 "kind": "content#ordersRefundResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersRefundResponse". 1504 "executionStatus": "A String", # The status of the execution. 1505 }</pre> 1506</div> 1507 1508<div class="method"> 1509 <code class="details" id="returnlineitem">returnlineitem(merchantId, orderId, body)</code> 1510 <pre>Returns a line item. This method can only be called for non-multi-client accounts. 1511 1512Args: 1513 merchantId: string, The ID of the managing account. (required) 1514 orderId: string, The ID of the order. (required) 1515 body: object, The request body. (required) 1516 The object takes the form of: 1517 1518{ 1519 "reason": "A String", # The reason for the return. 1520 "quantity": 42, # The quantity to return. 1521 "reasonText": "A String", # The explanation of the reason. 1522 "lineItemId": "A String", # The ID of the line item to return. 1523 "operationId": "A String", # The ID of the operation. Unique across all operations for a given order. 1524 } 1525 1526 1527Returns: 1528 An object of the form: 1529 1530 { 1531 "kind": "content#ordersReturnLineItemResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersReturnLineItemResponse". 1532 "executionStatus": "A String", # The status of the execution. 1533 }</pre> 1534</div> 1535 1536<div class="method"> 1537 <code class="details" id="shiplineitems">shiplineitems(merchantId, orderId, body)</code> 1538 <pre>Marks line item(s) as shipped. This method can only be called for non-multi-client accounts. 1539 1540Args: 1541 merchantId: string, The ID of the managing account. (required) 1542 orderId: string, The ID of the order. (required) 1543 body: object, The request body. (required) 1544 The object takes the form of: 1545 1546{ 1547 "lineItems": [ # Line items to ship. 1548 { 1549 "lineItemId": "A String", # The id of the line item that is shipped. 1550 "quantity": 42, # The quantity that is shipped. 1551 }, 1552 ], 1553 "carrier": "A String", # The carrier handling the shipment. 1554 "shipmentId": "A String", # The ID of the shipment. 1555 "trackingId": "A String", # The tracking id for the shipment. 1556 "operationId": "A String", # The ID of the operation. Unique across all operations for a given order. 1557 } 1558 1559 1560Returns: 1561 An object of the form: 1562 1563 { 1564 "kind": "content#ordersShipLineItemsResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersShipLineItemsResponse". 1565 "executionStatus": "A String", # The status of the execution. 1566 }</pre> 1567</div> 1568 1569<div class="method"> 1570 <code class="details" id="updatemerchantorderid">updatemerchantorderid(merchantId, orderId, body)</code> 1571 <pre>Updates the merchant order ID for a given order. This method can only be called for non-multi-client accounts. 1572 1573Args: 1574 merchantId: string, The ID of the managing account. (required) 1575 orderId: string, The ID of the order. (required) 1576 body: object, The request body. (required) 1577 The object takes the form of: 1578 1579{ 1580 "merchantOrderId": "A String", # The merchant order id to be assigned to the order. Must be unique per merchant. 1581 "operationId": "A String", # The ID of the operation. Unique across all operations for a given order. 1582 } 1583 1584 1585Returns: 1586 An object of the form: 1587 1588 { 1589 "kind": "content#ordersUpdateMerchantOrderIdResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersUpdateMerchantOrderIdResponse". 1590 "executionStatus": "A String", # The status of the execution. 1591 }</pre> 1592</div> 1593 1594<div class="method"> 1595 <code class="details" id="updateshipment">updateshipment(merchantId, orderId, body)</code> 1596 <pre>Updates a shipment's status, carrier, and/or tracking ID. This method can only be called for non-multi-client accounts. 1597 1598Args: 1599 merchantId: string, The ID of the managing account. (required) 1600 orderId: string, The ID of the order. (required) 1601 body: object, The request body. (required) 1602 The object takes the form of: 1603 1604{ 1605 "status": "A String", # New status for the shipment. Not updated if missing. 1606 "shipmentId": "A String", # The ID of the shipment. 1607 "carrier": "A String", # The carrier handling the shipment. Not updated if missing. 1608 "trackingId": "A String", # The tracking id for the shipment. Not updated if missing. 1609 "operationId": "A String", # The ID of the operation. Unique across all operations for a given order. 1610 } 1611 1612 1613Returns: 1614 An object of the form: 1615 1616 { 1617 "kind": "content#ordersUpdateShipmentResponse", # Identifies what kind of resource this is. Value: the fixed string "content#ordersUpdateShipmentResponse". 1618 "executionStatus": "A String", # The status of the execution. 1619 }</pre> 1620</div> 1621 1622</body></html>