docs: update docs/dyn (#1096)
This PR was generated using Autosynth. :rainbow:
Synth log will be available here:
https://source.cloud.google.com/results/invocations/6f0f288a-a1e8-4b2d-a85f-00b1c6150185/targets
- [ ] To automatically regenerate this PR, check this box.
Source-Link: https://github.com/googleapis/synthtool/commit/39b7149da4026765385403632db3c6f63db96b2c
Source-Link: https://github.com/googleapis/synthtool/commit/9a7d9fbb7045c34c9d3d22c1ff766eeae51f04c9
Source-Link: https://github.com/googleapis/synthtool/commit/dc9903a8c30c3662b6098f0e4a97f221d67268b2
Source-Link: https://github.com/googleapis/synthtool/commit/7fcc405a579d5d53a726ff3da1b7c8c08f0f2d58
Source-Link: https://github.com/googleapis/synthtool/commit/d5fc0bcf9ea9789c5b0e3154a9e3b29e5cea6116
Source-Link: https://github.com/googleapis/synthtool/commit/e89175cf074dccc4babb4eca66ae913696e47a71
Source-Link: https://github.com/googleapis/synthtool/commit/7d652819519dfa24da9e14548232e4aaba71a11c
Source-Link: https://github.com/googleapis/synthtool/commit/7db8a6c5ffb12a6e4c2f799c18f00f7f3d60e279
Source-Link: https://github.com/googleapis/synthtool/commit/1f1148d3c7a7a52f0c98077f976bd9b3c948ee2b
Source-Link: https://github.com/googleapis/synthtool/commit/2c8aecedd55b0480fb4e123b6e07fa5b12953862
Source-Link: https://github.com/googleapis/synthtool/commit/3d3e94c4e02370f307a9a200b0c743c3d8d19f29
Source-Link: https://github.com/googleapis/synthtool/commit/c7824ea48ff6d4d42dfae0849aec8a85acd90bd9
Source-Link: https://github.com/googleapis/synthtool/commit/ba9918cd22874245b55734f57470c719b577e591
Source-Link: https://github.com/googleapis/synthtool/commit/b19b401571e77192f8dd38eab5fb2300a0de9324
Source-Link: https://github.com/googleapis/synthtool/commit/6542bd723403513626f61642fc02ddca528409aa
diff --git a/docs/dyn/content_v2_1.orders.html b/docs/dyn/content_v2_1.orders.html
index 07efecd..bccf352 100644
--- a/docs/dyn/content_v2_1.orders.html
+++ b/docs/dyn/content_v2_1.orders.html
@@ -111,7 +111,7 @@
<code><a href="#instorerefundlineitem">instorerefundlineitem(merchantId, orderId, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Deprecated. Notifies that item return and refund was handled directly by merchant outside of Google payments processing (e.g. cash refund done in store). Note: We recommend calling the returnrefundlineitem method to refund in-store returns. We will issue the refund directly to the customer. This helps to prevent possible differences arising between merchant and Google transaction records. We also recommend having the point of sale system communicate with Google to ensure that customers do not receive a double refund by first refunding via Google then via an in-store return.</p>
<p class="toc_element">
- <code><a href="#list">list(merchantId, placedDateStart=None, orderBy=None, placedDateEnd=None, maxResults=None, acknowledged=None, pageToken=None, statuses=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(merchantId, maxResults=None, acknowledged=None, orderBy=None, pageToken=None, placedDateEnd=None, placedDateStart=None, statuses=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists the orders in your Merchant Center account.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -167,8 +167,8 @@
An object of the form:
{
- "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#ordersAcknowledgeResponse".
"executionStatus": "A String", # The status of the execution. Acceptable values are: - "`duplicate`" - "`executed`"
+ "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#ordersAcknowledgeResponse".
}</pre>
</div>
@@ -203,8 +203,8 @@
The object takes the form of:
{
- "reason": "A String", # The reason for the cancellation. Acceptable values are: - "`customerInitiatedCancel`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`noInventory`" - "`other`" - "`priceError`" - "`shippingPriceError`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`"
"operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
+ "reason": "A String", # The reason for the cancellation. Acceptable values are: - "`customerInitiatedCancel`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`noInventory`" - "`other`" - "`priceError`" - "`shippingPriceError`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`"
"reasonText": "A String", # The explanation of the reason.
}
@@ -233,12 +233,12 @@
The object takes the form of:
{
- "productId": "A String", # The ID of the product to cancel. This is the REST ID used in the products service. Either lineItemId or productId is required.
- "lineItemId": "A String", # The ID of the line item to cancel. Either lineItemId or productId is required.
- "operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
- "reason": "A String", # The reason for the cancellation. Acceptable values are: - "`customerInitiatedCancel`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`noInventory`" - "`other`" - "`priceError`" - "`shippingPriceError`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`"
"reasonText": "A String", # The explanation of the reason.
"quantity": 42, # The quantity to cancel.
+ "operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
+ "productId": "A String", # The ID of the product to cancel. This is the REST ID used in the products service. Either lineItemId or productId is required.
+ "lineItemId": "A String", # The ID of the line item to cancel. Either lineItemId or productId is required.
+ "reason": "A String", # The reason for the cancellation. Acceptable values are: - "`customerInitiatedCancel`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`noInventory`" - "`other`" - "`priceError`" - "`shippingPriceError`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`"
}
x__xgafv: string, V1 error format.
@@ -298,151 +298,151 @@
{
"country": "A String", # The CLDR territory code of the country of the test order to create. Affects the currency and addresses of orders created via `template_name`, or the addresses of orders created via `test_order`. Acceptable values are: - "`US`" - "`FR`" Defaults to `US`.
+ "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. Acceptable values are: - "`template1`" - "`template1a`" - "`template1b`" - "`template2`" - "`template3`"
"testOrder": { # The test order to create.
- "lineItems": [ # Required. Line items that are ordered. At least one line item must be provided.
- {
- "returnInfo": { # Required. Details of the return policy for the line item.
- "daysToReturn": 42, # Required. How many days later the item can be returned.
- "isReturnable": True or False, # Required. Whether the item is returnable.
- "policyUrl": "A String", # Required. URL of the item return policy.
- },
- "product": { # Required. Product data from the time of the order placement.
- "brand": "A String", # Required. Brand of the item.
- "mpn": "A String", # Manufacturer Part Number (MPN) of the item. Optional.
- "targetCountry": "A String", # Required. The CLDR territory // code of the target country of the product.
- "contentLanguage": "A String", # Required. The two-letter ISO 639-1 language code for the item. Acceptable values are: - "`en`" - "`fr`"
- "itemGroupId": "A String", # Shared identifier for all variants of the same product. Optional.
- "gtin": "A String", # Global Trade Item Number (GTIN) of the item. Optional.
- "title": "A String", # Required. The title of the product.
- "offerId": "A String", # Required. An identifier of the item.
- "condition": "A String", # Required. Condition or state of the item. Acceptable values are: - "`new`"
- "fees": [ # Fees for the item. Optional.
- {
- "amount": { # Amount of the fee.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "name": "A String", # Name of the fee.
- },
- ],
- "variantAttributes": [ # Variant attributes for the item. Optional.
- {
- "dimension": "A String", # The dimension of the variant.
- "value": "A String", # The value for the dimension.
- },
- ],
- "imageLink": "A String", # Required. URL of an image of the item.
- "price": { # Required. The price for the product. Tax is automatically calculated for orders where marketplace facilitator tax laws are applicable. Otherwise, tax settings from Merchant Center are applied.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- },
- "shippingDetails": { # Required. Details of the requested shipping for the line item.
- "shipByDate": "A String", # Required. The ship by date, in ISO 8601 format.
- "deliverByDate": "A String", # Required. The delivery by date, in ISO 8601 format.
- "type": "A String", # Type of shipment. Indicates whether `deliveryDetails` or `pickupDetails` is applicable for this shipment. Acceptable values are: - "`delivery`" - "`pickup`"
- "method": { # Required. Details of the shipping method.
- "carrier": "A String", # The carrier for the shipping. Optional. See `shipments[].carrier` for a list of acceptable values.
- "methodName": "A String", # Required. The name of the shipping method.
- "minDaysInTransit": 42, # Required. Minimum transit time.
- "maxDaysInTransit": 42, # Required. Maximum transit time.
- },
- "pickupPromiseInMinutes": 42, # The promised time in minutes in which the order will be ready for pickup. This only applies to buy-online-pickup-in-store same-day order.
- },
- "quantityOrdered": 42, # Required. Number of items ordered.
- },
- ],
- "promotions": [ # Promotions associated with the order.
- {
- "appliedItems": [ # Items that this promotion have been applied to. Do not provide for `orders.createtestorder`. This field will be empty for shipping promotions because shipping is not tied to any specific item.
- {
- "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
- "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
- "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
- "productId": "A String", # `orders.createtestorder`.
- },
- ],
- "funder": "A String", # Required. The party funding the promotion. Only `merchant` is supported for `orders.createtestorder`. Acceptable values are: - "`google`" - "`merchant`"
- "subtype": "A String", # Required. The category of the promotion. Only `moneyOff` is supported for `orders.createtestorder`. Acceptable values are: - "`buyMGetMoneyOff`" - "`buyMGetNMoneyOff`" - "`buyMGetNPercentOff`" - "`buyMGetPercentOff`" - "`freeGift`" - "`freeGiftWithItemId`" - "`freeGiftWithValue`" - "`freeShippingOvernight`" - "`freeShippingStandard`" - "`freeShippingTwoDay`" - "`moneyOff`" - "`percentOff`" - "`rewardPoints`" - "`salePrice`"
- "type": "A String", # Required. The scope of the promotion. Only `product` is supported for `orders.createtestorder`. Acceptable values are: - "`product`" - "`shipping`"
- "endTime": "A String", # Promotion end time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
- "startTime": "A String", # Promotion start time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
- "shortTitle": "A String", # A short title of the promotion to be shown on the checkout page. Do not provide for `orders.createtestorder`.
- "taxValue": { # Estimated discount applied to tax (if allowed by law). Do not provide for `orders.createtestorder`.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "title": "A String", # Required. The title of the promotion.
- "merchantPromotionId": "A String", # Required. This field is used to identify promotions within merchants' own systems.
- "priceValue": { # Estimated discount applied to price. Amount is pre-tax or post-tax depending on location of order.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "applicableItems": [ # Items that this promotion may be applied to. If empty, there are no restrictions on applicable items and quantity. This field will also be empty for shipping promotions because shipping is not tied to any specific item.
- {
- "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
- "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
- "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
- "productId": "A String", # `orders.createtestorder`.
- },
- ],
- },
- ],
- "shippingOption": "A String", # Required. The requested shipping option. Acceptable values are: - "`economy`" - "`expedited`" - "`oneDay`" - "`sameDay`" - "`standard`" - "`twoDay`"
"enableOrderinvoices": True or False, # Whether the orderinvoices service should support this order.
+ "predefinedPickupDetails": "A String", # Identifier of one of the predefined pickup details. Required for orders containing line items with shipping type `pickup`. Acceptable values are: - "`dwight`" - "`jim`" - "`pam`"
+ "notificationMode": "A String", # Restricted. Do not use.
+ "predefinedEmail": "A String", # Required. Email address of the customer. Acceptable values are: - "`pog.dwight.schrute@gmail.com`" - "`pog.jim.halpert@gmail.com`" - "`penpog.pam.beesly@gmail.comding`"
"pickupDetails": { # Overrides the predefined pickup details if provided.
+ "pickupLocationAddress": { # Required. Pickup location address.
+ "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
+ "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
+ "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
+ "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
+ "A String",
+ ],
+ "recipientName": "A String", # Name of the recipient.
+ "streetAddress": [ # Street-level part of the address.
+ "A String",
+ ],
+ "country": "A String", # CLDR country code (e.g. "US").
+ "isPostOfficeBox": True or False, # Whether the address is a post office box.
+ },
"pickupPersons": [ # Required. all pickup persons set by users.
{
"name": "A String", # Required. Full name of the pickup person.
"phoneNumber": "A String", # Required. The phone number of the person picking up the items.
},
],
- "pickupLocationAddress": { # Required. Pickup location address.
- "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
- "recipientName": "A String", # Name of the recipient.
- "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
- "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
- "A String",
- ],
- "streetAddress": [ # Street-level part of the address.
- "A String",
- ],
- "country": "A String", # CLDR country code (e.g. "US").
- "isPostOfficeBox": True or False, # Whether the address is a post office box.
- "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
- },
- "locationCode": "A String", # Required. Code of the location defined by provider or merchant.
"pickupLocationType": "A String", # Pickup location type. Acceptable values are: - "`locker`" - "`store`" - "`curbside`"
+ "locationCode": "A String", # Required. Code of the location defined by provider or merchant.
},
- "predefinedEmail": "A String", # Required. Email address of the customer. Acceptable values are: - "`pog.dwight.schrute@gmail.com`" - "`pog.jim.halpert@gmail.com`" - "`penpog.pam.beesly@gmail.comding`"
- "predefinedDeliveryAddress": "A String", # Required. Identifier of one of the predefined delivery addresses for the delivery. Acceptable values are: - "`dwight`" - "`jim`" - "`pam`"
- "shippingCost": { # Required. The price of shipping for all items. Shipping tax is automatically calculated for orders where marketplace facilitator tax laws are applicable. Otherwise, tax settings from Merchant Center are applied. Note that shipping is not taxed in certain states.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "notificationMode": "A String", # Restricted. Do not use.
- "predefinedBillingAddress": "A String", # Required. The billing address. Acceptable values are: - "`dwight`" - "`jim`" - "`pam`"
- "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#testOrder`"
- "predefinedPickupDetails": "A String", # Identifier of one of the predefined pickup details. Required for orders containing line items with shipping type `pickup`. Acceptable values are: - "`dwight`" - "`jim`" - "`pam`"
"deliveryDetails": { # Overrides the predefined delivery details if provided.
"address": { # The delivery address
- "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
- "recipientName": "A String", # Name of the recipient.
"region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
+ "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
+ "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
"fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
"A String",
],
+ "recipientName": "A String", # Name of the recipient.
"streetAddress": [ # Street-level part of the address.
"A String",
],
"country": "A String", # CLDR country code (e.g. "US").
"isPostOfficeBox": True or False, # Whether the address is a post office box.
- "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
},
"phoneNumber": "A String", # The phone number of the person receiving the delivery.
},
+ "promotions": [ # Promotions associated with the order.
+ {
+ "priceValue": { # Estimated discount applied to price. Amount is pre-tax or post-tax depending on location of order.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "shortTitle": "A String", # A short title of the promotion to be shown on the checkout page. Do not provide for `orders.createtestorder`.
+ "endTime": "A String", # Promotion end time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
+ "taxValue": { # Estimated discount applied to tax (if allowed by law). Do not provide for `orders.createtestorder`.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "title": "A String", # Required. The title of the promotion.
+ "merchantPromotionId": "A String", # Required. This field is used to identify promotions within merchants' own systems.
+ "appliedItems": [ # Items that this promotion have been applied to. Do not provide for `orders.createtestorder`. This field will be empty for shipping promotions because shipping is not tied to any specific item.
+ {
+ "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
+ "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
+ "productId": "A String", # `orders.createtestorder`.
+ "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
+ },
+ ],
+ "funder": "A String", # Required. The party funding the promotion. Only `merchant` is supported for `orders.createtestorder`. Acceptable values are: - "`google`" - "`merchant`"
+ "startTime": "A String", # Promotion start time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
+ "type": "A String", # Required. The scope of the promotion. Only `product` is supported for `orders.createtestorder`. Acceptable values are: - "`product`" - "`shipping`"
+ "applicableItems": [ # Items that this promotion may be applied to. If empty, there are no restrictions on applicable items and quantity. This field will also be empty for shipping promotions because shipping is not tied to any specific item.
+ {
+ "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
+ "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
+ "productId": "A String", # `orders.createtestorder`.
+ "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
+ },
+ ],
+ "subtype": "A String", # Required. The category of the promotion. Only `moneyOff` is supported for `orders.createtestorder`. Acceptable values are: - "`buyMGetMoneyOff`" - "`buyMGetNMoneyOff`" - "`buyMGetNPercentOff`" - "`buyMGetPercentOff`" - "`freeGift`" - "`freeGiftWithItemId`" - "`freeGiftWithValue`" - "`freeShippingOvernight`" - "`freeShippingStandard`" - "`freeShippingTwoDay`" - "`moneyOff`" - "`percentOff`" - "`rewardPoints`" - "`salePrice`"
+ },
+ ],
+ "shippingCost": { # Required. The price of shipping for all items. Shipping tax is automatically calculated for orders where marketplace facilitator tax laws are applicable. Otherwise, tax settings from Merchant Center are applied. Note that shipping is not taxed in certain states.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "predefinedBillingAddress": "A String", # Required. The billing address. Acceptable values are: - "`dwight`" - "`jim`" - "`pam`"
+ "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#testOrder`"
+ "shippingOption": "A String", # Required. The requested shipping option. Acceptable values are: - "`economy`" - "`expedited`" - "`oneDay`" - "`sameDay`" - "`standard`" - "`twoDay`"
+ "predefinedDeliveryAddress": "A String", # Required. Identifier of one of the predefined delivery addresses for the delivery. Acceptable values are: - "`dwight`" - "`jim`" - "`pam`"
+ "lineItems": [ # Required. Line items that are ordered. At least one line item must be provided.
+ {
+ "product": { # Required. Product data from the time of the order placement.
+ "contentLanguage": "A String", # Required. The two-letter ISO 639-1 language code for the item. Acceptable values are: - "`en`" - "`fr`"
+ "mpn": "A String", # Manufacturer Part Number (MPN) of the item. Optional.
+ "title": "A String", # Required. The title of the product.
+ "price": { # Required. The price for the product. Tax is automatically calculated for orders where marketplace facilitator tax laws are applicable. Otherwise, tax settings from Merchant Center are applied.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "itemGroupId": "A String", # Shared identifier for all variants of the same product. Optional.
+ "condition": "A String", # Required. Condition or state of the item. Acceptable values are: - "`new`"
+ "variantAttributes": [ # Variant attributes for the item. Optional.
+ {
+ "dimension": "A String", # The dimension of the variant.
+ "value": "A String", # The value for the dimension.
+ },
+ ],
+ "offerId": "A String", # Required. An identifier of the item.
+ "brand": "A String", # Required. Brand of the item.
+ "gtin": "A String", # Global Trade Item Number (GTIN) of the item. Optional.
+ "imageLink": "A String", # Required. URL of an image of the item.
+ "fees": [ # Fees for the item. Optional.
+ {
+ "amount": { # Amount of the fee.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "name": "A String", # Name of the fee.
+ },
+ ],
+ "targetCountry": "A String", # Required. The CLDR territory // code of the target country of the product.
+ },
+ "quantityOrdered": 42, # Required. Number of items ordered.
+ "returnInfo": { # Required. Details of the return policy for the line item.
+ "isReturnable": True or False, # Required. Whether the item is returnable.
+ "daysToReturn": 42, # Required. How many days later the item can be returned.
+ "policyUrl": "A String", # Required. URL of the item return policy.
+ },
+ "shippingDetails": { # Required. Details of the requested shipping for the line item.
+ "shipByDate": "A String", # Required. The ship by date, in ISO 8601 format.
+ "type": "A String", # Type of shipment. Indicates whether `deliveryDetails` or `pickupDetails` is applicable for this shipment. Acceptable values are: - "`delivery`" - "`pickup`"
+ "method": { # Required. Details of the shipping method.
+ "carrier": "A String", # The carrier for the shipping. Optional. See `shipments[].carrier` for a list of acceptable values.
+ "methodName": "A String", # Required. The name of the shipping method.
+ "maxDaysInTransit": 42, # Required. Maximum transit time.
+ "minDaysInTransit": 42, # Required. Minimum transit time.
+ },
+ "deliverByDate": "A String", # Required. The delivery by date, in ISO 8601 format.
+ "pickupPromiseInMinutes": 42, # The promised time in minutes in which the order will be ready for pickup. This only applies to buy-online-pickup-in-store same-day order.
+ },
+ },
+ ],
},
- "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. Acceptable values are: - "`template1`" - "`template1a`" - "`template1b`" - "`template2`" - "`template3`"
}
x__xgafv: string, V1 error format.
@@ -472,8 +472,8 @@
{
"items": [ # Returned items.
{
- "quantity": 42, # Quantity that is returned.
"lineItemId": "A String", # The ID of the line item to return.
+ "quantity": 42, # Quantity that is returned.
},
],
}
@@ -508,54 +508,246 @@
An object of the form:
{ # Order. Production access (all methods) requires the order manager role. Sandbox access does not.
- "merchantId": "A String",
- "netPriceAmount": { # The net amount for the order (price part). For example, if an order was originally for $100 and a refund was issued for $20, the net amount will be $80.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "taxCollector": "A String", # The party responsible for collecting and remitting taxes. Acceptable values are: - "`marketplaceFacilitator`" - "`merchant`"
- "acknowledged": True or False, # Whether the order was acknowledged.
- "lineItems": [ # Line items that are ordered.
+ "paymentStatus": "A String", # The status of the payment. Acceptable values are: - "`paymentCaptured`" - "`paymentRejected`" - "`paymentSecured`" - "`pendingAuthorization`"
+ "refunds": [ # Refunds for the order.
{
- "quantityOrdered": 42, # Number of items ordered.
- "id": "A String", # The ID of the line item.
- "cancellations": [ # Cancellations of the line item.
+ "reasonText": "A String", # The explanation of the reason.
+ "actor": "A String", # The actor that created the refund. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
+ "reason": "A String", # The reason for the refund. Acceptable values are: - "`adjustment`" - "`autoPostInternal`" - "`autoPostInvalidBillingAddress`" - "`autoPostNoInventory`" - "`autoPostPriceError`" - "`autoPostUndeliverableShippingAddress`" - "`couponAbuse`" - "`courtesyAdjustment`" - "`customerCanceled`" - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`customerSupportRequested`" - "`deliveredLateByCarrier`" - "`deliveredTooLate`" - "`expiredItem`" - "`failToPushOrderGoogleError`" - "`failToPushOrderMerchantError`" - "`failToPushOrderMerchantFulfillmentError`" - "`failToPushOrderToMerchant`" - "`failToPushOrderToMerchantOutOfStock`" - "`feeAdjustment`" - "`invalidCoupon`" - "`lateShipmentCredit`" - "`malformedShippingAddress`" - "`merchantDidNotShipOnTime`" - "`noInventory`" - "`orderTimeout`" - "`other`" - "`paymentAbuse`" - "`paymentDeclined`" - "`priceAdjustment`" - "`priceError`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`promoReallocation`" - "`qualityNotAsExpected`" - "`returnRefundAbuse`" - "`shippingCostAdjustment`" - "`shippingPriceError`" - "`taxAdjustment`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`"
+ "amount": { # The amount that is refunded.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format.
+ },
+ ],
+ "shippingCost": { # The total cost of shipping for all items.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "customer": { # The details of the customer who placed the order.
+ "fullName": "A String", # Full name of the customer.
+ "invoiceReceivingEmail": "A String", # Email address for the merchant to send value-added tax or invoice documentation of the order. Only the last document sent is made available to the customer. For more information, see About automated VAT invoicing for Buy on Google.
+ "marketingRightsInfo": { # Customer's marketing preferences. Contains the marketing opt-in information that is current at the time that the merchant call. User preference selections can change from one order to the next so preferences must be checked with every order.
+ "explicitMarketingPreference": "A String", # Last known customer selection regarding marketing preferences. In certain cases this selection might not be known, so this field would be empty. If a customer selected `granted` in their most recent order, they can be subscribed to marketing emails. Customers who have chosen `denied` must not be subscribed, or must be unsubscribed if already opted-in. Acceptable values are: - "`denied`" - "`granted`"
+ "marketingEmailAddress": "A String", # Email address that can be used for marketing purposes. The field may be empty even if `explicitMarketingPreference` is 'granted'. This happens when retrieving an old order from the customer who deleted their account.
+ "lastUpdatedTimestamp": "A String", # Timestamp when last time marketing preference was updated. Could be empty, if user wasn't offered a selection yet.
+ },
+ "loyaltyInfo": { # Loyalty program information.
+ "loyaltyNumber": "A String", # The loyalty card/membership number.
+ "name": "A String", # Name of card/membership holder, this field will be populated when
+ },
+ },
+ "id": "A String", # The REST ID of the order. Globally unique.
+ "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#order`"
+ "billingAddress": { # The billing address.
+ "isPostOfficeBox": True or False, # Whether the address is a post office box.
+ "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
+ "A String",
+ ],
+ "recipientName": "A String", # Name of the recipient.
+ "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
+ "country": "A String", # CLDR country code (e.g. "US").
+ "streetAddress": [ # Street-level part of the address.
+ "A String",
+ ],
+ "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
+ "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
+ },
+ "shipments": [ # Shipments of the order.
+ {
+ "status": "A String", # The status of the shipment. Acceptable values are: - "`delivered`" - "`readyForPickup`" - "`shipped`" - "`undeliverable`"
+ "id": "A String", # The ID of the shipment.
+ "scheduledDeliveryDetails": { # Delivery details of the shipment if scheduling is needed.
+ "scheduledDate": "A String", # The date a shipment is scheduled for delivery, in ISO 8601 format.
+ "carrierPhoneNumber": "A String", # The phone number of the carrier fulfilling the delivery. The phone number is formatted as the international notation in ITU-T Recommendation E.123 (e.g., "+41 44 668 1800").
+ },
+ "creationDate": "A String", # Date on which the shipment has been created, in ISO 8601 format.
+ "carrier": "A String", # The carrier handling the shipment. For supported carriers, Google includes the carrier name and tracking URL in emails to customers. For select supported carriers, Google also automatically updates the shipment status based on the provided shipment ID. *Note:* You can also use unsupported carriers, but emails to customers will not include the carrier name or tracking URL, and there will be no automatic order status updates. Supported carriers for US are: - "`ups`" (United Parcel Service) *automatic status updates* - "`usps`" (United States Postal Service) *automatic status updates* - "`fedex`" (FedEx) *automatic status updates * - "`dhl`" (DHL eCommerce) *automatic status updates* (US only) - "`ontrac`" (OnTrac) *automatic status updates * - "`dhl express`" (DHL Express) - "`deliv`" (Deliv) - "`dynamex`" (TForce) - "`lasership`" (LaserShip) - "`mpx`" (Military Parcel Xpress) - "`uds`" (United Delivery Service) - "`efw`" (Estes Forwarding Worldwide) - "`jd logistics`" (JD Logistics) - "`yunexpress`" (YunExpress) - "`china post`" (China Post) - "`china ems`" (China Post Express Mail Service) - "`singapore post`" (Singapore Post) - "`pos malaysia`" (Pos Malaysia) - "`postnl`" (PostNL) - "`ptt`" (PTT Turkish Post) - "`eub`" (ePacket) - "`chukou1`" (Chukou1 Logistics) - "`bestex`" (Best Express) - "`canada post`" (Canada Post) - "`purolator`" (Purolator) - "`canpar`" (Canpar) - "`india post`" (India Post) - "`blue dart`" (Blue Dart) - "`delhivery`" (Delhivery) - "`dtdc`" (DTDC) - "`tpc india`" (TPC India) Supported carriers for FR are: - "`la poste`" (La Poste) *automatic status updates * - "`colissimo`" (Colissimo by La Poste) *automatic status updates* - "`ups`" (United Parcel Service) *automatic status updates * - "`chronopost`" (Chronopost by La Poste) - "`gls`" (General Logistics Systems France) - "`dpd`" (DPD Group by GeoPost) - "`bpost`" (Belgian Post Group) - "`colis prive`" (Colis Privé) - "`boxtal`" (Boxtal) - "`geodis`" (GEODIS) - "`tnt`" (TNT) - "`db schenker`" (DB Schenker) - "`aramex`" (Aramex)
+ "deliveryDate": "A String", # Date on which the shipment has been delivered, in ISO 8601 format. Present only if `status` is `delivered`
+ "lineItems": [ # The line items that are shipped.
{
- "reason": "A String", # The reason for the cancellation. Orders that are canceled with a noInventory reason will lead to the removal of the product from Buy on Google until you make an update to that product. This will not affect your Shopping ads. Acceptable values are: - "`autoPostInternal`" - "`autoPostInvalidBillingAddress`" - "`autoPostNoInventory`" - "`autoPostPriceError`" - "`autoPostUndeliverableShippingAddress`" - "`couponAbuse`" - "`customerCanceled`" - "`customerInitiatedCancel`" - "`customerSupportRequested`" - "`failToPushOrderGoogleError`" - "`failToPushOrderMerchantError`" - "`failToPushOrderMerchantFulfillmentError`" - "`failToPushOrderToMerchant`" - "`failToPushOrderToMerchantOutOfStock`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`merchantDidNotShipOnTime`" - "`noInventory`" - "`orderTimeout`" - "`other`" - "`paymentAbuse`" - "`paymentDeclined`" - "`priceError`" - "`returnRefundAbuse`" - "`shippingPriceError`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`"
- "actor": "A String", # The actor that created the cancellation. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
- "quantity": 42, # The quantity that was canceled.
- "reasonText": "A String", # The explanation of the reason.
- "creationDate": "A String", # Date on which the cancellation has been created, in ISO 8601 format.
+ "productId": "A String", # The ID of the product to ship. This is the REST ID used in the products service. Either lineItemId or productId is required.
+ "lineItemId": "A String", # The ID of the line item that is shipped. This value is assigned by Google when an order is created. Either lineItemId or productId is required.
+ "quantity": 42, # The quantity that is shipped.
},
],
+ "shipmentGroupId": "A String", # The shipment group ID of the shipment. This is set in shiplineitems request.
+ "trackingId": "A String", # The tracking ID for the shipment.
+ },
+ ],
+ "merchantOrderId": "A String", # Merchant-provided ID of the order.
+ "deliveryDetails": { # Delivery details for shipments of type `delivery`.
+ "phoneNumber": "A String", # The phone number of the person receiving the delivery.
+ "address": { # The delivery address
+ "isPostOfficeBox": True or False, # Whether the address is a post office box.
+ "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
+ "A String",
+ ],
+ "recipientName": "A String", # Name of the recipient.
+ "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
+ "country": "A String", # CLDR country code (e.g. "US").
+ "streetAddress": [ # Street-level part of the address.
+ "A String",
+ ],
+ "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
+ "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
+ },
+ },
+ "netPriceAmount": { # The net amount for the order (price part). For example, if an order was originally for $100 and a refund was issued for $20, the net amount will be $80.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "annotations": [ # List of key-value pairs that are attached to a given order.
+ {
+ "value": "A String", # Value for additional google provided (as key-value pairs) annotation.
+ "key": "A String", # Key for additional google provided (as key-value pairs) annotation.
+ },
+ ],
+ "status": "A String", # The status of the order. Acceptable values are: - "`canceled`" - "`delivered`" - "`inProgress`" - "`partiallyDelivered`" - "`partiallyReturned`" - "`partiallyShipped`" - "`pendingShipment`" - "`returned`" - "`shipped`"
+ "pickupDetails": { # Pickup details for shipments of type `pickup`.
+ "address": { # Address of the pickup location where the shipment should be sent. Note that `recipientName` in the address is the name of the business at the pickup location.
+ "isPostOfficeBox": True or False, # Whether the address is a post office box.
+ "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
+ "A String",
+ ],
+ "recipientName": "A String", # Name of the recipient.
+ "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
+ "country": "A String", # CLDR country code (e.g. "US").
+ "streetAddress": [ # Street-level part of the address.
+ "A String",
+ ],
+ "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
+ "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
+ },
+ "pickupType": "A String", # The pickup type of this order. Acceptable values are: - "`merchantStore`" - "`merchantStoreCurbside`" - "`merchantStoreLocker`" - "`thirdPartyPickupPoint`" - "`thirdPartyLocker`"
+ "locationId": "A String", # ID of the pickup location.
+ "collectors": [ # Collectors authorized to pick up shipment from the pickup location.
+ {
+ "phoneNumber": "A String", # Phone number of the person picking up the shipment.
+ "name": "A String", # Name of the person picking up the shipment.
+ },
+ ],
+ },
+ "promotions": [ # Promotions associated with the order. To determine which promotions apply to which products, check the `Promotions[].appliedItems[].lineItemId` field against the `LineItems[].id` field for each promotion. If a promotion is applied to more than 1 offerId, divide the discount value by the number of affected offers to determine how much discount to apply to each offerId. Examples: 1. To calculate price paid by the customer for a single line item including the discount: For each promotion, subtract the `LineItems[].adjustments[].priceAdjustment.value` amount from the `LineItems[].Price.value`. 2. To calculate price paid by the customer for a single line item including the discount in case of multiple quantity: For each promotion, divide the `LineItems[].adjustments[].priceAdjustment.value` by the quantity of products then subtract the resulting value from the `LineItems[].Product.Price.value` for each quantity item. Only 1 promotion can be applied to an offerId in a given order. To refund an item which had a promotion applied to it, make sure to refund the amount after first subtracting the promotion discount from the item price. More details about the program are here.
+ {
+ "priceValue": { # Estimated discount applied to price. Amount is pre-tax or post-tax depending on location of order.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "shortTitle": "A String", # A short title of the promotion to be shown on the checkout page. Do not provide for `orders.createtestorder`.
+ "endTime": "A String", # Promotion end time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
+ "taxValue": { # Estimated discount applied to tax (if allowed by law). Do not provide for `orders.createtestorder`.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "title": "A String", # Required. The title of the promotion.
+ "merchantPromotionId": "A String", # Required. This field is used to identify promotions within merchants' own systems.
+ "appliedItems": [ # Items that this promotion have been applied to. Do not provide for `orders.createtestorder`. This field will be empty for shipping promotions because shipping is not tied to any specific item.
+ {
+ "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
+ "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
+ "productId": "A String", # `orders.createtestorder`.
+ "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
+ },
+ ],
+ "funder": "A String", # Required. The party funding the promotion. Only `merchant` is supported for `orders.createtestorder`. Acceptable values are: - "`google`" - "`merchant`"
+ "startTime": "A String", # Promotion start time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
+ "type": "A String", # Required. The scope of the promotion. Only `product` is supported for `orders.createtestorder`. Acceptable values are: - "`product`" - "`shipping`"
+ "applicableItems": [ # Items that this promotion may be applied to. If empty, there are no restrictions on applicable items and quantity. This field will also be empty for shipping promotions because shipping is not tied to any specific item.
+ {
+ "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
+ "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
+ "productId": "A String", # `orders.createtestorder`.
+ "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
+ },
+ ],
+ "subtype": "A String", # Required. The category of the promotion. Only `moneyOff` is supported for `orders.createtestorder`. Acceptable values are: - "`buyMGetMoneyOff`" - "`buyMGetNMoneyOff`" - "`buyMGetNPercentOff`" - "`buyMGetPercentOff`" - "`freeGift`" - "`freeGiftWithItemId`" - "`freeGiftWithValue`" - "`freeShippingOvernight`" - "`freeShippingStandard`" - "`freeShippingTwoDay`" - "`moneyOff`" - "`percentOff`" - "`rewardPoints`" - "`salePrice`"
+ },
+ ],
+ "netTaxAmount": { # The net amount for the order (tax part). Note that in certain cases due to taxable base adjustment `netTaxAmount` might not match to a sum of tax field across all lineItems and refunds.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "placedDate": "A String", # The date when the order was placed, in ISO 8601 format.
+ "merchantId": "A String",
+ "lineItems": [ # Line items that are ordered.
+ {
+ "adjustments": [ # Price and tax adjustments applied on the line item.
+ {
+ "priceAdjustment": { # Adjustment for total price of the line item.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "type": "A String", # Type of this adjustment. Acceptable values are: - "`promotion`"
+ "taxAdjustment": { # Adjustment for total tax of the line item.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ },
+ ],
+ "quantityPending": 42, # Number of items pending.
+ "cancellations": [ # Cancellations of the line item.
+ {
+ "actor": "A String", # The actor that created the cancellation. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
+ "creationDate": "A String", # Date on which the cancellation has been created, in ISO 8601 format.
+ "reasonText": "A String", # The explanation of the reason.
+ "quantity": 42, # The quantity that was canceled.
+ "reason": "A String", # The reason for the cancellation. Orders that are canceled with a noInventory reason will lead to the removal of the product from Buy on Google until you make an update to that product. This will not affect your Shopping ads. Acceptable values are: - "`autoPostInternal`" - "`autoPostInvalidBillingAddress`" - "`autoPostNoInventory`" - "`autoPostPriceError`" - "`autoPostUndeliverableShippingAddress`" - "`couponAbuse`" - "`customerCanceled`" - "`customerInitiatedCancel`" - "`customerSupportRequested`" - "`failToPushOrderGoogleError`" - "`failToPushOrderMerchantError`" - "`failToPushOrderMerchantFulfillmentError`" - "`failToPushOrderToMerchant`" - "`failToPushOrderToMerchantOutOfStock`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`merchantDidNotShipOnTime`" - "`noInventory`" - "`orderTimeout`" - "`other`" - "`paymentAbuse`" - "`paymentDeclined`" - "`priceError`" - "`returnRefundAbuse`" - "`shippingPriceError`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`"
+ },
+ ],
+ "price": { # Total price for the line item. For example, if two items for $10 are purchased, the total price will be $20.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "returnInfo": { # Details of the return policy for the line item.
+ "isReturnable": True or False, # Required. Whether the item is returnable.
+ "daysToReturn": 42, # Required. How many days later the item can be returned.
+ "policyUrl": "A String", # Required. URL of the item return policy.
+ },
+ "quantityUndeliverable": 42, # Number of items undeliverable.
+ "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.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "quantityReturned": 42, # Number of items returned.
+ "quantityShipped": 42, # Number of items shipped.
+ "quantityReadyForPickup": 42, # Number of items ready for pickup.
+ "quantityOrdered": 42, # Number of items ordered.
"annotations": [ # Annotations that are attached to the line item.
{
"value": "A String", # Value for additional merchant provided (as key-value pairs) annotation about the line item.
"key": "A String", # Key for additional merchant provided (as key-value pairs) annotation about the line item.
},
],
- "quantityDelivered": 42, # Number of items delivered.
- "quantityUndeliverable": 42, # Number of items undeliverable.
"quantityCanceled": 42, # Number of items canceled.
- "quantityShipped": 42, # Number of items shipped.
- "returns": [ # Returns of the line item.
- {
- "reason": "A String", # The reason for the return. Acceptable values are: - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`deliveredTooLate`" - "`expiredItem`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`other`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`qualityNotAsExpected`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`"
- "actor": "A String", # The actor that created the refund. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
- "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format.
- "reasonText": "A String", # The explanation of the reason.
- "quantity": 42, # Quantity that is returned.
+ "shippingDetails": { # Details of the requested shipping for the line item.
+ "shipByDate": "A String", # Required. The ship by date, in ISO 8601 format.
+ "type": "A String", # Type of shipment. Indicates whether `deliveryDetails` or `pickupDetails` is applicable for this shipment. Acceptable values are: - "`delivery`" - "`pickup`"
+ "method": { # Required. Details of the shipping method.
+ "carrier": "A String", # The carrier for the shipping. Optional. See `shipments[].carrier` for a list of acceptable values.
+ "methodName": "A String", # Required. The name of the shipping method.
+ "maxDaysInTransit": 42, # Required. Maximum transit time.
+ "minDaysInTransit": 42, # Required. Minimum transit time.
},
- ],
- "quantityReadyForPickup": 42, # Number of items ready for pickup.
- "price": { # Total price for the line item. For example, if two items for $10 are purchased, the total price will be $20.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
+ "deliverByDate": "A String", # Required. The delivery by date, in ISO 8601 format.
+ "pickupPromiseInMinutes": 42, # The promised time in minutes in which the order will be ready for pickup. This only applies to buy-online-pickup-in-store same-day order.
},
- "quantityPending": 42, # Number of items pending.
"product": { # Product data as seen by customer from the time of the order placement. Note that certain attributes values (e.g. title or gtin) might be reformatted and no longer match values submitted via product feed.
- "id": "A String", # The REST ID of the product.
+ "shownImage": "A String", # URL to the cached image shown to the user when order was placed.
+ "mpn": "A String", # Manufacturer Part Number (MPN) of the item.
"targetCountry": "A String", # The CLDR territory // code of the target country of the product.
+ "gtin": "A String", # Global Trade Item Number (GTIN) of the item.
+ "itemGroupId": "A String", # Shared identifier for all variants of the same product.
+ "offerId": "A String", # An identifier of the item.
+ "condition": "A String", # Condition or state of the item. Acceptable values are: - "`new`" - "`refurbished`" - "`used`"
+ "contentLanguage": "A String", # The two-letter ISO 639-1 language code for the item.
+ "price": { # Price of the item.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "id": "A String", # The REST ID of the product.
+ "brand": "A String", # Brand of the item.
"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.
{
"dimension": "A String", # The dimension of the variant.
@@ -565,226 +757,34 @@
"fees": [ # Associated fees at order creation time.
{
"amount": { # Amount of the fee.
- "value": "A String", # The price represented as a number.
"currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
},
"name": "A String", # Name of the fee.
},
],
"imageLink": "A String", # URL of an image of the item.
"title": "A String", # The title of the product.
- "shownImage": "A String", # URL to the cached image shown to the user when order was placed.
- "price": { # Price of the item.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "condition": "A String", # Condition or state of the item. Acceptable values are: - "`new`" - "`refurbished`" - "`used`"
- "gtin": "A String", # Global Trade Item Number (GTIN) of the item.
- "itemGroupId": "A String", # Shared identifier for all variants of the same product.
- "contentLanguage": "A String", # The two-letter ISO 639-1 language code for the item.
- "offerId": "A String", # An identifier of the item.
- "brand": "A String", # Brand of the item.
- "mpn": "A String", # Manufacturer Part Number (MPN) of the item.
},
- "returnInfo": { # Details of the return policy for the line item.
- "daysToReturn": 42, # Required. How many days later the item can be returned.
- "isReturnable": True or False, # Required. Whether the item is returnable.
- "policyUrl": "A String", # Required. URL of the item return policy.
- },
- "adjustments": [ # Price and tax adjustments applied on the line item.
+ "returns": [ # Returns of the line item.
{
- "priceAdjustment": { # Adjustment for total price of the line item.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "taxAdjustment": { # Adjustment for total tax of the line item.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "type": "A String", # Type of this adjustment. Acceptable values are: - "`promotion`"
+ "reasonText": "A String", # The explanation of the reason.
+ "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format.
+ "quantity": 42, # Quantity that is returned.
+ "actor": "A String", # The actor that created the refund. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
+ "reason": "A String", # The reason for the return. Acceptable values are: - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`deliveredTooLate`" - "`expiredItem`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`other`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`qualityNotAsExpected`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`"
},
],
- "shippingDetails": { # Details of the requested shipping for the line item.
- "shipByDate": "A String", # Required. The ship by date, in ISO 8601 format.
- "deliverByDate": "A String", # Required. The delivery by date, in ISO 8601 format.
- "type": "A String", # Type of shipment. Indicates whether `deliveryDetails` or `pickupDetails` is applicable for this shipment. Acceptable values are: - "`delivery`" - "`pickup`"
- "method": { # Required. Details of the shipping method.
- "carrier": "A String", # The carrier for the shipping. Optional. See `shipments[].carrier` for a list of acceptable values.
- "methodName": "A String", # Required. The name of the shipping method.
- "minDaysInTransit": 42, # Required. Minimum transit time.
- "maxDaysInTransit": 42, # Required. Maximum transit time.
- },
- "pickupPromiseInMinutes": 42, # The promised time in minutes in which the order will be ready for pickup. This only applies to buy-online-pickup-in-store same-day order.
- },
- "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.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "quantityReturned": 42, # Number of items returned.
+ "quantityDelivered": 42, # Number of items delivered.
+ "id": "A String", # The ID of the line item.
},
],
- "promotions": [ # Promotions associated with the order. To determine which promotions apply to which products, check the `Promotions[].appliedItems[].lineItemId` field against the `LineItems[].id` field for each promotion. If a promotion is applied to more than 1 offerId, divide the discount value by the number of affected offers to determine how much discount to apply to each offerId. Examples: 1. To calculate price paid by the customer for a single line item including the discount: For each promotion, subtract the `LineItems[].adjustments[].priceAdjustment.value` amount from the `LineItems[].Price.value`. 2. To calculate price paid by the customer for a single line item including the discount in case of multiple quantity: For each promotion, divide the `LineItems[].adjustments[].priceAdjustment.value` by the quantity of products then subtract the resulting value from the `LineItems[].Product.Price.value` for each quantity item. Only 1 promotion can be applied to an offerId in a given order. To refund an item which had a promotion applied to it, make sure to refund the amount after first subtracting the promotion discount from the item price. More details about the program are here.
- {
- "appliedItems": [ # Items that this promotion have been applied to. Do not provide for `orders.createtestorder`. This field will be empty for shipping promotions because shipping is not tied to any specific item.
- {
- "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
- "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
- "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
- "productId": "A String", # `orders.createtestorder`.
- },
- ],
- "funder": "A String", # Required. The party funding the promotion. Only `merchant` is supported for `orders.createtestorder`. Acceptable values are: - "`google`" - "`merchant`"
- "subtype": "A String", # Required. The category of the promotion. Only `moneyOff` is supported for `orders.createtestorder`. Acceptable values are: - "`buyMGetMoneyOff`" - "`buyMGetNMoneyOff`" - "`buyMGetNPercentOff`" - "`buyMGetPercentOff`" - "`freeGift`" - "`freeGiftWithItemId`" - "`freeGiftWithValue`" - "`freeShippingOvernight`" - "`freeShippingStandard`" - "`freeShippingTwoDay`" - "`moneyOff`" - "`percentOff`" - "`rewardPoints`" - "`salePrice`"
- "type": "A String", # Required. The scope of the promotion. Only `product` is supported for `orders.createtestorder`. Acceptable values are: - "`product`" - "`shipping`"
- "endTime": "A String", # Promotion end time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
- "startTime": "A String", # Promotion start time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
- "shortTitle": "A String", # A short title of the promotion to be shown on the checkout page. Do not provide for `orders.createtestorder`.
- "taxValue": { # Estimated discount applied to tax (if allowed by law). Do not provide for `orders.createtestorder`.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "title": "A String", # Required. The title of the promotion.
- "merchantPromotionId": "A String", # Required. This field is used to identify promotions within merchants' own systems.
- "priceValue": { # Estimated discount applied to price. Amount is pre-tax or post-tax depending on location of order.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "applicableItems": [ # Items that this promotion may be applied to. If empty, there are no restrictions on applicable items and quantity. This field will also be empty for shipping promotions because shipping is not tied to any specific item.
- {
- "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
- "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
- "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
- "productId": "A String", # `orders.createtestorder`.
- },
- ],
- },
- ],
- "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#order`"
- "netTaxAmount": { # The net amount for the order (tax part). Note that in certain cases due to taxable base adjustment `netTaxAmount` might not match to a sum of tax field across all lineItems and refunds.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "annotations": [ # List of key-value pairs that are attached to a given order.
- {
- "value": "A String", # Value for additional google provided (as key-value pairs) annotation.
- "key": "A String", # Key for additional google provided (as key-value pairs) annotation.
- },
- ],
- "placedDate": "A String", # The date when the order was placed, in ISO 8601 format.
- "shipments": [ # Shipments of the order.
- {
- "creationDate": "A String", # Date on which the shipment has been created, in ISO 8601 format.
- "scheduledDeliveryDetails": { # Delivery details of the shipment if scheduling is needed.
- "scheduledDate": "A String", # The date a shipment is scheduled for delivery, in ISO 8601 format.
- "carrierPhoneNumber": "A String", # The phone number of the carrier fulfilling the delivery. The phone number is formatted as the international notation in ITU-T Recommendation E.123 (e.g., "+41 44 668 1800").
- },
- "id": "A String", # The ID of the shipment.
- "lineItems": [ # The line items that are shipped.
- {
- "quantity": 42, # The quantity that is shipped.
- "lineItemId": "A String", # The ID of the line item that is shipped. This value is assigned by Google when an order is created. Either lineItemId or productId is required.
- "productId": "A String", # The ID of the product to ship. This is the REST ID used in the products service. Either lineItemId or productId is required.
- },
- ],
- "trackingId": "A String", # The tracking ID for the shipment.
- "carrier": "A String", # The carrier handling the shipment. For supported carriers, Google includes the carrier name and tracking URL in emails to customers. For select supported carriers, Google also automatically updates the shipment status based on the provided shipment ID. *Note:* You can also use unsupported carriers, but emails to customers will not include the carrier name or tracking URL, and there will be no automatic order status updates. Supported carriers for US are: - "`ups`" (United Parcel Service) *automatic status updates* - "`usps`" (United States Postal Service) *automatic status updates* - "`fedex`" (FedEx) *automatic status updates * - "`dhl`" (DHL eCommerce) *automatic status updates* (US only) - "`ontrac`" (OnTrac) *automatic status updates * - "`dhl express`" (DHL Express) - "`deliv`" (Deliv) - "`dynamex`" (TForce) - "`lasership`" (LaserShip) - "`mpx`" (Military Parcel Xpress) - "`uds`" (United Delivery Service) - "`efw`" (Estes Forwarding Worldwide) - "`jd logistics`" (JD Logistics) - "`yunexpress`" (YunExpress) - "`china post`" (China Post) - "`china ems`" (China Post Express Mail Service) - "`singapore post`" (Singapore Post) - "`pos malaysia`" (Pos Malaysia) - "`postnl`" (PostNL) - "`ptt`" (PTT Turkish Post) - "`eub`" (ePacket) - "`chukou1`" (Chukou1 Logistics) - "`bestex`" (Best Express) - "`canada post`" (Canada Post) - "`purolator`" (Purolator) - "`canpar`" (Canpar) - "`india post`" (India Post) - "`blue dart`" (Blue Dart) - "`delhivery`" (Delhivery) - "`dtdc`" (DTDC) - "`tpc india`" (TPC India) Supported carriers for FR are: - "`la poste`" (La Poste) *automatic status updates * - "`colissimo`" (Colissimo by La Poste) *automatic status updates* - "`ups`" (United Parcel Service) *automatic status updates * - "`chronopost`" (Chronopost by La Poste) - "`gls`" (General Logistics Systems France) - "`dpd`" (DPD Group by GeoPost) - "`bpost`" (Belgian Post Group) - "`colis prive`" (Colis Privé) - "`boxtal`" (Boxtal) - "`geodis`" (GEODIS) - "`tnt`" (TNT) - "`db schenker`" (DB Schenker) - "`aramex`" (Aramex)
- "deliveryDate": "A String", # Date on which the shipment has been delivered, in ISO 8601 format. Present only if `status` is `delivered`
- "shipmentGroupId": "A String", # The shipment group ID of the shipment. This is set in shiplineitems request.
- "status": "A String", # The status of the shipment. Acceptable values are: - "`delivered`" - "`readyForPickup`" - "`shipped`" - "`undeliverable`"
- },
- ],
- "id": "A String", # The REST ID of the order. Globally unique.
- "refunds": [ # Refunds for the order.
- {
- "amount": { # The amount that is refunded.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "actor": "A String", # The actor that created the refund. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
- "reasonText": "A String", # The explanation of the reason.
- "reason": "A String", # The reason for the refund. Acceptable values are: - "`adjustment`" - "`autoPostInternal`" - "`autoPostInvalidBillingAddress`" - "`autoPostNoInventory`" - "`autoPostPriceError`" - "`autoPostUndeliverableShippingAddress`" - "`couponAbuse`" - "`courtesyAdjustment`" - "`customerCanceled`" - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`customerSupportRequested`" - "`deliveredLateByCarrier`" - "`deliveredTooLate`" - "`expiredItem`" - "`failToPushOrderGoogleError`" - "`failToPushOrderMerchantError`" - "`failToPushOrderMerchantFulfillmentError`" - "`failToPushOrderToMerchant`" - "`failToPushOrderToMerchantOutOfStock`" - "`feeAdjustment`" - "`invalidCoupon`" - "`lateShipmentCredit`" - "`malformedShippingAddress`" - "`merchantDidNotShipOnTime`" - "`noInventory`" - "`orderTimeout`" - "`other`" - "`paymentAbuse`" - "`paymentDeclined`" - "`priceAdjustment`" - "`priceError`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`promoReallocation`" - "`qualityNotAsExpected`" - "`returnRefundAbuse`" - "`shippingCostAdjustment`" - "`shippingPriceError`" - "`taxAdjustment`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`"
- "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format.
- },
- ],
- "status": "A String", # The status of the order. Acceptable values are: - "`canceled`" - "`delivered`" - "`inProgress`" - "`partiallyDelivered`" - "`partiallyReturned`" - "`partiallyShipped`" - "`pendingShipment`" - "`returned`" - "`shipped`"
- "merchantOrderId": "A String", # Merchant-provided ID of the order.
- "deliveryDetails": { # Delivery details for shipments of type `delivery`.
- "address": { # The delivery address
- "recipientName": "A String", # Name of the recipient.
- "country": "A String", # CLDR country code (e.g. "US").
- "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
- "isPostOfficeBox": True or False, # Whether the address is a post office box.
- "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
- "A String",
- ],
- "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
- "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
- "streetAddress": [ # Street-level part of the address.
- "A String",
- ],
- },
- "phoneNumber": "A String", # The phone number of the person receiving the delivery.
- },
"shippingCostTax": { # The tax for the total shipping cost.
- "value": "A String", # The price represented as a number.
"currency": "A String", # The currency of the price.
- },
- "paymentStatus": "A String", # The status of the payment. Acceptable values are: - "`paymentCaptured`" - "`paymentRejected`" - "`paymentSecured`" - "`pendingAuthorization`"
- "customer": { # The details of the customer who placed the order.
- "loyaltyInfo": { # Loyalty program information.
- "loyaltyNumber": "A String", # The loyalty card/membership number.
- "name": "A String", # Name of card/membership holder, this field will be populated when
- },
- "fullName": "A String", # Full name of the customer.
- "invoiceReceivingEmail": "A String", # Email address for the merchant to send value-added tax or invoice documentation of the order. Only the last document sent is made available to the customer. For more information, see About automated VAT invoicing for Buy on Google.
- "marketingRightsInfo": { # Customer's marketing preferences. Contains the marketing opt-in information that is current at the time that the merchant call. User preference selections can change from one order to the next so preferences must be checked with every order.
- "lastUpdatedTimestamp": "A String", # Timestamp when last time marketing preference was updated. Could be empty, if user wasn't offered a selection yet.
- "explicitMarketingPreference": "A String", # Last known customer selection regarding marketing preferences. In certain cases this selection might not be known, so this field would be empty. If a customer selected `granted` in their most recent order, they can be subscribed to marketing emails. Customers who have chosen `denied` must not be subscribed, or must be unsubscribed if already opted-in. Acceptable values are: - "`denied`" - "`granted`"
- "marketingEmailAddress": "A String", # Email address that can be used for marketing purposes. The field may be empty even if `explicitMarketingPreference` is 'granted'. This happens when retrieving an old order from the customer who deleted their account.
- },
- },
- "shippingCost": { # The total cost of shipping for all items.
"value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
},
- "pickupDetails": { # Pickup details for shipments of type `pickup`.
- "address": { # Address of the pickup location where the shipment should be sent. Note that `recipientName` in the address is the name of the business at the pickup location.
- "recipientName": "A String", # Name of the recipient.
- "country": "A String", # CLDR country code (e.g. "US").
- "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
- "isPostOfficeBox": True or False, # Whether the address is a post office box.
- "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
- "A String",
- ],
- "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
- "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
- "streetAddress": [ # Street-level part of the address.
- "A String",
- ],
- },
- "locationId": "A String", # ID of the pickup location.
- "pickupType": "A String", # The pickup type of this order. Acceptable values are: - "`merchantStore`" - "`merchantStoreCurbside`" - "`merchantStoreLocker`" - "`thirdPartyPickupPoint`" - "`thirdPartyLocker`"
- "collectors": [ # Collectors authorized to pick up shipment from the pickup location.
- {
- "phoneNumber": "A String", # Phone number of the person picking up the shipment.
- "name": "A String", # Name of the person picking up the shipment.
- },
- ],
- },
- "billingAddress": { # The billing address.
- "recipientName": "A String", # Name of the recipient.
- "country": "A String", # CLDR country code (e.g. "US").
- "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
- "isPostOfficeBox": True or False, # Whether the address is a post office box.
- "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
- "A String",
- ],
- "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
- "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
- "streetAddress": [ # Street-level part of the address.
- "A String",
- ],
- },
+ "taxCollector": "A String", # The party responsible for collecting and remitting taxes. Acceptable values are: - "`marketplaceFacilitator`" - "`merchant`"
+ "acknowledged": True or False, # Whether the order was acknowledged.
}</pre>
</div>
@@ -805,54 +805,246 @@
{
"order": { # Order. Production access (all methods) requires the order manager role. Sandbox access does not. # The requested order.
- "merchantId": "A String",
- "netPriceAmount": { # The net amount for the order (price part). For example, if an order was originally for $100 and a refund was issued for $20, the net amount will be $80.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "taxCollector": "A String", # The party responsible for collecting and remitting taxes. Acceptable values are: - "`marketplaceFacilitator`" - "`merchant`"
- "acknowledged": True or False, # Whether the order was acknowledged.
- "lineItems": [ # Line items that are ordered.
+ "paymentStatus": "A String", # The status of the payment. Acceptable values are: - "`paymentCaptured`" - "`paymentRejected`" - "`paymentSecured`" - "`pendingAuthorization`"
+ "refunds": [ # Refunds for the order.
{
- "quantityOrdered": 42, # Number of items ordered.
- "id": "A String", # The ID of the line item.
- "cancellations": [ # Cancellations of the line item.
+ "reasonText": "A String", # The explanation of the reason.
+ "actor": "A String", # The actor that created the refund. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
+ "reason": "A String", # The reason for the refund. Acceptable values are: - "`adjustment`" - "`autoPostInternal`" - "`autoPostInvalidBillingAddress`" - "`autoPostNoInventory`" - "`autoPostPriceError`" - "`autoPostUndeliverableShippingAddress`" - "`couponAbuse`" - "`courtesyAdjustment`" - "`customerCanceled`" - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`customerSupportRequested`" - "`deliveredLateByCarrier`" - "`deliveredTooLate`" - "`expiredItem`" - "`failToPushOrderGoogleError`" - "`failToPushOrderMerchantError`" - "`failToPushOrderMerchantFulfillmentError`" - "`failToPushOrderToMerchant`" - "`failToPushOrderToMerchantOutOfStock`" - "`feeAdjustment`" - "`invalidCoupon`" - "`lateShipmentCredit`" - "`malformedShippingAddress`" - "`merchantDidNotShipOnTime`" - "`noInventory`" - "`orderTimeout`" - "`other`" - "`paymentAbuse`" - "`paymentDeclined`" - "`priceAdjustment`" - "`priceError`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`promoReallocation`" - "`qualityNotAsExpected`" - "`returnRefundAbuse`" - "`shippingCostAdjustment`" - "`shippingPriceError`" - "`taxAdjustment`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`"
+ "amount": { # The amount that is refunded.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format.
+ },
+ ],
+ "shippingCost": { # The total cost of shipping for all items.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "customer": { # The details of the customer who placed the order.
+ "fullName": "A String", # Full name of the customer.
+ "invoiceReceivingEmail": "A String", # Email address for the merchant to send value-added tax or invoice documentation of the order. Only the last document sent is made available to the customer. For more information, see About automated VAT invoicing for Buy on Google.
+ "marketingRightsInfo": { # Customer's marketing preferences. Contains the marketing opt-in information that is current at the time that the merchant call. User preference selections can change from one order to the next so preferences must be checked with every order.
+ "explicitMarketingPreference": "A String", # Last known customer selection regarding marketing preferences. In certain cases this selection might not be known, so this field would be empty. If a customer selected `granted` in their most recent order, they can be subscribed to marketing emails. Customers who have chosen `denied` must not be subscribed, or must be unsubscribed if already opted-in. Acceptable values are: - "`denied`" - "`granted`"
+ "marketingEmailAddress": "A String", # Email address that can be used for marketing purposes. The field may be empty even if `explicitMarketingPreference` is 'granted'. This happens when retrieving an old order from the customer who deleted their account.
+ "lastUpdatedTimestamp": "A String", # Timestamp when last time marketing preference was updated. Could be empty, if user wasn't offered a selection yet.
+ },
+ "loyaltyInfo": { # Loyalty program information.
+ "loyaltyNumber": "A String", # The loyalty card/membership number.
+ "name": "A String", # Name of card/membership holder, this field will be populated when
+ },
+ },
+ "id": "A String", # The REST ID of the order. Globally unique.
+ "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#order`"
+ "billingAddress": { # The billing address.
+ "isPostOfficeBox": True or False, # Whether the address is a post office box.
+ "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
+ "A String",
+ ],
+ "recipientName": "A String", # Name of the recipient.
+ "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
+ "country": "A String", # CLDR country code (e.g. "US").
+ "streetAddress": [ # Street-level part of the address.
+ "A String",
+ ],
+ "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
+ "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
+ },
+ "shipments": [ # Shipments of the order.
+ {
+ "status": "A String", # The status of the shipment. Acceptable values are: - "`delivered`" - "`readyForPickup`" - "`shipped`" - "`undeliverable`"
+ "id": "A String", # The ID of the shipment.
+ "scheduledDeliveryDetails": { # Delivery details of the shipment if scheduling is needed.
+ "scheduledDate": "A String", # The date a shipment is scheduled for delivery, in ISO 8601 format.
+ "carrierPhoneNumber": "A String", # The phone number of the carrier fulfilling the delivery. The phone number is formatted as the international notation in ITU-T Recommendation E.123 (e.g., "+41 44 668 1800").
+ },
+ "creationDate": "A String", # Date on which the shipment has been created, in ISO 8601 format.
+ "carrier": "A String", # The carrier handling the shipment. For supported carriers, Google includes the carrier name and tracking URL in emails to customers. For select supported carriers, Google also automatically updates the shipment status based on the provided shipment ID. *Note:* You can also use unsupported carriers, but emails to customers will not include the carrier name or tracking URL, and there will be no automatic order status updates. Supported carriers for US are: - "`ups`" (United Parcel Service) *automatic status updates* - "`usps`" (United States Postal Service) *automatic status updates* - "`fedex`" (FedEx) *automatic status updates * - "`dhl`" (DHL eCommerce) *automatic status updates* (US only) - "`ontrac`" (OnTrac) *automatic status updates * - "`dhl express`" (DHL Express) - "`deliv`" (Deliv) - "`dynamex`" (TForce) - "`lasership`" (LaserShip) - "`mpx`" (Military Parcel Xpress) - "`uds`" (United Delivery Service) - "`efw`" (Estes Forwarding Worldwide) - "`jd logistics`" (JD Logistics) - "`yunexpress`" (YunExpress) - "`china post`" (China Post) - "`china ems`" (China Post Express Mail Service) - "`singapore post`" (Singapore Post) - "`pos malaysia`" (Pos Malaysia) - "`postnl`" (PostNL) - "`ptt`" (PTT Turkish Post) - "`eub`" (ePacket) - "`chukou1`" (Chukou1 Logistics) - "`bestex`" (Best Express) - "`canada post`" (Canada Post) - "`purolator`" (Purolator) - "`canpar`" (Canpar) - "`india post`" (India Post) - "`blue dart`" (Blue Dart) - "`delhivery`" (Delhivery) - "`dtdc`" (DTDC) - "`tpc india`" (TPC India) Supported carriers for FR are: - "`la poste`" (La Poste) *automatic status updates * - "`colissimo`" (Colissimo by La Poste) *automatic status updates* - "`ups`" (United Parcel Service) *automatic status updates * - "`chronopost`" (Chronopost by La Poste) - "`gls`" (General Logistics Systems France) - "`dpd`" (DPD Group by GeoPost) - "`bpost`" (Belgian Post Group) - "`colis prive`" (Colis Privé) - "`boxtal`" (Boxtal) - "`geodis`" (GEODIS) - "`tnt`" (TNT) - "`db schenker`" (DB Schenker) - "`aramex`" (Aramex)
+ "deliveryDate": "A String", # Date on which the shipment has been delivered, in ISO 8601 format. Present only if `status` is `delivered`
+ "lineItems": [ # The line items that are shipped.
{
- "reason": "A String", # The reason for the cancellation. Orders that are canceled with a noInventory reason will lead to the removal of the product from Buy on Google until you make an update to that product. This will not affect your Shopping ads. Acceptable values are: - "`autoPostInternal`" - "`autoPostInvalidBillingAddress`" - "`autoPostNoInventory`" - "`autoPostPriceError`" - "`autoPostUndeliverableShippingAddress`" - "`couponAbuse`" - "`customerCanceled`" - "`customerInitiatedCancel`" - "`customerSupportRequested`" - "`failToPushOrderGoogleError`" - "`failToPushOrderMerchantError`" - "`failToPushOrderMerchantFulfillmentError`" - "`failToPushOrderToMerchant`" - "`failToPushOrderToMerchantOutOfStock`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`merchantDidNotShipOnTime`" - "`noInventory`" - "`orderTimeout`" - "`other`" - "`paymentAbuse`" - "`paymentDeclined`" - "`priceError`" - "`returnRefundAbuse`" - "`shippingPriceError`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`"
- "actor": "A String", # The actor that created the cancellation. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
- "quantity": 42, # The quantity that was canceled.
- "reasonText": "A String", # The explanation of the reason.
- "creationDate": "A String", # Date on which the cancellation has been created, in ISO 8601 format.
+ "productId": "A String", # The ID of the product to ship. This is the REST ID used in the products service. Either lineItemId or productId is required.
+ "lineItemId": "A String", # The ID of the line item that is shipped. This value is assigned by Google when an order is created. Either lineItemId or productId is required.
+ "quantity": 42, # The quantity that is shipped.
},
],
+ "shipmentGroupId": "A String", # The shipment group ID of the shipment. This is set in shiplineitems request.
+ "trackingId": "A String", # The tracking ID for the shipment.
+ },
+ ],
+ "merchantOrderId": "A String", # Merchant-provided ID of the order.
+ "deliveryDetails": { # Delivery details for shipments of type `delivery`.
+ "phoneNumber": "A String", # The phone number of the person receiving the delivery.
+ "address": { # The delivery address
+ "isPostOfficeBox": True or False, # Whether the address is a post office box.
+ "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
+ "A String",
+ ],
+ "recipientName": "A String", # Name of the recipient.
+ "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
+ "country": "A String", # CLDR country code (e.g. "US").
+ "streetAddress": [ # Street-level part of the address.
+ "A String",
+ ],
+ "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
+ "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
+ },
+ },
+ "netPriceAmount": { # The net amount for the order (price part). For example, if an order was originally for $100 and a refund was issued for $20, the net amount will be $80.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "annotations": [ # List of key-value pairs that are attached to a given order.
+ {
+ "value": "A String", # Value for additional google provided (as key-value pairs) annotation.
+ "key": "A String", # Key for additional google provided (as key-value pairs) annotation.
+ },
+ ],
+ "status": "A String", # The status of the order. Acceptable values are: - "`canceled`" - "`delivered`" - "`inProgress`" - "`partiallyDelivered`" - "`partiallyReturned`" - "`partiallyShipped`" - "`pendingShipment`" - "`returned`" - "`shipped`"
+ "pickupDetails": { # Pickup details for shipments of type `pickup`.
+ "address": { # Address of the pickup location where the shipment should be sent. Note that `recipientName` in the address is the name of the business at the pickup location.
+ "isPostOfficeBox": True or False, # Whether the address is a post office box.
+ "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
+ "A String",
+ ],
+ "recipientName": "A String", # Name of the recipient.
+ "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
+ "country": "A String", # CLDR country code (e.g. "US").
+ "streetAddress": [ # Street-level part of the address.
+ "A String",
+ ],
+ "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
+ "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
+ },
+ "pickupType": "A String", # The pickup type of this order. Acceptable values are: - "`merchantStore`" - "`merchantStoreCurbside`" - "`merchantStoreLocker`" - "`thirdPartyPickupPoint`" - "`thirdPartyLocker`"
+ "locationId": "A String", # ID of the pickup location.
+ "collectors": [ # Collectors authorized to pick up shipment from the pickup location.
+ {
+ "phoneNumber": "A String", # Phone number of the person picking up the shipment.
+ "name": "A String", # Name of the person picking up the shipment.
+ },
+ ],
+ },
+ "promotions": [ # Promotions associated with the order. To determine which promotions apply to which products, check the `Promotions[].appliedItems[].lineItemId` field against the `LineItems[].id` field for each promotion. If a promotion is applied to more than 1 offerId, divide the discount value by the number of affected offers to determine how much discount to apply to each offerId. Examples: 1. To calculate price paid by the customer for a single line item including the discount: For each promotion, subtract the `LineItems[].adjustments[].priceAdjustment.value` amount from the `LineItems[].Price.value`. 2. To calculate price paid by the customer for a single line item including the discount in case of multiple quantity: For each promotion, divide the `LineItems[].adjustments[].priceAdjustment.value` by the quantity of products then subtract the resulting value from the `LineItems[].Product.Price.value` for each quantity item. Only 1 promotion can be applied to an offerId in a given order. To refund an item which had a promotion applied to it, make sure to refund the amount after first subtracting the promotion discount from the item price. More details about the program are here.
+ {
+ "priceValue": { # Estimated discount applied to price. Amount is pre-tax or post-tax depending on location of order.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "shortTitle": "A String", # A short title of the promotion to be shown on the checkout page. Do not provide for `orders.createtestorder`.
+ "endTime": "A String", # Promotion end time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
+ "taxValue": { # Estimated discount applied to tax (if allowed by law). Do not provide for `orders.createtestorder`.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "title": "A String", # Required. The title of the promotion.
+ "merchantPromotionId": "A String", # Required. This field is used to identify promotions within merchants' own systems.
+ "appliedItems": [ # Items that this promotion have been applied to. Do not provide for `orders.createtestorder`. This field will be empty for shipping promotions because shipping is not tied to any specific item.
+ {
+ "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
+ "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
+ "productId": "A String", # `orders.createtestorder`.
+ "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
+ },
+ ],
+ "funder": "A String", # Required. The party funding the promotion. Only `merchant` is supported for `orders.createtestorder`. Acceptable values are: - "`google`" - "`merchant`"
+ "startTime": "A String", # Promotion start time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
+ "type": "A String", # Required. The scope of the promotion. Only `product` is supported for `orders.createtestorder`. Acceptable values are: - "`product`" - "`shipping`"
+ "applicableItems": [ # Items that this promotion may be applied to. If empty, there are no restrictions on applicable items and quantity. This field will also be empty for shipping promotions because shipping is not tied to any specific item.
+ {
+ "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
+ "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
+ "productId": "A String", # `orders.createtestorder`.
+ "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
+ },
+ ],
+ "subtype": "A String", # Required. The category of the promotion. Only `moneyOff` is supported for `orders.createtestorder`. Acceptable values are: - "`buyMGetMoneyOff`" - "`buyMGetNMoneyOff`" - "`buyMGetNPercentOff`" - "`buyMGetPercentOff`" - "`freeGift`" - "`freeGiftWithItemId`" - "`freeGiftWithValue`" - "`freeShippingOvernight`" - "`freeShippingStandard`" - "`freeShippingTwoDay`" - "`moneyOff`" - "`percentOff`" - "`rewardPoints`" - "`salePrice`"
+ },
+ ],
+ "netTaxAmount": { # The net amount for the order (tax part). Note that in certain cases due to taxable base adjustment `netTaxAmount` might not match to a sum of tax field across all lineItems and refunds.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "placedDate": "A String", # The date when the order was placed, in ISO 8601 format.
+ "merchantId": "A String",
+ "lineItems": [ # Line items that are ordered.
+ {
+ "adjustments": [ # Price and tax adjustments applied on the line item.
+ {
+ "priceAdjustment": { # Adjustment for total price of the line item.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "type": "A String", # Type of this adjustment. Acceptable values are: - "`promotion`"
+ "taxAdjustment": { # Adjustment for total tax of the line item.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ },
+ ],
+ "quantityPending": 42, # Number of items pending.
+ "cancellations": [ # Cancellations of the line item.
+ {
+ "actor": "A String", # The actor that created the cancellation. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
+ "creationDate": "A String", # Date on which the cancellation has been created, in ISO 8601 format.
+ "reasonText": "A String", # The explanation of the reason.
+ "quantity": 42, # The quantity that was canceled.
+ "reason": "A String", # The reason for the cancellation. Orders that are canceled with a noInventory reason will lead to the removal of the product from Buy on Google until you make an update to that product. This will not affect your Shopping ads. Acceptable values are: - "`autoPostInternal`" - "`autoPostInvalidBillingAddress`" - "`autoPostNoInventory`" - "`autoPostPriceError`" - "`autoPostUndeliverableShippingAddress`" - "`couponAbuse`" - "`customerCanceled`" - "`customerInitiatedCancel`" - "`customerSupportRequested`" - "`failToPushOrderGoogleError`" - "`failToPushOrderMerchantError`" - "`failToPushOrderMerchantFulfillmentError`" - "`failToPushOrderToMerchant`" - "`failToPushOrderToMerchantOutOfStock`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`merchantDidNotShipOnTime`" - "`noInventory`" - "`orderTimeout`" - "`other`" - "`paymentAbuse`" - "`paymentDeclined`" - "`priceError`" - "`returnRefundAbuse`" - "`shippingPriceError`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`"
+ },
+ ],
+ "price": { # Total price for the line item. For example, if two items for $10 are purchased, the total price will be $20.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "returnInfo": { # Details of the return policy for the line item.
+ "isReturnable": True or False, # Required. Whether the item is returnable.
+ "daysToReturn": 42, # Required. How many days later the item can be returned.
+ "policyUrl": "A String", # Required. URL of the item return policy.
+ },
+ "quantityUndeliverable": 42, # Number of items undeliverable.
+ "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.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "quantityReturned": 42, # Number of items returned.
+ "quantityShipped": 42, # Number of items shipped.
+ "quantityReadyForPickup": 42, # Number of items ready for pickup.
+ "quantityOrdered": 42, # Number of items ordered.
"annotations": [ # Annotations that are attached to the line item.
{
"value": "A String", # Value for additional merchant provided (as key-value pairs) annotation about the line item.
"key": "A String", # Key for additional merchant provided (as key-value pairs) annotation about the line item.
},
],
- "quantityDelivered": 42, # Number of items delivered.
- "quantityUndeliverable": 42, # Number of items undeliverable.
"quantityCanceled": 42, # Number of items canceled.
- "quantityShipped": 42, # Number of items shipped.
- "returns": [ # Returns of the line item.
- {
- "reason": "A String", # The reason for the return. Acceptable values are: - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`deliveredTooLate`" - "`expiredItem`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`other`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`qualityNotAsExpected`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`"
- "actor": "A String", # The actor that created the refund. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
- "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format.
- "reasonText": "A String", # The explanation of the reason.
- "quantity": 42, # Quantity that is returned.
+ "shippingDetails": { # Details of the requested shipping for the line item.
+ "shipByDate": "A String", # Required. The ship by date, in ISO 8601 format.
+ "type": "A String", # Type of shipment. Indicates whether `deliveryDetails` or `pickupDetails` is applicable for this shipment. Acceptable values are: - "`delivery`" - "`pickup`"
+ "method": { # Required. Details of the shipping method.
+ "carrier": "A String", # The carrier for the shipping. Optional. See `shipments[].carrier` for a list of acceptable values.
+ "methodName": "A String", # Required. The name of the shipping method.
+ "maxDaysInTransit": 42, # Required. Maximum transit time.
+ "minDaysInTransit": 42, # Required. Minimum transit time.
},
- ],
- "quantityReadyForPickup": 42, # Number of items ready for pickup.
- "price": { # Total price for the line item. For example, if two items for $10 are purchased, the total price will be $20.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
+ "deliverByDate": "A String", # Required. The delivery by date, in ISO 8601 format.
+ "pickupPromiseInMinutes": 42, # The promised time in minutes in which the order will be ready for pickup. This only applies to buy-online-pickup-in-store same-day order.
},
- "quantityPending": 42, # Number of items pending.
"product": { # Product data as seen by customer from the time of the order placement. Note that certain attributes values (e.g. title or gtin) might be reformatted and no longer match values submitted via product feed.
- "id": "A String", # The REST ID of the product.
+ "shownImage": "A String", # URL to the cached image shown to the user when order was placed.
+ "mpn": "A String", # Manufacturer Part Number (MPN) of the item.
"targetCountry": "A String", # The CLDR territory // code of the target country of the product.
+ "gtin": "A String", # Global Trade Item Number (GTIN) of the item.
+ "itemGroupId": "A String", # Shared identifier for all variants of the same product.
+ "offerId": "A String", # An identifier of the item.
+ "condition": "A String", # Condition or state of the item. Acceptable values are: - "`new`" - "`refurbished`" - "`used`"
+ "contentLanguage": "A String", # The two-letter ISO 639-1 language code for the item.
+ "price": { # Price of the item.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "id": "A String", # The REST ID of the product.
+ "brand": "A String", # Brand of the item.
"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.
{
"dimension": "A String", # The dimension of the variant.
@@ -862,226 +1054,34 @@
"fees": [ # Associated fees at order creation time.
{
"amount": { # Amount of the fee.
- "value": "A String", # The price represented as a number.
"currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
},
"name": "A String", # Name of the fee.
},
],
"imageLink": "A String", # URL of an image of the item.
"title": "A String", # The title of the product.
- "shownImage": "A String", # URL to the cached image shown to the user when order was placed.
- "price": { # Price of the item.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "condition": "A String", # Condition or state of the item. Acceptable values are: - "`new`" - "`refurbished`" - "`used`"
- "gtin": "A String", # Global Trade Item Number (GTIN) of the item.
- "itemGroupId": "A String", # Shared identifier for all variants of the same product.
- "contentLanguage": "A String", # The two-letter ISO 639-1 language code for the item.
- "offerId": "A String", # An identifier of the item.
- "brand": "A String", # Brand of the item.
- "mpn": "A String", # Manufacturer Part Number (MPN) of the item.
},
- "returnInfo": { # Details of the return policy for the line item.
- "daysToReturn": 42, # Required. How many days later the item can be returned.
- "isReturnable": True or False, # Required. Whether the item is returnable.
- "policyUrl": "A String", # Required. URL of the item return policy.
- },
- "adjustments": [ # Price and tax adjustments applied on the line item.
+ "returns": [ # Returns of the line item.
{
- "priceAdjustment": { # Adjustment for total price of the line item.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "taxAdjustment": { # Adjustment for total tax of the line item.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "type": "A String", # Type of this adjustment. Acceptable values are: - "`promotion`"
+ "reasonText": "A String", # The explanation of the reason.
+ "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format.
+ "quantity": 42, # Quantity that is returned.
+ "actor": "A String", # The actor that created the refund. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
+ "reason": "A String", # The reason for the return. Acceptable values are: - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`deliveredTooLate`" - "`expiredItem`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`other`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`qualityNotAsExpected`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`"
},
],
- "shippingDetails": { # Details of the requested shipping for the line item.
- "shipByDate": "A String", # Required. The ship by date, in ISO 8601 format.
- "deliverByDate": "A String", # Required. The delivery by date, in ISO 8601 format.
- "type": "A String", # Type of shipment. Indicates whether `deliveryDetails` or `pickupDetails` is applicable for this shipment. Acceptable values are: - "`delivery`" - "`pickup`"
- "method": { # Required. Details of the shipping method.
- "carrier": "A String", # The carrier for the shipping. Optional. See `shipments[].carrier` for a list of acceptable values.
- "methodName": "A String", # Required. The name of the shipping method.
- "minDaysInTransit": 42, # Required. Minimum transit time.
- "maxDaysInTransit": 42, # Required. Maximum transit time.
- },
- "pickupPromiseInMinutes": 42, # The promised time in minutes in which the order will be ready for pickup. This only applies to buy-online-pickup-in-store same-day order.
- },
- "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.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "quantityReturned": 42, # Number of items returned.
+ "quantityDelivered": 42, # Number of items delivered.
+ "id": "A String", # The ID of the line item.
},
],
- "promotions": [ # Promotions associated with the order. To determine which promotions apply to which products, check the `Promotions[].appliedItems[].lineItemId` field against the `LineItems[].id` field for each promotion. If a promotion is applied to more than 1 offerId, divide the discount value by the number of affected offers to determine how much discount to apply to each offerId. Examples: 1. To calculate price paid by the customer for a single line item including the discount: For each promotion, subtract the `LineItems[].adjustments[].priceAdjustment.value` amount from the `LineItems[].Price.value`. 2. To calculate price paid by the customer for a single line item including the discount in case of multiple quantity: For each promotion, divide the `LineItems[].adjustments[].priceAdjustment.value` by the quantity of products then subtract the resulting value from the `LineItems[].Product.Price.value` for each quantity item. Only 1 promotion can be applied to an offerId in a given order. To refund an item which had a promotion applied to it, make sure to refund the amount after first subtracting the promotion discount from the item price. More details about the program are here.
- {
- "appliedItems": [ # Items that this promotion have been applied to. Do not provide for `orders.createtestorder`. This field will be empty for shipping promotions because shipping is not tied to any specific item.
- {
- "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
- "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
- "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
- "productId": "A String", # `orders.createtestorder`.
- },
- ],
- "funder": "A String", # Required. The party funding the promotion. Only `merchant` is supported for `orders.createtestorder`. Acceptable values are: - "`google`" - "`merchant`"
- "subtype": "A String", # Required. The category of the promotion. Only `moneyOff` is supported for `orders.createtestorder`. Acceptable values are: - "`buyMGetMoneyOff`" - "`buyMGetNMoneyOff`" - "`buyMGetNPercentOff`" - "`buyMGetPercentOff`" - "`freeGift`" - "`freeGiftWithItemId`" - "`freeGiftWithValue`" - "`freeShippingOvernight`" - "`freeShippingStandard`" - "`freeShippingTwoDay`" - "`moneyOff`" - "`percentOff`" - "`rewardPoints`" - "`salePrice`"
- "type": "A String", # Required. The scope of the promotion. Only `product` is supported for `orders.createtestorder`. Acceptable values are: - "`product`" - "`shipping`"
- "endTime": "A String", # Promotion end time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
- "startTime": "A String", # Promotion start time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
- "shortTitle": "A String", # A short title of the promotion to be shown on the checkout page. Do not provide for `orders.createtestorder`.
- "taxValue": { # Estimated discount applied to tax (if allowed by law). Do not provide for `orders.createtestorder`.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "title": "A String", # Required. The title of the promotion.
- "merchantPromotionId": "A String", # Required. This field is used to identify promotions within merchants' own systems.
- "priceValue": { # Estimated discount applied to price. Amount is pre-tax or post-tax depending on location of order.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "applicableItems": [ # Items that this promotion may be applied to. If empty, there are no restrictions on applicable items and quantity. This field will also be empty for shipping promotions because shipping is not tied to any specific item.
- {
- "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
- "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
- "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
- "productId": "A String", # `orders.createtestorder`.
- },
- ],
- },
- ],
- "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#order`"
- "netTaxAmount": { # The net amount for the order (tax part). Note that in certain cases due to taxable base adjustment `netTaxAmount` might not match to a sum of tax field across all lineItems and refunds.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "annotations": [ # List of key-value pairs that are attached to a given order.
- {
- "value": "A String", # Value for additional google provided (as key-value pairs) annotation.
- "key": "A String", # Key for additional google provided (as key-value pairs) annotation.
- },
- ],
- "placedDate": "A String", # The date when the order was placed, in ISO 8601 format.
- "shipments": [ # Shipments of the order.
- {
- "creationDate": "A String", # Date on which the shipment has been created, in ISO 8601 format.
- "scheduledDeliveryDetails": { # Delivery details of the shipment if scheduling is needed.
- "scheduledDate": "A String", # The date a shipment is scheduled for delivery, in ISO 8601 format.
- "carrierPhoneNumber": "A String", # The phone number of the carrier fulfilling the delivery. The phone number is formatted as the international notation in ITU-T Recommendation E.123 (e.g., "+41 44 668 1800").
- },
- "id": "A String", # The ID of the shipment.
- "lineItems": [ # The line items that are shipped.
- {
- "quantity": 42, # The quantity that is shipped.
- "lineItemId": "A String", # The ID of the line item that is shipped. This value is assigned by Google when an order is created. Either lineItemId or productId is required.
- "productId": "A String", # The ID of the product to ship. This is the REST ID used in the products service. Either lineItemId or productId is required.
- },
- ],
- "trackingId": "A String", # The tracking ID for the shipment.
- "carrier": "A String", # The carrier handling the shipment. For supported carriers, Google includes the carrier name and tracking URL in emails to customers. For select supported carriers, Google also automatically updates the shipment status based on the provided shipment ID. *Note:* You can also use unsupported carriers, but emails to customers will not include the carrier name or tracking URL, and there will be no automatic order status updates. Supported carriers for US are: - "`ups`" (United Parcel Service) *automatic status updates* - "`usps`" (United States Postal Service) *automatic status updates* - "`fedex`" (FedEx) *automatic status updates * - "`dhl`" (DHL eCommerce) *automatic status updates* (US only) - "`ontrac`" (OnTrac) *automatic status updates * - "`dhl express`" (DHL Express) - "`deliv`" (Deliv) - "`dynamex`" (TForce) - "`lasership`" (LaserShip) - "`mpx`" (Military Parcel Xpress) - "`uds`" (United Delivery Service) - "`efw`" (Estes Forwarding Worldwide) - "`jd logistics`" (JD Logistics) - "`yunexpress`" (YunExpress) - "`china post`" (China Post) - "`china ems`" (China Post Express Mail Service) - "`singapore post`" (Singapore Post) - "`pos malaysia`" (Pos Malaysia) - "`postnl`" (PostNL) - "`ptt`" (PTT Turkish Post) - "`eub`" (ePacket) - "`chukou1`" (Chukou1 Logistics) - "`bestex`" (Best Express) - "`canada post`" (Canada Post) - "`purolator`" (Purolator) - "`canpar`" (Canpar) - "`india post`" (India Post) - "`blue dart`" (Blue Dart) - "`delhivery`" (Delhivery) - "`dtdc`" (DTDC) - "`tpc india`" (TPC India) Supported carriers for FR are: - "`la poste`" (La Poste) *automatic status updates * - "`colissimo`" (Colissimo by La Poste) *automatic status updates* - "`ups`" (United Parcel Service) *automatic status updates * - "`chronopost`" (Chronopost by La Poste) - "`gls`" (General Logistics Systems France) - "`dpd`" (DPD Group by GeoPost) - "`bpost`" (Belgian Post Group) - "`colis prive`" (Colis Privé) - "`boxtal`" (Boxtal) - "`geodis`" (GEODIS) - "`tnt`" (TNT) - "`db schenker`" (DB Schenker) - "`aramex`" (Aramex)
- "deliveryDate": "A String", # Date on which the shipment has been delivered, in ISO 8601 format. Present only if `status` is `delivered`
- "shipmentGroupId": "A String", # The shipment group ID of the shipment. This is set in shiplineitems request.
- "status": "A String", # The status of the shipment. Acceptable values are: - "`delivered`" - "`readyForPickup`" - "`shipped`" - "`undeliverable`"
- },
- ],
- "id": "A String", # The REST ID of the order. Globally unique.
- "refunds": [ # Refunds for the order.
- {
- "amount": { # The amount that is refunded.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "actor": "A String", # The actor that created the refund. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
- "reasonText": "A String", # The explanation of the reason.
- "reason": "A String", # The reason for the refund. Acceptable values are: - "`adjustment`" - "`autoPostInternal`" - "`autoPostInvalidBillingAddress`" - "`autoPostNoInventory`" - "`autoPostPriceError`" - "`autoPostUndeliverableShippingAddress`" - "`couponAbuse`" - "`courtesyAdjustment`" - "`customerCanceled`" - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`customerSupportRequested`" - "`deliveredLateByCarrier`" - "`deliveredTooLate`" - "`expiredItem`" - "`failToPushOrderGoogleError`" - "`failToPushOrderMerchantError`" - "`failToPushOrderMerchantFulfillmentError`" - "`failToPushOrderToMerchant`" - "`failToPushOrderToMerchantOutOfStock`" - "`feeAdjustment`" - "`invalidCoupon`" - "`lateShipmentCredit`" - "`malformedShippingAddress`" - "`merchantDidNotShipOnTime`" - "`noInventory`" - "`orderTimeout`" - "`other`" - "`paymentAbuse`" - "`paymentDeclined`" - "`priceAdjustment`" - "`priceError`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`promoReallocation`" - "`qualityNotAsExpected`" - "`returnRefundAbuse`" - "`shippingCostAdjustment`" - "`shippingPriceError`" - "`taxAdjustment`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`"
- "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format.
- },
- ],
- "status": "A String", # The status of the order. Acceptable values are: - "`canceled`" - "`delivered`" - "`inProgress`" - "`partiallyDelivered`" - "`partiallyReturned`" - "`partiallyShipped`" - "`pendingShipment`" - "`returned`" - "`shipped`"
- "merchantOrderId": "A String", # Merchant-provided ID of the order.
- "deliveryDetails": { # Delivery details for shipments of type `delivery`.
- "address": { # The delivery address
- "recipientName": "A String", # Name of the recipient.
- "country": "A String", # CLDR country code (e.g. "US").
- "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
- "isPostOfficeBox": True or False, # Whether the address is a post office box.
- "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
- "A String",
- ],
- "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
- "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
- "streetAddress": [ # Street-level part of the address.
- "A String",
- ],
- },
- "phoneNumber": "A String", # The phone number of the person receiving the delivery.
- },
"shippingCostTax": { # The tax for the total shipping cost.
- "value": "A String", # The price represented as a number.
"currency": "A String", # The currency of the price.
- },
- "paymentStatus": "A String", # The status of the payment. Acceptable values are: - "`paymentCaptured`" - "`paymentRejected`" - "`paymentSecured`" - "`pendingAuthorization`"
- "customer": { # The details of the customer who placed the order.
- "loyaltyInfo": { # Loyalty program information.
- "loyaltyNumber": "A String", # The loyalty card/membership number.
- "name": "A String", # Name of card/membership holder, this field will be populated when
- },
- "fullName": "A String", # Full name of the customer.
- "invoiceReceivingEmail": "A String", # Email address for the merchant to send value-added tax or invoice documentation of the order. Only the last document sent is made available to the customer. For more information, see About automated VAT invoicing for Buy on Google.
- "marketingRightsInfo": { # Customer's marketing preferences. Contains the marketing opt-in information that is current at the time that the merchant call. User preference selections can change from one order to the next so preferences must be checked with every order.
- "lastUpdatedTimestamp": "A String", # Timestamp when last time marketing preference was updated. Could be empty, if user wasn't offered a selection yet.
- "explicitMarketingPreference": "A String", # Last known customer selection regarding marketing preferences. In certain cases this selection might not be known, so this field would be empty. If a customer selected `granted` in their most recent order, they can be subscribed to marketing emails. Customers who have chosen `denied` must not be subscribed, or must be unsubscribed if already opted-in. Acceptable values are: - "`denied`" - "`granted`"
- "marketingEmailAddress": "A String", # Email address that can be used for marketing purposes. The field may be empty even if `explicitMarketingPreference` is 'granted'. This happens when retrieving an old order from the customer who deleted their account.
- },
- },
- "shippingCost": { # The total cost of shipping for all items.
"value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
},
- "pickupDetails": { # Pickup details for shipments of type `pickup`.
- "address": { # Address of the pickup location where the shipment should be sent. Note that `recipientName` in the address is the name of the business at the pickup location.
- "recipientName": "A String", # Name of the recipient.
- "country": "A String", # CLDR country code (e.g. "US").
- "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
- "isPostOfficeBox": True or False, # Whether the address is a post office box.
- "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
- "A String",
- ],
- "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
- "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
- "streetAddress": [ # Street-level part of the address.
- "A String",
- ],
- },
- "locationId": "A String", # ID of the pickup location.
- "pickupType": "A String", # The pickup type of this order. Acceptable values are: - "`merchantStore`" - "`merchantStoreCurbside`" - "`merchantStoreLocker`" - "`thirdPartyPickupPoint`" - "`thirdPartyLocker`"
- "collectors": [ # Collectors authorized to pick up shipment from the pickup location.
- {
- "phoneNumber": "A String", # Phone number of the person picking up the shipment.
- "name": "A String", # Name of the person picking up the shipment.
- },
- ],
- },
- "billingAddress": { # The billing address.
- "recipientName": "A String", # Name of the recipient.
- "country": "A String", # CLDR country code (e.g. "US").
- "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
- "isPostOfficeBox": True or False, # Whether the address is a post office box.
- "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
- "A String",
- ],
- "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
- "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
- "streetAddress": [ # Street-level part of the address.
- "A String",
- ],
- },
+ "taxCollector": "A String", # The party responsible for collecting and remitting taxes. Acceptable values are: - "`marketplaceFacilitator`" - "`merchant`"
+ "acknowledged": True or False, # Whether the order was acknowledged.
},
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#ordersGetByMerchantOrderIdResponse".
}</pre>
@@ -1111,151 +1111,151 @@
An object of the form:
{
+ "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#ordersGetTestOrderTemplateResponse".
"template": { # The requested test order template.
- "lineItems": [ # Required. Line items that are ordered. At least one line item must be provided.
- {
- "returnInfo": { # Required. Details of the return policy for the line item.
- "daysToReturn": 42, # Required. How many days later the item can be returned.
- "isReturnable": True or False, # Required. Whether the item is returnable.
- "policyUrl": "A String", # Required. URL of the item return policy.
- },
- "product": { # Required. Product data from the time of the order placement.
- "brand": "A String", # Required. Brand of the item.
- "mpn": "A String", # Manufacturer Part Number (MPN) of the item. Optional.
- "targetCountry": "A String", # Required. The CLDR territory // code of the target country of the product.
- "contentLanguage": "A String", # Required. The two-letter ISO 639-1 language code for the item. Acceptable values are: - "`en`" - "`fr`"
- "itemGroupId": "A String", # Shared identifier for all variants of the same product. Optional.
- "gtin": "A String", # Global Trade Item Number (GTIN) of the item. Optional.
- "title": "A String", # Required. The title of the product.
- "offerId": "A String", # Required. An identifier of the item.
- "condition": "A String", # Required. Condition or state of the item. Acceptable values are: - "`new`"
- "fees": [ # Fees for the item. Optional.
- {
- "amount": { # Amount of the fee.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "name": "A String", # Name of the fee.
- },
- ],
- "variantAttributes": [ # Variant attributes for the item. Optional.
- {
- "dimension": "A String", # The dimension of the variant.
- "value": "A String", # The value for the dimension.
- },
- ],
- "imageLink": "A String", # Required. URL of an image of the item.
- "price": { # Required. The price for the product. Tax is automatically calculated for orders where marketplace facilitator tax laws are applicable. Otherwise, tax settings from Merchant Center are applied.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- },
- "shippingDetails": { # Required. Details of the requested shipping for the line item.
- "shipByDate": "A String", # Required. The ship by date, in ISO 8601 format.
- "deliverByDate": "A String", # Required. The delivery by date, in ISO 8601 format.
- "type": "A String", # Type of shipment. Indicates whether `deliveryDetails` or `pickupDetails` is applicable for this shipment. Acceptable values are: - "`delivery`" - "`pickup`"
- "method": { # Required. Details of the shipping method.
- "carrier": "A String", # The carrier for the shipping. Optional. See `shipments[].carrier` for a list of acceptable values.
- "methodName": "A String", # Required. The name of the shipping method.
- "minDaysInTransit": 42, # Required. Minimum transit time.
- "maxDaysInTransit": 42, # Required. Maximum transit time.
- },
- "pickupPromiseInMinutes": 42, # The promised time in minutes in which the order will be ready for pickup. This only applies to buy-online-pickup-in-store same-day order.
- },
- "quantityOrdered": 42, # Required. Number of items ordered.
- },
- ],
- "promotions": [ # Promotions associated with the order.
- {
- "appliedItems": [ # Items that this promotion have been applied to. Do not provide for `orders.createtestorder`. This field will be empty for shipping promotions because shipping is not tied to any specific item.
- {
- "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
- "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
- "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
- "productId": "A String", # `orders.createtestorder`.
- },
- ],
- "funder": "A String", # Required. The party funding the promotion. Only `merchant` is supported for `orders.createtestorder`. Acceptable values are: - "`google`" - "`merchant`"
- "subtype": "A String", # Required. The category of the promotion. Only `moneyOff` is supported for `orders.createtestorder`. Acceptable values are: - "`buyMGetMoneyOff`" - "`buyMGetNMoneyOff`" - "`buyMGetNPercentOff`" - "`buyMGetPercentOff`" - "`freeGift`" - "`freeGiftWithItemId`" - "`freeGiftWithValue`" - "`freeShippingOvernight`" - "`freeShippingStandard`" - "`freeShippingTwoDay`" - "`moneyOff`" - "`percentOff`" - "`rewardPoints`" - "`salePrice`"
- "type": "A String", # Required. The scope of the promotion. Only `product` is supported for `orders.createtestorder`. Acceptable values are: - "`product`" - "`shipping`"
- "endTime": "A String", # Promotion end time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
- "startTime": "A String", # Promotion start time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
- "shortTitle": "A String", # A short title of the promotion to be shown on the checkout page. Do not provide for `orders.createtestorder`.
- "taxValue": { # Estimated discount applied to tax (if allowed by law). Do not provide for `orders.createtestorder`.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "title": "A String", # Required. The title of the promotion.
- "merchantPromotionId": "A String", # Required. This field is used to identify promotions within merchants' own systems.
- "priceValue": { # Estimated discount applied to price. Amount is pre-tax or post-tax depending on location of order.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "applicableItems": [ # Items that this promotion may be applied to. If empty, there are no restrictions on applicable items and quantity. This field will also be empty for shipping promotions because shipping is not tied to any specific item.
- {
- "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
- "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
- "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
- "productId": "A String", # `orders.createtestorder`.
- },
- ],
- },
- ],
- "shippingOption": "A String", # Required. The requested shipping option. Acceptable values are: - "`economy`" - "`expedited`" - "`oneDay`" - "`sameDay`" - "`standard`" - "`twoDay`"
"enableOrderinvoices": True or False, # Whether the orderinvoices service should support this order.
+ "predefinedPickupDetails": "A String", # Identifier of one of the predefined pickup details. Required for orders containing line items with shipping type `pickup`. Acceptable values are: - "`dwight`" - "`jim`" - "`pam`"
+ "notificationMode": "A String", # Restricted. Do not use.
+ "predefinedEmail": "A String", # Required. Email address of the customer. Acceptable values are: - "`pog.dwight.schrute@gmail.com`" - "`pog.jim.halpert@gmail.com`" - "`penpog.pam.beesly@gmail.comding`"
"pickupDetails": { # Overrides the predefined pickup details if provided.
+ "pickupLocationAddress": { # Required. Pickup location address.
+ "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
+ "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
+ "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
+ "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
+ "A String",
+ ],
+ "recipientName": "A String", # Name of the recipient.
+ "streetAddress": [ # Street-level part of the address.
+ "A String",
+ ],
+ "country": "A String", # CLDR country code (e.g. "US").
+ "isPostOfficeBox": True or False, # Whether the address is a post office box.
+ },
"pickupPersons": [ # Required. all pickup persons set by users.
{
"name": "A String", # Required. Full name of the pickup person.
"phoneNumber": "A String", # Required. The phone number of the person picking up the items.
},
],
- "pickupLocationAddress": { # Required. Pickup location address.
- "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
- "recipientName": "A String", # Name of the recipient.
- "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
- "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
- "A String",
- ],
- "streetAddress": [ # Street-level part of the address.
- "A String",
- ],
- "country": "A String", # CLDR country code (e.g. "US").
- "isPostOfficeBox": True or False, # Whether the address is a post office box.
- "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
- },
- "locationCode": "A String", # Required. Code of the location defined by provider or merchant.
"pickupLocationType": "A String", # Pickup location type. Acceptable values are: - "`locker`" - "`store`" - "`curbside`"
+ "locationCode": "A String", # Required. Code of the location defined by provider or merchant.
},
- "predefinedEmail": "A String", # Required. Email address of the customer. Acceptable values are: - "`pog.dwight.schrute@gmail.com`" - "`pog.jim.halpert@gmail.com`" - "`penpog.pam.beesly@gmail.comding`"
- "predefinedDeliveryAddress": "A String", # Required. Identifier of one of the predefined delivery addresses for the delivery. Acceptable values are: - "`dwight`" - "`jim`" - "`pam`"
- "shippingCost": { # Required. The price of shipping for all items. Shipping tax is automatically calculated for orders where marketplace facilitator tax laws are applicable. Otherwise, tax settings from Merchant Center are applied. Note that shipping is not taxed in certain states.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "notificationMode": "A String", # Restricted. Do not use.
- "predefinedBillingAddress": "A String", # Required. The billing address. Acceptable values are: - "`dwight`" - "`jim`" - "`pam`"
- "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#testOrder`"
- "predefinedPickupDetails": "A String", # Identifier of one of the predefined pickup details. Required for orders containing line items with shipping type `pickup`. Acceptable values are: - "`dwight`" - "`jim`" - "`pam`"
"deliveryDetails": { # Overrides the predefined delivery details if provided.
"address": { # The delivery address
- "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
- "recipientName": "A String", # Name of the recipient.
"region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
+ "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
+ "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
"fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
"A String",
],
+ "recipientName": "A String", # Name of the recipient.
"streetAddress": [ # Street-level part of the address.
"A String",
],
"country": "A String", # CLDR country code (e.g. "US").
"isPostOfficeBox": True or False, # Whether the address is a post office box.
- "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
},
"phoneNumber": "A String", # The phone number of the person receiving the delivery.
},
+ "promotions": [ # Promotions associated with the order.
+ {
+ "priceValue": { # Estimated discount applied to price. Amount is pre-tax or post-tax depending on location of order.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "shortTitle": "A String", # A short title of the promotion to be shown on the checkout page. Do not provide for `orders.createtestorder`.
+ "endTime": "A String", # Promotion end time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
+ "taxValue": { # Estimated discount applied to tax (if allowed by law). Do not provide for `orders.createtestorder`.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "title": "A String", # Required. The title of the promotion.
+ "merchantPromotionId": "A String", # Required. This field is used to identify promotions within merchants' own systems.
+ "appliedItems": [ # Items that this promotion have been applied to. Do not provide for `orders.createtestorder`. This field will be empty for shipping promotions because shipping is not tied to any specific item.
+ {
+ "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
+ "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
+ "productId": "A String", # `orders.createtestorder`.
+ "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
+ },
+ ],
+ "funder": "A String", # Required. The party funding the promotion. Only `merchant` is supported for `orders.createtestorder`. Acceptable values are: - "`google`" - "`merchant`"
+ "startTime": "A String", # Promotion start time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
+ "type": "A String", # Required. The scope of the promotion. Only `product` is supported for `orders.createtestorder`. Acceptable values are: - "`product`" - "`shipping`"
+ "applicableItems": [ # Items that this promotion may be applied to. If empty, there are no restrictions on applicable items and quantity. This field will also be empty for shipping promotions because shipping is not tied to any specific item.
+ {
+ "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
+ "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
+ "productId": "A String", # `orders.createtestorder`.
+ "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
+ },
+ ],
+ "subtype": "A String", # Required. The category of the promotion. Only `moneyOff` is supported for `orders.createtestorder`. Acceptable values are: - "`buyMGetMoneyOff`" - "`buyMGetNMoneyOff`" - "`buyMGetNPercentOff`" - "`buyMGetPercentOff`" - "`freeGift`" - "`freeGiftWithItemId`" - "`freeGiftWithValue`" - "`freeShippingOvernight`" - "`freeShippingStandard`" - "`freeShippingTwoDay`" - "`moneyOff`" - "`percentOff`" - "`rewardPoints`" - "`salePrice`"
+ },
+ ],
+ "shippingCost": { # Required. The price of shipping for all items. Shipping tax is automatically calculated for orders where marketplace facilitator tax laws are applicable. Otherwise, tax settings from Merchant Center are applied. Note that shipping is not taxed in certain states.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "predefinedBillingAddress": "A String", # Required. The billing address. Acceptable values are: - "`dwight`" - "`jim`" - "`pam`"
+ "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#testOrder`"
+ "shippingOption": "A String", # Required. The requested shipping option. Acceptable values are: - "`economy`" - "`expedited`" - "`oneDay`" - "`sameDay`" - "`standard`" - "`twoDay`"
+ "predefinedDeliveryAddress": "A String", # Required. Identifier of one of the predefined delivery addresses for the delivery. Acceptable values are: - "`dwight`" - "`jim`" - "`pam`"
+ "lineItems": [ # Required. Line items that are ordered. At least one line item must be provided.
+ {
+ "product": { # Required. Product data from the time of the order placement.
+ "contentLanguage": "A String", # Required. The two-letter ISO 639-1 language code for the item. Acceptable values are: - "`en`" - "`fr`"
+ "mpn": "A String", # Manufacturer Part Number (MPN) of the item. Optional.
+ "title": "A String", # Required. The title of the product.
+ "price": { # Required. The price for the product. Tax is automatically calculated for orders where marketplace facilitator tax laws are applicable. Otherwise, tax settings from Merchant Center are applied.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "itemGroupId": "A String", # Shared identifier for all variants of the same product. Optional.
+ "condition": "A String", # Required. Condition or state of the item. Acceptable values are: - "`new`"
+ "variantAttributes": [ # Variant attributes for the item. Optional.
+ {
+ "dimension": "A String", # The dimension of the variant.
+ "value": "A String", # The value for the dimension.
+ },
+ ],
+ "offerId": "A String", # Required. An identifier of the item.
+ "brand": "A String", # Required. Brand of the item.
+ "gtin": "A String", # Global Trade Item Number (GTIN) of the item. Optional.
+ "imageLink": "A String", # Required. URL of an image of the item.
+ "fees": [ # Fees for the item. Optional.
+ {
+ "amount": { # Amount of the fee.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "name": "A String", # Name of the fee.
+ },
+ ],
+ "targetCountry": "A String", # Required. The CLDR territory // code of the target country of the product.
+ },
+ "quantityOrdered": 42, # Required. Number of items ordered.
+ "returnInfo": { # Required. Details of the return policy for the line item.
+ "isReturnable": True or False, # Required. Whether the item is returnable.
+ "daysToReturn": 42, # Required. How many days later the item can be returned.
+ "policyUrl": "A String", # Required. URL of the item return policy.
+ },
+ "shippingDetails": { # Required. Details of the requested shipping for the line item.
+ "shipByDate": "A String", # Required. The ship by date, in ISO 8601 format.
+ "type": "A String", # Type of shipment. Indicates whether `deliveryDetails` or `pickupDetails` is applicable for this shipment. Acceptable values are: - "`delivery`" - "`pickup`"
+ "method": { # Required. Details of the shipping method.
+ "carrier": "A String", # The carrier for the shipping. Optional. See `shipments[].carrier` for a list of acceptable values.
+ "methodName": "A String", # Required. The name of the shipping method.
+ "maxDaysInTransit": 42, # Required. Maximum transit time.
+ "minDaysInTransit": 42, # Required. Minimum transit time.
+ },
+ "deliverByDate": "A String", # Required. The delivery by date, in ISO 8601 format.
+ "pickupPromiseInMinutes": 42, # The promised time in minutes in which the order will be ready for pickup. This only applies to buy-online-pickup-in-store same-day order.
+ },
+ },
+ ],
},
- "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#ordersGetTestOrderTemplateResponse".
}</pre>
</div>
@@ -1270,20 +1270,20 @@
The object takes the form of:
{
- "productId": "A String", # The ID of the product to return. This is the REST ID used in the products service. Either lineItemId or productId is required.
- "operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
- "quantity": 42, # The quantity to return and refund.
- "lineItemId": "A String", # The ID of the line item to return. Either lineItemId or productId is required.
- "taxAmount": { # The amount of tax to be refunded. Required.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
"reason": "A String", # The reason for the return. Acceptable values are: - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`deliveredTooLate`" - "`expiredItem`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`other`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`qualityNotAsExpected`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`"
- "reasonText": "A String", # The explanation of the reason.
"priceAmount": { # The amount to be refunded. This may be pre-tax or post-tax depending on the location of the order. Required.
- "value": "A String", # The price represented as a number.
"currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
},
+ "taxAmount": { # The amount of tax to be refunded. Required.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "productId": "A String", # The ID of the product to return. This is the REST ID used in the products service. Either lineItemId or productId is required.
+ "lineItemId": "A String", # The ID of the line item to return. Either lineItemId or productId is required.
+ "operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
+ "reasonText": "A String", # The explanation of the reason.
+ "quantity": 42, # The quantity to return and refund.
}
x__xgafv: string, V1 error format.
@@ -1301,17 +1301,17 @@
</div>
<div class="method">
- <code class="details" id="list">list(merchantId, placedDateStart=None, orderBy=None, placedDateEnd=None, maxResults=None, acknowledged=None, pageToken=None, statuses=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(merchantId, maxResults=None, acknowledged=None, orderBy=None, pageToken=None, placedDateEnd=None, placedDateStart=None, statuses=None, x__xgafv=None)</code>
<pre>Lists the orders in your Merchant Center account.
Args:
merchantId: string, The ID of the account that manages the order. This cannot be a multi-client account. (required)
- placedDateStart: string, Obtains orders placed after this date (inclusively), in ISO 8601 format.
- orderBy: string, Order results by placement date in descending or ascending order. Acceptable values are: - placedDateAsc - placedDateDesc
- placedDateEnd: string, Obtains orders placed before this date (exclusively), in ISO 8601 format.
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.
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. We recommend using this filter set to `false`, in conjunction with the `acknowledge` call, such that only un-acknowledged orders are returned.
+ orderBy: string, Order results by placement date in descending or ascending order. Acceptable values are: - placedDateAsc - placedDateDesc
pageToken: string, The token returned by the previous request.
+ placedDateEnd: string, Obtains orders placed before this date (exclusively), in ISO 8601 format.
+ placedDateStart: string, Obtains orders placed after this date (inclusively), in ISO 8601 format.
statuses: string, Obtains orders that match any of the specified statuses. 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)
Allowed values
ACTIVE -
@@ -1334,56 +1334,250 @@
An object of the form:
{
+ "nextPageToken": "A String", # The token for the retrieval of the next page of orders.
+ "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#ordersListResponse".
"resources": [
{ # Order. Production access (all methods) requires the order manager role. Sandbox access does not.
- "merchantId": "A String",
- "netPriceAmount": { # The net amount for the order (price part). For example, if an order was originally for $100 and a refund was issued for $20, the net amount will be $80.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "taxCollector": "A String", # The party responsible for collecting and remitting taxes. Acceptable values are: - "`marketplaceFacilitator`" - "`merchant`"
- "acknowledged": True or False, # Whether the order was acknowledged.
- "lineItems": [ # Line items that are ordered.
+ "paymentStatus": "A String", # The status of the payment. Acceptable values are: - "`paymentCaptured`" - "`paymentRejected`" - "`paymentSecured`" - "`pendingAuthorization`"
+ "refunds": [ # Refunds for the order.
{
- "quantityOrdered": 42, # Number of items ordered.
- "id": "A String", # The ID of the line item.
- "cancellations": [ # Cancellations of the line item.
+ "reasonText": "A String", # The explanation of the reason.
+ "actor": "A String", # The actor that created the refund. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
+ "reason": "A String", # The reason for the refund. Acceptable values are: - "`adjustment`" - "`autoPostInternal`" - "`autoPostInvalidBillingAddress`" - "`autoPostNoInventory`" - "`autoPostPriceError`" - "`autoPostUndeliverableShippingAddress`" - "`couponAbuse`" - "`courtesyAdjustment`" - "`customerCanceled`" - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`customerSupportRequested`" - "`deliveredLateByCarrier`" - "`deliveredTooLate`" - "`expiredItem`" - "`failToPushOrderGoogleError`" - "`failToPushOrderMerchantError`" - "`failToPushOrderMerchantFulfillmentError`" - "`failToPushOrderToMerchant`" - "`failToPushOrderToMerchantOutOfStock`" - "`feeAdjustment`" - "`invalidCoupon`" - "`lateShipmentCredit`" - "`malformedShippingAddress`" - "`merchantDidNotShipOnTime`" - "`noInventory`" - "`orderTimeout`" - "`other`" - "`paymentAbuse`" - "`paymentDeclined`" - "`priceAdjustment`" - "`priceError`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`promoReallocation`" - "`qualityNotAsExpected`" - "`returnRefundAbuse`" - "`shippingCostAdjustment`" - "`shippingPriceError`" - "`taxAdjustment`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`"
+ "amount": { # The amount that is refunded.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format.
+ },
+ ],
+ "shippingCost": { # The total cost of shipping for all items.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "customer": { # The details of the customer who placed the order.
+ "fullName": "A String", # Full name of the customer.
+ "invoiceReceivingEmail": "A String", # Email address for the merchant to send value-added tax or invoice documentation of the order. Only the last document sent is made available to the customer. For more information, see About automated VAT invoicing for Buy on Google.
+ "marketingRightsInfo": { # Customer's marketing preferences. Contains the marketing opt-in information that is current at the time that the merchant call. User preference selections can change from one order to the next so preferences must be checked with every order.
+ "explicitMarketingPreference": "A String", # Last known customer selection regarding marketing preferences. In certain cases this selection might not be known, so this field would be empty. If a customer selected `granted` in their most recent order, they can be subscribed to marketing emails. Customers who have chosen `denied` must not be subscribed, or must be unsubscribed if already opted-in. Acceptable values are: - "`denied`" - "`granted`"
+ "marketingEmailAddress": "A String", # Email address that can be used for marketing purposes. The field may be empty even if `explicitMarketingPreference` is 'granted'. This happens when retrieving an old order from the customer who deleted their account.
+ "lastUpdatedTimestamp": "A String", # Timestamp when last time marketing preference was updated. Could be empty, if user wasn't offered a selection yet.
+ },
+ "loyaltyInfo": { # Loyalty program information.
+ "loyaltyNumber": "A String", # The loyalty card/membership number.
+ "name": "A String", # Name of card/membership holder, this field will be populated when
+ },
+ },
+ "id": "A String", # The REST ID of the order. Globally unique.
+ "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#order`"
+ "billingAddress": { # The billing address.
+ "isPostOfficeBox": True or False, # Whether the address is a post office box.
+ "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
+ "A String",
+ ],
+ "recipientName": "A String", # Name of the recipient.
+ "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
+ "country": "A String", # CLDR country code (e.g. "US").
+ "streetAddress": [ # Street-level part of the address.
+ "A String",
+ ],
+ "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
+ "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
+ },
+ "shipments": [ # Shipments of the order.
+ {
+ "status": "A String", # The status of the shipment. Acceptable values are: - "`delivered`" - "`readyForPickup`" - "`shipped`" - "`undeliverable`"
+ "id": "A String", # The ID of the shipment.
+ "scheduledDeliveryDetails": { # Delivery details of the shipment if scheduling is needed.
+ "scheduledDate": "A String", # The date a shipment is scheduled for delivery, in ISO 8601 format.
+ "carrierPhoneNumber": "A String", # The phone number of the carrier fulfilling the delivery. The phone number is formatted as the international notation in ITU-T Recommendation E.123 (e.g., "+41 44 668 1800").
+ },
+ "creationDate": "A String", # Date on which the shipment has been created, in ISO 8601 format.
+ "carrier": "A String", # The carrier handling the shipment. For supported carriers, Google includes the carrier name and tracking URL in emails to customers. For select supported carriers, Google also automatically updates the shipment status based on the provided shipment ID. *Note:* You can also use unsupported carriers, but emails to customers will not include the carrier name or tracking URL, and there will be no automatic order status updates. Supported carriers for US are: - "`ups`" (United Parcel Service) *automatic status updates* - "`usps`" (United States Postal Service) *automatic status updates* - "`fedex`" (FedEx) *automatic status updates * - "`dhl`" (DHL eCommerce) *automatic status updates* (US only) - "`ontrac`" (OnTrac) *automatic status updates * - "`dhl express`" (DHL Express) - "`deliv`" (Deliv) - "`dynamex`" (TForce) - "`lasership`" (LaserShip) - "`mpx`" (Military Parcel Xpress) - "`uds`" (United Delivery Service) - "`efw`" (Estes Forwarding Worldwide) - "`jd logistics`" (JD Logistics) - "`yunexpress`" (YunExpress) - "`china post`" (China Post) - "`china ems`" (China Post Express Mail Service) - "`singapore post`" (Singapore Post) - "`pos malaysia`" (Pos Malaysia) - "`postnl`" (PostNL) - "`ptt`" (PTT Turkish Post) - "`eub`" (ePacket) - "`chukou1`" (Chukou1 Logistics) - "`bestex`" (Best Express) - "`canada post`" (Canada Post) - "`purolator`" (Purolator) - "`canpar`" (Canpar) - "`india post`" (India Post) - "`blue dart`" (Blue Dart) - "`delhivery`" (Delhivery) - "`dtdc`" (DTDC) - "`tpc india`" (TPC India) Supported carriers for FR are: - "`la poste`" (La Poste) *automatic status updates * - "`colissimo`" (Colissimo by La Poste) *automatic status updates* - "`ups`" (United Parcel Service) *automatic status updates * - "`chronopost`" (Chronopost by La Poste) - "`gls`" (General Logistics Systems France) - "`dpd`" (DPD Group by GeoPost) - "`bpost`" (Belgian Post Group) - "`colis prive`" (Colis Privé) - "`boxtal`" (Boxtal) - "`geodis`" (GEODIS) - "`tnt`" (TNT) - "`db schenker`" (DB Schenker) - "`aramex`" (Aramex)
+ "deliveryDate": "A String", # Date on which the shipment has been delivered, in ISO 8601 format. Present only if `status` is `delivered`
+ "lineItems": [ # The line items that are shipped.
{
- "reason": "A String", # The reason for the cancellation. Orders that are canceled with a noInventory reason will lead to the removal of the product from Buy on Google until you make an update to that product. This will not affect your Shopping ads. Acceptable values are: - "`autoPostInternal`" - "`autoPostInvalidBillingAddress`" - "`autoPostNoInventory`" - "`autoPostPriceError`" - "`autoPostUndeliverableShippingAddress`" - "`couponAbuse`" - "`customerCanceled`" - "`customerInitiatedCancel`" - "`customerSupportRequested`" - "`failToPushOrderGoogleError`" - "`failToPushOrderMerchantError`" - "`failToPushOrderMerchantFulfillmentError`" - "`failToPushOrderToMerchant`" - "`failToPushOrderToMerchantOutOfStock`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`merchantDidNotShipOnTime`" - "`noInventory`" - "`orderTimeout`" - "`other`" - "`paymentAbuse`" - "`paymentDeclined`" - "`priceError`" - "`returnRefundAbuse`" - "`shippingPriceError`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`"
- "actor": "A String", # The actor that created the cancellation. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
- "quantity": 42, # The quantity that was canceled.
- "reasonText": "A String", # The explanation of the reason.
- "creationDate": "A String", # Date on which the cancellation has been created, in ISO 8601 format.
+ "productId": "A String", # The ID of the product to ship. This is the REST ID used in the products service. Either lineItemId or productId is required.
+ "lineItemId": "A String", # The ID of the line item that is shipped. This value is assigned by Google when an order is created. Either lineItemId or productId is required.
+ "quantity": 42, # The quantity that is shipped.
},
],
+ "shipmentGroupId": "A String", # The shipment group ID of the shipment. This is set in shiplineitems request.
+ "trackingId": "A String", # The tracking ID for the shipment.
+ },
+ ],
+ "merchantOrderId": "A String", # Merchant-provided ID of the order.
+ "deliveryDetails": { # Delivery details for shipments of type `delivery`.
+ "phoneNumber": "A String", # The phone number of the person receiving the delivery.
+ "address": { # The delivery address
+ "isPostOfficeBox": True or False, # Whether the address is a post office box.
+ "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
+ "A String",
+ ],
+ "recipientName": "A String", # Name of the recipient.
+ "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
+ "country": "A String", # CLDR country code (e.g. "US").
+ "streetAddress": [ # Street-level part of the address.
+ "A String",
+ ],
+ "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
+ "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
+ },
+ },
+ "netPriceAmount": { # The net amount for the order (price part). For example, if an order was originally for $100 and a refund was issued for $20, the net amount will be $80.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "annotations": [ # List of key-value pairs that are attached to a given order.
+ {
+ "value": "A String", # Value for additional google provided (as key-value pairs) annotation.
+ "key": "A String", # Key for additional google provided (as key-value pairs) annotation.
+ },
+ ],
+ "status": "A String", # The status of the order. Acceptable values are: - "`canceled`" - "`delivered`" - "`inProgress`" - "`partiallyDelivered`" - "`partiallyReturned`" - "`partiallyShipped`" - "`pendingShipment`" - "`returned`" - "`shipped`"
+ "pickupDetails": { # Pickup details for shipments of type `pickup`.
+ "address": { # Address of the pickup location where the shipment should be sent. Note that `recipientName` in the address is the name of the business at the pickup location.
+ "isPostOfficeBox": True or False, # Whether the address is a post office box.
+ "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
+ "A String",
+ ],
+ "recipientName": "A String", # Name of the recipient.
+ "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
+ "country": "A String", # CLDR country code (e.g. "US").
+ "streetAddress": [ # Street-level part of the address.
+ "A String",
+ ],
+ "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
+ "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
+ },
+ "pickupType": "A String", # The pickup type of this order. Acceptable values are: - "`merchantStore`" - "`merchantStoreCurbside`" - "`merchantStoreLocker`" - "`thirdPartyPickupPoint`" - "`thirdPartyLocker`"
+ "locationId": "A String", # ID of the pickup location.
+ "collectors": [ # Collectors authorized to pick up shipment from the pickup location.
+ {
+ "phoneNumber": "A String", # Phone number of the person picking up the shipment.
+ "name": "A String", # Name of the person picking up the shipment.
+ },
+ ],
+ },
+ "promotions": [ # Promotions associated with the order. To determine which promotions apply to which products, check the `Promotions[].appliedItems[].lineItemId` field against the `LineItems[].id` field for each promotion. If a promotion is applied to more than 1 offerId, divide the discount value by the number of affected offers to determine how much discount to apply to each offerId. Examples: 1. To calculate price paid by the customer for a single line item including the discount: For each promotion, subtract the `LineItems[].adjustments[].priceAdjustment.value` amount from the `LineItems[].Price.value`. 2. To calculate price paid by the customer for a single line item including the discount in case of multiple quantity: For each promotion, divide the `LineItems[].adjustments[].priceAdjustment.value` by the quantity of products then subtract the resulting value from the `LineItems[].Product.Price.value` for each quantity item. Only 1 promotion can be applied to an offerId in a given order. To refund an item which had a promotion applied to it, make sure to refund the amount after first subtracting the promotion discount from the item price. More details about the program are here.
+ {
+ "priceValue": { # Estimated discount applied to price. Amount is pre-tax or post-tax depending on location of order.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "shortTitle": "A String", # A short title of the promotion to be shown on the checkout page. Do not provide for `orders.createtestorder`.
+ "endTime": "A String", # Promotion end time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
+ "taxValue": { # Estimated discount applied to tax (if allowed by law). Do not provide for `orders.createtestorder`.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "title": "A String", # Required. The title of the promotion.
+ "merchantPromotionId": "A String", # Required. This field is used to identify promotions within merchants' own systems.
+ "appliedItems": [ # Items that this promotion have been applied to. Do not provide for `orders.createtestorder`. This field will be empty for shipping promotions because shipping is not tied to any specific item.
+ {
+ "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
+ "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
+ "productId": "A String", # `orders.createtestorder`.
+ "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
+ },
+ ],
+ "funder": "A String", # Required. The party funding the promotion. Only `merchant` is supported for `orders.createtestorder`. Acceptable values are: - "`google`" - "`merchant`"
+ "startTime": "A String", # Promotion start time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
+ "type": "A String", # Required. The scope of the promotion. Only `product` is supported for `orders.createtestorder`. Acceptable values are: - "`product`" - "`shipping`"
+ "applicableItems": [ # Items that this promotion may be applied to. If empty, there are no restrictions on applicable items and quantity. This field will also be empty for shipping promotions because shipping is not tied to any specific item.
+ {
+ "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
+ "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
+ "productId": "A String", # `orders.createtestorder`.
+ "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
+ },
+ ],
+ "subtype": "A String", # Required. The category of the promotion. Only `moneyOff` is supported for `orders.createtestorder`. Acceptable values are: - "`buyMGetMoneyOff`" - "`buyMGetNMoneyOff`" - "`buyMGetNPercentOff`" - "`buyMGetPercentOff`" - "`freeGift`" - "`freeGiftWithItemId`" - "`freeGiftWithValue`" - "`freeShippingOvernight`" - "`freeShippingStandard`" - "`freeShippingTwoDay`" - "`moneyOff`" - "`percentOff`" - "`rewardPoints`" - "`salePrice`"
+ },
+ ],
+ "netTaxAmount": { # The net amount for the order (tax part). Note that in certain cases due to taxable base adjustment `netTaxAmount` might not match to a sum of tax field across all lineItems and refunds.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "placedDate": "A String", # The date when the order was placed, in ISO 8601 format.
+ "merchantId": "A String",
+ "lineItems": [ # Line items that are ordered.
+ {
+ "adjustments": [ # Price and tax adjustments applied on the line item.
+ {
+ "priceAdjustment": { # Adjustment for total price of the line item.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "type": "A String", # Type of this adjustment. Acceptable values are: - "`promotion`"
+ "taxAdjustment": { # Adjustment for total tax of the line item.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ },
+ ],
+ "quantityPending": 42, # Number of items pending.
+ "cancellations": [ # Cancellations of the line item.
+ {
+ "actor": "A String", # The actor that created the cancellation. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
+ "creationDate": "A String", # Date on which the cancellation has been created, in ISO 8601 format.
+ "reasonText": "A String", # The explanation of the reason.
+ "quantity": 42, # The quantity that was canceled.
+ "reason": "A String", # The reason for the cancellation. Orders that are canceled with a noInventory reason will lead to the removal of the product from Buy on Google until you make an update to that product. This will not affect your Shopping ads. Acceptable values are: - "`autoPostInternal`" - "`autoPostInvalidBillingAddress`" - "`autoPostNoInventory`" - "`autoPostPriceError`" - "`autoPostUndeliverableShippingAddress`" - "`couponAbuse`" - "`customerCanceled`" - "`customerInitiatedCancel`" - "`customerSupportRequested`" - "`failToPushOrderGoogleError`" - "`failToPushOrderMerchantError`" - "`failToPushOrderMerchantFulfillmentError`" - "`failToPushOrderToMerchant`" - "`failToPushOrderToMerchantOutOfStock`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`merchantDidNotShipOnTime`" - "`noInventory`" - "`orderTimeout`" - "`other`" - "`paymentAbuse`" - "`paymentDeclined`" - "`priceError`" - "`returnRefundAbuse`" - "`shippingPriceError`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`"
+ },
+ ],
+ "price": { # Total price for the line item. For example, if two items for $10 are purchased, the total price will be $20.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "returnInfo": { # Details of the return policy for the line item.
+ "isReturnable": True or False, # Required. Whether the item is returnable.
+ "daysToReturn": 42, # Required. How many days later the item can be returned.
+ "policyUrl": "A String", # Required. URL of the item return policy.
+ },
+ "quantityUndeliverable": 42, # Number of items undeliverable.
+ "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.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "quantityReturned": 42, # Number of items returned.
+ "quantityShipped": 42, # Number of items shipped.
+ "quantityReadyForPickup": 42, # Number of items ready for pickup.
+ "quantityOrdered": 42, # Number of items ordered.
"annotations": [ # Annotations that are attached to the line item.
{
"value": "A String", # Value for additional merchant provided (as key-value pairs) annotation about the line item.
"key": "A String", # Key for additional merchant provided (as key-value pairs) annotation about the line item.
},
],
- "quantityDelivered": 42, # Number of items delivered.
- "quantityUndeliverable": 42, # Number of items undeliverable.
"quantityCanceled": 42, # Number of items canceled.
- "quantityShipped": 42, # Number of items shipped.
- "returns": [ # Returns of the line item.
- {
- "reason": "A String", # The reason for the return. Acceptable values are: - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`deliveredTooLate`" - "`expiredItem`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`other`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`qualityNotAsExpected`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`"
- "actor": "A String", # The actor that created the refund. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
- "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format.
- "reasonText": "A String", # The explanation of the reason.
- "quantity": 42, # Quantity that is returned.
+ "shippingDetails": { # Details of the requested shipping for the line item.
+ "shipByDate": "A String", # Required. The ship by date, in ISO 8601 format.
+ "type": "A String", # Type of shipment. Indicates whether `deliveryDetails` or `pickupDetails` is applicable for this shipment. Acceptable values are: - "`delivery`" - "`pickup`"
+ "method": { # Required. Details of the shipping method.
+ "carrier": "A String", # The carrier for the shipping. Optional. See `shipments[].carrier` for a list of acceptable values.
+ "methodName": "A String", # Required. The name of the shipping method.
+ "maxDaysInTransit": 42, # Required. Maximum transit time.
+ "minDaysInTransit": 42, # Required. Minimum transit time.
},
- ],
- "quantityReadyForPickup": 42, # Number of items ready for pickup.
- "price": { # Total price for the line item. For example, if two items for $10 are purchased, the total price will be $20.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
+ "deliverByDate": "A String", # Required. The delivery by date, in ISO 8601 format.
+ "pickupPromiseInMinutes": 42, # The promised time in minutes in which the order will be ready for pickup. This only applies to buy-online-pickup-in-store same-day order.
},
- "quantityPending": 42, # Number of items pending.
"product": { # Product data as seen by customer from the time of the order placement. Note that certain attributes values (e.g. title or gtin) might be reformatted and no longer match values submitted via product feed.
- "id": "A String", # The REST ID of the product.
+ "shownImage": "A String", # URL to the cached image shown to the user when order was placed.
+ "mpn": "A String", # Manufacturer Part Number (MPN) of the item.
"targetCountry": "A String", # The CLDR territory // code of the target country of the product.
+ "gtin": "A String", # Global Trade Item Number (GTIN) of the item.
+ "itemGroupId": "A String", # Shared identifier for all variants of the same product.
+ "offerId": "A String", # An identifier of the item.
+ "condition": "A String", # Condition or state of the item. Acceptable values are: - "`new`" - "`refurbished`" - "`used`"
+ "contentLanguage": "A String", # The two-letter ISO 639-1 language code for the item.
+ "price": { # Price of the item.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "id": "A String", # The REST ID of the product.
+ "brand": "A String", # Brand of the item.
"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.
{
"dimension": "A String", # The dimension of the variant.
@@ -1393,230 +1587,36 @@
"fees": [ # Associated fees at order creation time.
{
"amount": { # Amount of the fee.
- "value": "A String", # The price represented as a number.
"currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
},
"name": "A String", # Name of the fee.
},
],
"imageLink": "A String", # URL of an image of the item.
"title": "A String", # The title of the product.
- "shownImage": "A String", # URL to the cached image shown to the user when order was placed.
- "price": { # Price of the item.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "condition": "A String", # Condition or state of the item. Acceptable values are: - "`new`" - "`refurbished`" - "`used`"
- "gtin": "A String", # Global Trade Item Number (GTIN) of the item.
- "itemGroupId": "A String", # Shared identifier for all variants of the same product.
- "contentLanguage": "A String", # The two-letter ISO 639-1 language code for the item.
- "offerId": "A String", # An identifier of the item.
- "brand": "A String", # Brand of the item.
- "mpn": "A String", # Manufacturer Part Number (MPN) of the item.
},
- "returnInfo": { # Details of the return policy for the line item.
- "daysToReturn": 42, # Required. How many days later the item can be returned.
- "isReturnable": True or False, # Required. Whether the item is returnable.
- "policyUrl": "A String", # Required. URL of the item return policy.
- },
- "adjustments": [ # Price and tax adjustments applied on the line item.
+ "returns": [ # Returns of the line item.
{
- "priceAdjustment": { # Adjustment for total price of the line item.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "taxAdjustment": { # Adjustment for total tax of the line item.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "type": "A String", # Type of this adjustment. Acceptable values are: - "`promotion`"
+ "reasonText": "A String", # The explanation of the reason.
+ "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format.
+ "quantity": 42, # Quantity that is returned.
+ "actor": "A String", # The actor that created the refund. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
+ "reason": "A String", # The reason for the return. Acceptable values are: - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`deliveredTooLate`" - "`expiredItem`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`other`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`qualityNotAsExpected`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`"
},
],
- "shippingDetails": { # Details of the requested shipping for the line item.
- "shipByDate": "A String", # Required. The ship by date, in ISO 8601 format.
- "deliverByDate": "A String", # Required. The delivery by date, in ISO 8601 format.
- "type": "A String", # Type of shipment. Indicates whether `deliveryDetails` or `pickupDetails` is applicable for this shipment. Acceptable values are: - "`delivery`" - "`pickup`"
- "method": { # Required. Details of the shipping method.
- "carrier": "A String", # The carrier for the shipping. Optional. See `shipments[].carrier` for a list of acceptable values.
- "methodName": "A String", # Required. The name of the shipping method.
- "minDaysInTransit": 42, # Required. Minimum transit time.
- "maxDaysInTransit": 42, # Required. Maximum transit time.
- },
- "pickupPromiseInMinutes": 42, # The promised time in minutes in which the order will be ready for pickup. This only applies to buy-online-pickup-in-store same-day order.
- },
- "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.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "quantityReturned": 42, # Number of items returned.
+ "quantityDelivered": 42, # Number of items delivered.
+ "id": "A String", # The ID of the line item.
},
],
- "promotions": [ # Promotions associated with the order. To determine which promotions apply to which products, check the `Promotions[].appliedItems[].lineItemId` field against the `LineItems[].id` field for each promotion. If a promotion is applied to more than 1 offerId, divide the discount value by the number of affected offers to determine how much discount to apply to each offerId. Examples: 1. To calculate price paid by the customer for a single line item including the discount: For each promotion, subtract the `LineItems[].adjustments[].priceAdjustment.value` amount from the `LineItems[].Price.value`. 2. To calculate price paid by the customer for a single line item including the discount in case of multiple quantity: For each promotion, divide the `LineItems[].adjustments[].priceAdjustment.value` by the quantity of products then subtract the resulting value from the `LineItems[].Product.Price.value` for each quantity item. Only 1 promotion can be applied to an offerId in a given order. To refund an item which had a promotion applied to it, make sure to refund the amount after first subtracting the promotion discount from the item price. More details about the program are here.
- {
- "appliedItems": [ # Items that this promotion have been applied to. Do not provide for `orders.createtestorder`. This field will be empty for shipping promotions because shipping is not tied to any specific item.
- {
- "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
- "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
- "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
- "productId": "A String", # `orders.createtestorder`.
- },
- ],
- "funder": "A String", # Required. The party funding the promotion. Only `merchant` is supported for `orders.createtestorder`. Acceptable values are: - "`google`" - "`merchant`"
- "subtype": "A String", # Required. The category of the promotion. Only `moneyOff` is supported for `orders.createtestorder`. Acceptable values are: - "`buyMGetMoneyOff`" - "`buyMGetNMoneyOff`" - "`buyMGetNPercentOff`" - "`buyMGetPercentOff`" - "`freeGift`" - "`freeGiftWithItemId`" - "`freeGiftWithValue`" - "`freeShippingOvernight`" - "`freeShippingStandard`" - "`freeShippingTwoDay`" - "`moneyOff`" - "`percentOff`" - "`rewardPoints`" - "`salePrice`"
- "type": "A String", # Required. The scope of the promotion. Only `product` is supported for `orders.createtestorder`. Acceptable values are: - "`product`" - "`shipping`"
- "endTime": "A String", # Promotion end time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
- "startTime": "A String", # Promotion start time in ISO 8601 format. Date, time, and offset required, e.g., "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z".
- "shortTitle": "A String", # A short title of the promotion to be shown on the checkout page. Do not provide for `orders.createtestorder`.
- "taxValue": { # Estimated discount applied to tax (if allowed by law). Do not provide for `orders.createtestorder`.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "title": "A String", # Required. The title of the promotion.
- "merchantPromotionId": "A String", # Required. This field is used to identify promotions within merchants' own systems.
- "priceValue": { # Estimated discount applied to price. Amount is pre-tax or post-tax depending on location of order.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "applicableItems": [ # Items that this promotion may be applied to. If empty, there are no restrictions on applicable items and quantity. This field will also be empty for shipping promotions because shipping is not tied to any specific item.
- {
- "lineItemId": "A String", # The line item ID of a product. Do not provide for `orders.createtestorder`.
- "quantity": 42, # The quantity of the associated product. Do not provide for `orders.createtestorder`.
- "offerId": "A String", # Required. Offer ID of a product. Only for `orders.createtestorder`.
- "productId": "A String", # `orders.createtestorder`.
- },
- ],
- },
- ],
- "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#order`"
- "netTaxAmount": { # The net amount for the order (tax part). Note that in certain cases due to taxable base adjustment `netTaxAmount` might not match to a sum of tax field across all lineItems and refunds.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "annotations": [ # List of key-value pairs that are attached to a given order.
- {
- "value": "A String", # Value for additional google provided (as key-value pairs) annotation.
- "key": "A String", # Key for additional google provided (as key-value pairs) annotation.
- },
- ],
- "placedDate": "A String", # The date when the order was placed, in ISO 8601 format.
- "shipments": [ # Shipments of the order.
- {
- "creationDate": "A String", # Date on which the shipment has been created, in ISO 8601 format.
- "scheduledDeliveryDetails": { # Delivery details of the shipment if scheduling is needed.
- "scheduledDate": "A String", # The date a shipment is scheduled for delivery, in ISO 8601 format.
- "carrierPhoneNumber": "A String", # The phone number of the carrier fulfilling the delivery. The phone number is formatted as the international notation in ITU-T Recommendation E.123 (e.g., "+41 44 668 1800").
- },
- "id": "A String", # The ID of the shipment.
- "lineItems": [ # The line items that are shipped.
- {
- "quantity": 42, # The quantity that is shipped.
- "lineItemId": "A String", # The ID of the line item that is shipped. This value is assigned by Google when an order is created. Either lineItemId or productId is required.
- "productId": "A String", # The ID of the product to ship. This is the REST ID used in the products service. Either lineItemId or productId is required.
- },
- ],
- "trackingId": "A String", # The tracking ID for the shipment.
- "carrier": "A String", # The carrier handling the shipment. For supported carriers, Google includes the carrier name and tracking URL in emails to customers. For select supported carriers, Google also automatically updates the shipment status based on the provided shipment ID. *Note:* You can also use unsupported carriers, but emails to customers will not include the carrier name or tracking URL, and there will be no automatic order status updates. Supported carriers for US are: - "`ups`" (United Parcel Service) *automatic status updates* - "`usps`" (United States Postal Service) *automatic status updates* - "`fedex`" (FedEx) *automatic status updates * - "`dhl`" (DHL eCommerce) *automatic status updates* (US only) - "`ontrac`" (OnTrac) *automatic status updates * - "`dhl express`" (DHL Express) - "`deliv`" (Deliv) - "`dynamex`" (TForce) - "`lasership`" (LaserShip) - "`mpx`" (Military Parcel Xpress) - "`uds`" (United Delivery Service) - "`efw`" (Estes Forwarding Worldwide) - "`jd logistics`" (JD Logistics) - "`yunexpress`" (YunExpress) - "`china post`" (China Post) - "`china ems`" (China Post Express Mail Service) - "`singapore post`" (Singapore Post) - "`pos malaysia`" (Pos Malaysia) - "`postnl`" (PostNL) - "`ptt`" (PTT Turkish Post) - "`eub`" (ePacket) - "`chukou1`" (Chukou1 Logistics) - "`bestex`" (Best Express) - "`canada post`" (Canada Post) - "`purolator`" (Purolator) - "`canpar`" (Canpar) - "`india post`" (India Post) - "`blue dart`" (Blue Dart) - "`delhivery`" (Delhivery) - "`dtdc`" (DTDC) - "`tpc india`" (TPC India) Supported carriers for FR are: - "`la poste`" (La Poste) *automatic status updates * - "`colissimo`" (Colissimo by La Poste) *automatic status updates* - "`ups`" (United Parcel Service) *automatic status updates * - "`chronopost`" (Chronopost by La Poste) - "`gls`" (General Logistics Systems France) - "`dpd`" (DPD Group by GeoPost) - "`bpost`" (Belgian Post Group) - "`colis prive`" (Colis Privé) - "`boxtal`" (Boxtal) - "`geodis`" (GEODIS) - "`tnt`" (TNT) - "`db schenker`" (DB Schenker) - "`aramex`" (Aramex)
- "deliveryDate": "A String", # Date on which the shipment has been delivered, in ISO 8601 format. Present only if `status` is `delivered`
- "shipmentGroupId": "A String", # The shipment group ID of the shipment. This is set in shiplineitems request.
- "status": "A String", # The status of the shipment. Acceptable values are: - "`delivered`" - "`readyForPickup`" - "`shipped`" - "`undeliverable`"
- },
- ],
- "id": "A String", # The REST ID of the order. Globally unique.
- "refunds": [ # Refunds for the order.
- {
- "amount": { # The amount that is refunded.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "actor": "A String", # The actor that created the refund. Acceptable values are: - "`customer`" - "`googleBot`" - "`googleCustomerService`" - "`googlePayments`" - "`googleSabre`" - "`merchant`"
- "reasonText": "A String", # The explanation of the reason.
- "reason": "A String", # The reason for the refund. Acceptable values are: - "`adjustment`" - "`autoPostInternal`" - "`autoPostInvalidBillingAddress`" - "`autoPostNoInventory`" - "`autoPostPriceError`" - "`autoPostUndeliverableShippingAddress`" - "`couponAbuse`" - "`courtesyAdjustment`" - "`customerCanceled`" - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`customerSupportRequested`" - "`deliveredLateByCarrier`" - "`deliveredTooLate`" - "`expiredItem`" - "`failToPushOrderGoogleError`" - "`failToPushOrderMerchantError`" - "`failToPushOrderMerchantFulfillmentError`" - "`failToPushOrderToMerchant`" - "`failToPushOrderToMerchantOutOfStock`" - "`feeAdjustment`" - "`invalidCoupon`" - "`lateShipmentCredit`" - "`malformedShippingAddress`" - "`merchantDidNotShipOnTime`" - "`noInventory`" - "`orderTimeout`" - "`other`" - "`paymentAbuse`" - "`paymentDeclined`" - "`priceAdjustment`" - "`priceError`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`promoReallocation`" - "`qualityNotAsExpected`" - "`returnRefundAbuse`" - "`shippingCostAdjustment`" - "`shippingPriceError`" - "`taxAdjustment`" - "`taxError`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`"
- "creationDate": "A String", # Date on which the item has been created, in ISO 8601 format.
- },
- ],
- "status": "A String", # The status of the order. Acceptable values are: - "`canceled`" - "`delivered`" - "`inProgress`" - "`partiallyDelivered`" - "`partiallyReturned`" - "`partiallyShipped`" - "`pendingShipment`" - "`returned`" - "`shipped`"
- "merchantOrderId": "A String", # Merchant-provided ID of the order.
- "deliveryDetails": { # Delivery details for shipments of type `delivery`.
- "address": { # The delivery address
- "recipientName": "A String", # Name of the recipient.
- "country": "A String", # CLDR country code (e.g. "US").
- "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
- "isPostOfficeBox": True or False, # Whether the address is a post office box.
- "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
- "A String",
- ],
- "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
- "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
- "streetAddress": [ # Street-level part of the address.
- "A String",
- ],
- },
- "phoneNumber": "A String", # The phone number of the person receiving the delivery.
- },
"shippingCostTax": { # The tax for the total shipping cost.
- "value": "A String", # The price represented as a number.
"currency": "A String", # The currency of the price.
- },
- "paymentStatus": "A String", # The status of the payment. Acceptable values are: - "`paymentCaptured`" - "`paymentRejected`" - "`paymentSecured`" - "`pendingAuthorization`"
- "customer": { # The details of the customer who placed the order.
- "loyaltyInfo": { # Loyalty program information.
- "loyaltyNumber": "A String", # The loyalty card/membership number.
- "name": "A String", # Name of card/membership holder, this field will be populated when
- },
- "fullName": "A String", # Full name of the customer.
- "invoiceReceivingEmail": "A String", # Email address for the merchant to send value-added tax or invoice documentation of the order. Only the last document sent is made available to the customer. For more information, see About automated VAT invoicing for Buy on Google.
- "marketingRightsInfo": { # Customer's marketing preferences. Contains the marketing opt-in information that is current at the time that the merchant call. User preference selections can change from one order to the next so preferences must be checked with every order.
- "lastUpdatedTimestamp": "A String", # Timestamp when last time marketing preference was updated. Could be empty, if user wasn't offered a selection yet.
- "explicitMarketingPreference": "A String", # Last known customer selection regarding marketing preferences. In certain cases this selection might not be known, so this field would be empty. If a customer selected `granted` in their most recent order, they can be subscribed to marketing emails. Customers who have chosen `denied` must not be subscribed, or must be unsubscribed if already opted-in. Acceptable values are: - "`denied`" - "`granted`"
- "marketingEmailAddress": "A String", # Email address that can be used for marketing purposes. The field may be empty even if `explicitMarketingPreference` is 'granted'. This happens when retrieving an old order from the customer who deleted their account.
- },
- },
- "shippingCost": { # The total cost of shipping for all items.
"value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
},
- "pickupDetails": { # Pickup details for shipments of type `pickup`.
- "address": { # Address of the pickup location where the shipment should be sent. Note that `recipientName` in the address is the name of the business at the pickup location.
- "recipientName": "A String", # Name of the recipient.
- "country": "A String", # CLDR country code (e.g. "US").
- "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
- "isPostOfficeBox": True or False, # Whether the address is a post office box.
- "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
- "A String",
- ],
- "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
- "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
- "streetAddress": [ # Street-level part of the address.
- "A String",
- ],
- },
- "locationId": "A String", # ID of the pickup location.
- "pickupType": "A String", # The pickup type of this order. Acceptable values are: - "`merchantStore`" - "`merchantStoreCurbside`" - "`merchantStoreLocker`" - "`thirdPartyPickupPoint`" - "`thirdPartyLocker`"
- "collectors": [ # Collectors authorized to pick up shipment from the pickup location.
- {
- "phoneNumber": "A String", # Phone number of the person picking up the shipment.
- "name": "A String", # Name of the person picking up the shipment.
- },
- ],
- },
- "billingAddress": { # The billing address.
- "recipientName": "A String", # Name of the recipient.
- "country": "A String", # CLDR country code (e.g. "US").
- "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
- "isPostOfficeBox": True or False, # Whether the address is a post office box.
- "fullAddress": [ # Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States
- "A String",
- ],
- "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
- "postalCode": "A String", # Postal Code or ZIP (e.g. "94043").
- "streetAddress": [ # Street-level part of the address.
- "A String",
- ],
- },
+ "taxCollector": "A String", # The party responsible for collecting and remitting taxes. Acceptable values are: - "`marketplaceFacilitator`" - "`merchant`"
+ "acknowledged": True or False, # Whether the order was acknowledged.
},
],
- "nextPageToken": "A String", # The token for the retrieval of the next page of orders.
- "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#ordersListResponse".
}</pre>
</div>
@@ -1645,34 +1645,34 @@
The object takes the form of:
{
- "reason": "A String", # The reason for the refund. Acceptable values are: - "`shippingCostAdjustment`" - "`priceAdjustment`" - "`taxAdjustment`" - "`feeAdjustment`" - "`courtesyAdjustment`" - "`adjustment`" - "`customerCancelled`" - "`noInventory`" - "`productNotAsDescribed`" - "`undeliverableShippingAddress`" - "`wrongProductShipped`" - "`lateShipmentCredit`" - "`deliveredLateByCarrier`" - "`productArrivedDamaged`"
- "reasonText": "A String", # The explanation of the reason.
- "items": [ # The items that are refunded. Either Item or Shipping must be provided in the request.
- {
- "productId": "A String", # The ID of the product. This is the REST ID used in the products service. Either lineItemId or productId is required.
- "amount": { # The total amount that is refunded. (e.g. refunding $5 each for 2 products should be done by setting quantity to 2 and amount to 10$) In case of multiple refunds, this should be the amount you currently want to refund to the customer.
- "priceAmount": { # The pre-tax or post-tax price depends on the location of the order. - For countries (e.g. US) where price attribute excludes tax, this field corresponds to the pre-tax value. - For coutries (e.g. France) where price attribute includes tax, this field corresponds to the post-tax value .
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- "taxAmount": { # Tax value, present only for countries where price attribute excludes tax (e.g. US). No tax is referenced as 0 value with the corresponding `currency`.
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
- },
- "quantity": 42, # The number of products that are refunded.
- "lineItemId": "A String", # The ID of the line item. Either lineItemId or productId is required.
- "fullRefund": True or False, # If true, the full item will be refunded. If this is true, amount should not be provided and will be ignored.
- },
- ],
"shipping": { # The refund on shipping. Optional, but either Item or Shipping must be provided in the request.
"amount": { # The amount that is refunded. If this is not the first refund for the shipment, this should be the newly refunded amount.
- "value": "A String", # The price represented as a number.
"currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
},
"fullRefund": True or False, # If set to true, all shipping costs for the order will be refunded. If this is true, amount should not be provided and will be ignored.
},
"operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
+ "reason": "A String", # The reason for the refund. Acceptable values are: - "`shippingCostAdjustment`" - "`priceAdjustment`" - "`taxAdjustment`" - "`feeAdjustment`" - "`courtesyAdjustment`" - "`adjustment`" - "`customerCancelled`" - "`noInventory`" - "`productNotAsDescribed`" - "`undeliverableShippingAddress`" - "`wrongProductShipped`" - "`lateShipmentCredit`" - "`deliveredLateByCarrier`" - "`productArrivedDamaged`"
+ "items": [ # The items that are refunded. Either Item or Shipping must be provided in the request.
+ {
+ "productId": "A String", # The ID of the product. This is the REST ID used in the products service. Either lineItemId or productId is required.
+ "amount": { # The total amount that is refunded. (e.g. refunding $5 each for 2 products should be done by setting quantity to 2 and amount to 10$) In case of multiple refunds, this should be the amount you currently want to refund to the customer.
+ "taxAmount": { # Tax value, present only for countries where price attribute excludes tax (e.g. US). No tax is referenced as 0 value with the corresponding `currency`.
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "priceAmount": { # The pre-tax or post-tax price depends on the location of the order. - For countries (e.g. US) where price attribute excludes tax, this field corresponds to the pre-tax value. - For coutries (e.g. France) where price attribute includes tax, this field corresponds to the post-tax value .
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ },
+ "fullRefund": True or False, # If true, the full item will be refunded. If this is true, amount should not be provided and will be ignored.
+ "lineItemId": "A String", # The ID of the line item. Either lineItemId or productId is required.
+ "quantity": 42, # The number of products that are refunded.
+ },
+ ],
+ "reasonText": "A String", # The explanation of the reason.
}
x__xgafv: string, V1 error format.
@@ -1700,20 +1700,20 @@
The object takes the form of:
{
- "operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
- "reason": "A String", # The reason for the refund. Acceptable values are: - "`courtesyAdjustment`" - "`other`"
+ "fullRefund": True or False, # If true, the full order will be refunded, including shipping. If this is true, amount should not be provided and will be ignored.
"amount": { # The amount that is refunded. If this is not the first refund for the order, this should be the newly refunded amount.
- "priceAmount": { # The pre-tax or post-tax price depends on the location of the order. - For countries (e.g. US) where price attribute excludes tax, this field corresponds to the pre-tax value. - For coutries (e.g. France) where price attribute includes tax, this field corresponds to the post-tax value .
- "value": "A String", # The price represented as a number.
- "currency": "A String", # The currency of the price.
- },
"taxAmount": { # Tax value, present only for countries where price attribute excludes tax (e.g. US). No tax is referenced as 0 value with the corresponding `currency`.
- "value": "A String", # The price represented as a number.
"currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
+ },
+ "priceAmount": { # The pre-tax or post-tax price depends on the location of the order. - For countries (e.g. US) where price attribute excludes tax, this field corresponds to the pre-tax value. - For coutries (e.g. France) where price attribute includes tax, this field corresponds to the post-tax value .
+ "currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
},
},
"reasonText": "A String", # The explanation of the reason.
- "fullRefund": True or False, # If true, the full order will be refunded, including shipping. If this is true, amount should not be provided and will be ignored.
+ "reason": "A String", # The reason for the refund. Acceptable values are: - "`courtesyAdjustment`" - "`other`"
+ "operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
}
x__xgafv: string, V1 error format.
@@ -1725,8 +1725,8 @@
An object of the form:
{
- "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#ordersRefundOrderResponse".
"executionStatus": "A String", # The status of the execution. Acceptable values are: - "`duplicate`" - "`executed`"
+ "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#ordersRefundOrderResponse".
}</pre>
</div>
@@ -1741,12 +1741,12 @@
The object takes the form of:
{
+ "productId": "A String", # The ID of the product to return. This is the REST ID used in the products service. Either lineItemId or productId is required.
+ "quantity": 42, # The quantity to return and refund.
+ "reason": "A String", # The reason for the return. Acceptable values are: - "`damagedOrUsed`" - "`missingComponent`" - "`notEligible`" - "`other`" - "`outOfReturnWindow`"
"reasonText": "A String", # The explanation of the reason.
"lineItemId": "A String", # The ID of the line item to return. Either lineItemId or productId is required.
- "quantity": 42, # The quantity to return and refund.
"operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
- "reason": "A String", # The reason for the return. Acceptable values are: - "`damagedOrUsed`" - "`missingComponent`" - "`notEligible`" - "`other`" - "`outOfReturnWindow`"
- "productId": "A String", # The ID of the product to return. This is the REST ID used in the products service. Either lineItemId or productId is required.
}
x__xgafv: string, V1 error format.
@@ -1758,8 +1758,8 @@
An object of the form:
{
- "executionStatus": "A String", # The status of the execution. Acceptable values are: - "`duplicate`" - "`executed`"
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#ordersRejectReturnLineItemResponse".
+ "executionStatus": "A String", # The status of the execution. Acceptable values are: - "`duplicate`" - "`executed`"
}</pre>
</div>
@@ -1774,20 +1774,20 @@
The object takes the form of:
{
- "reason": "A String", # The reason for the return. Acceptable values are: - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`deliveredTooLate`" - "`expiredItem`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`other`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`qualityNotAsExpected`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`"
- "operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
+ "reasonText": "A String", # The explanation of the reason.
"priceAmount": { # The amount to be refunded. This may be pre-tax or post-tax depending on the location of the order. If omitted, refundless return is assumed.
- "value": "A String", # The price represented as a number.
"currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
},
- "lineItemId": "A String", # The ID of the line item to return. Either lineItemId or productId is required.
"taxAmount": { # The amount of tax to be refunded. Optional, but if filled, then priceAmount must be set. Calculated automatically if not provided.
- "value": "A String", # The price represented as a number.
"currency": "A String", # The currency of the price.
+ "value": "A String", # The price represented as a number.
},
"productId": "A String", # The ID of the product to return. This is the REST ID used in the products service. Either lineItemId or productId is required.
+ "lineItemId": "A String", # The ID of the line item to return. Either lineItemId or productId is required.
"quantity": 42, # The quantity to return and refund.
- "reasonText": "A String", # The explanation of the reason.
+ "reason": "A String", # The reason for the return. Acceptable values are: - "`customerDiscretionaryReturn`" - "`customerInitiatedMerchantCancel`" - "`deliveredTooLate`" - "`expiredItem`" - "`invalidCoupon`" - "`malformedShippingAddress`" - "`other`" - "`productArrivedDamaged`" - "`productNotAsDescribed`" - "`qualityNotAsExpected`" - "`undeliverableShippingAddress`" - "`unsupportedPoBoxAddress`" - "`wrongProductShipped`"
+ "operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
}
x__xgafv: string, V1 error format.
@@ -1799,8 +1799,8 @@
An object of the form:
{
- "executionStatus": "A String", # The status of the execution. Acceptable values are: - "`duplicate`" - "`executed`"
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#ordersReturnRefundLineItemResponse".
+ "executionStatus": "A String", # The status of the execution. Acceptable values are: - "`duplicate`" - "`executed`"
}</pre>
</div>
@@ -1815,15 +1815,15 @@
The object takes the form of:
{
+ "productId": "A String", # The ID of the product to set metadata. This is the REST ID used in the products service. Either lineItemId or productId is required.
+ "lineItemId": "A String", # The ID of the line item to set metadata. Either lineItemId or productId is required.
+ "operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
"annotations": [
{
"value": "A String", # Value for additional merchant provided (as key-value pairs) annotation about the line item.
"key": "A String", # Key for additional merchant provided (as key-value pairs) annotation about the line item.
},
],
- "operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
- "lineItemId": "A String", # The ID of the line item to set metadata. Either lineItemId or productId is required.
- "productId": "A String", # The ID of the product to set metadata. This is the REST ID used in the products service. Either lineItemId or productId is required.
}
x__xgafv: string, V1 error format.
@@ -1835,8 +1835,8 @@
An object of the form:
{
- "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#ordersSetLineItemMetadataResponse".
"executionStatus": "A String", # The status of the execution. Acceptable values are: - "`duplicate`" - "`executed`"
+ "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#ordersSetLineItemMetadataResponse".
}</pre>
</div>
@@ -1851,22 +1851,22 @@
The object takes the form of:
{
+ "operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
"lineItems": [ # Line items to ship.
{
- "quantity": 42, # The quantity that is shipped.
- "lineItemId": "A String", # The ID of the line item that is shipped. This value is assigned by Google when an order is created. Either lineItemId or productId is required.
"productId": "A String", # The ID of the product to ship. This is the REST ID used in the products service. Either lineItemId or productId is required.
+ "lineItemId": "A String", # The ID of the line item that is shipped. This value is assigned by Google when an order is created. Either lineItemId or productId is required.
+ "quantity": 42, # The quantity that is shipped.
},
],
- "operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
- "shipmentGroupId": "A String", # ID of the shipment group. Required for orders that use the orderinvoices service.
"shipmentInfos": [ # Shipment information. This field is repeated because a single line item can be shipped in several packages (and have several tracking IDs).
{
+ "carrier": "A String", # The carrier handling the shipment. See `shipments[].carrier` in the Orders resource representation for a list of acceptable values.
"trackingId": "A String", # The tracking ID for the shipment.
"shipmentId": "A String", # Required. The ID of the shipment. This is assigned by the merchant and is unique to each shipment.
- "carrier": "A String", # The carrier handling the shipment. See `shipments[].carrier` in the Orders resource representation for a list of acceptable values.
},
],
+ "shipmentGroupId": "A String", # ID of the shipment group. Required for orders that use the orderinvoices service.
}
x__xgafv: string, V1 error format.
@@ -1895,10 +1895,10 @@
{
"productId": "A String", # The ID of the product to set metadata. This is the REST ID used in the products service. Either lineItemId or productId is required.
- "shipByDate": "A String", # Updated ship by date, in ISO 8601 format. If not specified only deliver by date is updated. Provided date should be within 1 year timeframe and can not be a date in the past.
"lineItemId": "A String", # The ID of the line item to set metadata. Either lineItemId or productId is required.
- "deliverByDate": "A String", # Updated delivery by date, in ISO 8601 format. If not specified only ship by date is updated. Provided date should be within 1 year timeframe and can not be a date in the past.
"operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
+ "shipByDate": "A String", # Updated ship by date, in ISO 8601 format. If not specified only deliver by date is updated. Provided date should be within 1 year timeframe and can not be a date in the past.
+ "deliverByDate": "A String", # Updated delivery by date, in ISO 8601 format. If not specified only ship by date is updated. Provided date should be within 1 year timeframe and can not be a date in the past.
}
x__xgafv: string, V1 error format.
@@ -1939,8 +1939,8 @@
An object of the form:
{
- "executionStatus": "A String", # The status of the execution. Acceptable values are: - "`duplicate`" - "`executed`"
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#ordersUpdateMerchantOrderIdResponse".
+ "executionStatus": "A String", # The status of the execution. Acceptable values are: - "`duplicate`" - "`executed`"
}</pre>
</div>
@@ -1955,15 +1955,15 @@
The object takes the form of:
{
- "shipmentId": "A String", # The ID of the shipment.
- "undeliveredDate": "A String", # Date on which the shipment has been undeliverable, in ISO 8601 format. Optional and can be provided only if `status` is `undeliverable`.
- "trackingId": "A String", # The tracking ID for the shipment. Not updated if missing.
- "carrier": "A String", # The carrier handling the shipment. Not updated if missing. See `shipments[].carrier` in the Orders resource representation for a list of acceptable values.
"operationId": "A String", # The ID of the operation. Unique across all operations for a given order.
+ "trackingId": "A String", # The tracking ID for the shipment. Not updated if missing.
+ "undeliveredDate": "A String", # Date on which the shipment has been undeliverable, in ISO 8601 format. Optional and can be provided only if `status` is `undeliverable`.
"deliveryDate": "A String", # Date on which the shipment has been delivered, in ISO 8601 format. Optional and can be provided only if `status` is `delivered`.
+ "shipmentId": "A String", # The ID of the shipment.
"status": "A String", # New status for the shipment. Not updated if missing. Acceptable values are: - "`delivered`" - "`undeliverable`" - "`readyForPickup`"
- "readyPickupDate": "A String", # Date on which the shipment has been ready for pickup, in ISO 8601 format. Optional and can be provided only if `status` is `ready for pickup`.
"lastPickupDate": "A String", # Date after which the pickup will expire, in ISO 8601 format. Required only when order is buy-online-pickup-in-store(BOPIS) and `status` is `ready for pickup`.
+ "readyPickupDate": "A String", # Date on which the shipment has been ready for pickup, in ISO 8601 format. Optional and can be provided only if `status` is `ready for pickup`.
+ "carrier": "A String", # The carrier handling the shipment. Not updated if missing. See `shipments[].carrier` in the Orders resource representation for a list of acceptable values.
}
x__xgafv: string, V1 error format.