Version v2 of the Content API is scheduled for sunset on September 30th, 2021. Onboarding to v2 ended on April 30, 2021. To avoid disruptions with your integration, please migrate to v2.1 as soon as possible.

For more information, see Migrating to v2.1 and this blog post.

Method: orderreturns.labels.create

Links a return shipping label to a return id. You can only create one return label per return id. Since the label is sent to the buyer, the linked return label cannot be updated or deleted. If you try to create multiple return shipping labels for a single return id, every create request except the first will fail.

HTTP request

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

Path parameters

Parameters
merchantId

string (int64 format)

Required. The merchant the Return Shipping Label belongs to.

returnId

string

Required. Provide the Google-generated merchant order return ID.

Request body

The request body contains an instance of ReturnShippingLabel.

Response body

If successful, the response body contains a newly created instance of ReturnShippingLabel.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview.