Returnpolicy

For a list of methods for this resource, see the end of this page.

Resource representations

Return policy resource.

{
  "kind": "content#returnPolicy",
  "returnPolicyId": string,
  "label": string,
  "country": string,
  "name": string,
  "policy": {
    "type": string,
    "numberOfDays": long,
    "lastReturnDate": string
  },
  "seasonalOverrides": [
    {
      "name": string,
      "startDate": string,
      "endDate": string,
      "policy": {
        "type": string,
        "numberOfDays": long,
        "lastReturnDate": string
      }
    }
  ],
  "nonFreeReturnReasons": [
    string
  ]
}
Property name Value Description Notes
country string The country of sale where the return policy is applicable. writable
kind string Identifies what kind of resource this is. Value: the fixed string "content#returnPolicy".
label string The user-defined label of the return policy. For the default policy, use the label "default". writable
name string The name of the policy as shown in Merchant Center. writable
nonFreeReturnReasons[] list Return reasons that will incur return fees. writable
policy nested object The policy. writable
policy.lastReturnDate string Last day for returning the items. In ISO 8601 format. When specifying the return window like this, set the policy type to "lastReturnDate". Use this for seasonal overrides only. writable
policy.numberOfDays long The number of days items can be returned after delivery, where one day is defined to be 24 hours after the delivery timestamp. When specifying the return window like this, set the policy type to "numberOfDaysAfterDelivery". Acceptable values are 30, 45, 60, 90, 100, 180, 270 and 365 for the default policy. Additional policies further allow 14, 15, 21 and 28 days, but note that for most items a minimum of 30 days is required for returns. Exceptions may be made for electronics. A policy of less than 30 days can only be applied to those items. writable
policy.type string Policy type. Use "lastReturnDate" for seasonal overrides only. Note that for most items a minimum of 30 days is required for returns. Exceptions may be made for electronics or non-returnable items such as food, perishables, and living things. A policy of less than 30 days can only be applied to those items.

Acceptable values are:
  • "lastReturnDate"
  • "lifetimeReturns"
  • "noReturns"
  • "numberOfDaysAfterDelivery"
writable
returnPolicyId string Return policy ID generated by Google.
seasonalOverrides[] list An optional list of seasonal overrides. writable
seasonalOverrides[].endDate string Last day on which the override applies. In ISO 8601 format. writable
seasonalOverrides[].name string The name of the seasonal override as shown in Merchant Center. writable
seasonalOverrides[].policy nested object The policy which is in effect during that time. writable
seasonalOverrides[].policy.lastReturnDate string Last day for returning the items. In ISO 8601 format. When specifying the return window like this, set the policy type to "lastReturnDate". Use this for seasonal overrides only. writable
seasonalOverrides[].policy.numberOfDays long The number of days items can be returned after delivery, where one day is defined to be 24 hours after the delivery timestamp. When specifying the return window like this, set the policy type to "numberOfDaysAfterDelivery". Acceptable values are 30, 45, 60, 90, 100, 180, 270 and 365 for the default policy. Additional policies further allow 14, 15, 21 and 28 days, but note that for most items a minimum of 30 days is required for returns. Exceptions may be made for electronics. A policy of less than 30 days can only be applied to those items. writable
seasonalOverrides[].policy.type string Policy type. Use "lastReturnDate" for seasonal overrides only. Note that for most items a minimum of 30 days is required for returns. Exceptions may be made for electronics or non-returnable items such as food, perishables, and living things. A policy of less than 30 days can only be applied to those items.

Acceptable values are:
  • "lastReturnDate"
  • "lifetimeReturns"
  • "noReturns"
  • "numberOfDaysAfterDelivery"
writable
seasonalOverrides[].startDate string First day on which the override applies. In ISO 8601 format. writable

Methods

custombatch
Batches multiple return policy related calls in a single request.
delete
Deletes a return policy for the given Merchant Center account.
get
Gets a return policy of the Merchant Center account.
insert
Inserts a return policy for the Merchant Center account.
list
Lists the return policies of the Merchant Center account.