Return labels

Merchants can use the orderreturns.labels.create method to upload a return shipping label, link it to an existing return in Merchant Center, and email the label to the customer after an order return is initiated.

Merchants can manage returns in two ways:

Google facilitated returns

Google can generate return labels automatically if you provide your return shipping carrier in Merchant Center. When a customer wants to return an item, Google automatically generates the return label and sends it to the customer.

Merchant-managed returns

If you don't provide your return carrier information in Merchant Center, you're responsible for generating return labels for every return request. You can manually create return labels in Merchant Center, or upload individual labels and tracking information through orderreturns.labels.create.

See Switch how you manage your Buy on Google returns for more information.

Workflow

Here's a diagram of the returns workflow including orderreturns.labels.create:

orderreturns.labels.create

You can use orderreturns.labels.create to upload a return shipping label to Merchant Center and link it to a returnId.

Warning: You can't modify the shipping label after it's sent to the customer.

This method sends the first shipping label uploaded to a returnId to the customer, and any following attempts to upload a label to the same returnId fail with 403: Label already exists

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/orderreturns/returnId/labels

Here's a sample request:

{
 "labelUri": "https://www.rollo.com/wp-content/uploads/2017/01/Labels-Sample.pdf",
 "carrier": "UPS",
 "trackingId": "1ZY677920370074034"
}

Note: This may take up to 10 seconds to complete.

Here's a sample response:

{
  "labelUri": "https://www.rollo.com/wp-content/uploads/2017/01/Labels-Sample.pdf",
  "carrier": "UPS",
  "trackingId": "1ZY677920370074034"
}