创建和管理在线退货政策

本页面介绍了如何查看您的线上退货政策。

Merchant API 支持以下用于检索线上退货政策的方法：

作为最佳实践，请确保访问您网站的所有用户均可发现并查看您的退货政策，而无需登录、注册或输入任何个人信息。此外，还要确保 Merchant Center 与网站中的退货政策一致。

检索现有线上退货政策

如需检索现有的线上退货政策，请使用 accounts.onlineReturnPolicies.get 方法。

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/onlineReturnPolicies/{ONLINE_RETURN_POLICY_ID}

请求成功后，响应会包含 OnlineReturnPolicy 资源，如以下示例所示：

{
  "onlineReturnPolicies": [
    {
      "returnPolicyId": "ONLINE_RETURN_POLICY_ID",
      "label": "default",
      "countries": [
        "COUNTRY_CODE"
      ],
      "policy": {
        "type": "NO_RETURNS"
      },
      "restockingFee": {
        "fixedFee": {
          "amountMicros": "0",
          "currencyCode": "USD"
        }
      },
      "returnPolicyUri": "RETURN_POLICY_URI"
    }
  ]
}

值 NO_RETURNS 表示相应国家/地区不支持退货。

响应正文中的 restockingFee 字段表示重新上架费，可以是固定费用，也可以是商品价格（以微为单位）的百分比。

列出所有线上退货政策

如需列出所有线上退货政策，请使用 accounts.onlineReturnPolicies.list 方法，如以下请求所示：

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/onlineReturnPolicies

请求成功后，响应会包含相应账号的所有现有线上退货政策，如以下示例响应所示：

{
  "onlineReturnPolicies": [
    {
      "returnPolicyId": "7216992546",
      "label": "default",
      "countries": [
        "IN"
      ],
      "policy": {
        "type": "NO_RETURNS"
      },
      "restockingFee": {
        "fixedFee": {
          "amountMicros": "0",
          "currencyCode": "USD"
        }
      },
      "returnPolicyUri": "http://example-pet-store.com/return"
    },
    {
      "returnPolicyId": "7274318400",
      "label": "default",
      "countries": [
        "GB"
      ],
      "policy": {
        "type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
        "days": "15"
      },
      "restockingFee": {
        "fixedFee": {
          "amountMicros": "10000000",
          "currencyCode": "GBP"
        }
      },
      "returnMethods": [
        "AT_A_KIOSK"
      ],
      "itemConditions": [
        "NEW"
      ],
      "returnShippingFee": {
        "type": "FIXED",
        "fixedFee": {
          "amountMicros": "0",
          "currencyCode": "GBP"
        }
      },
      "returnPolicyUri": "http://example-pet-store.com/return-new",
      "processRefundDays": 7,
      "acceptExchange": true
    }
  ]
}

在此响应正文中，returnPolicyId 字段表示线上退货政策的唯一标识符。

returnMethods 字段表示允许的退货方式。AT_A_KIOSK 表示商品可以在自助服务终端退货。其他可能的值包括 IN_STORE 和 BY_MAIL。

processRefundDays 字段用于指定卖家处理退款所需的天数。

创建在线退货政策

如需创建退货政策，请使用以下请求：

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/onlineReturnPolicies/{ONLINE_RETURN_POLICY_ID}

{
  "label": "label", "countries": ["US"],
"policy": {"type": "NO_RETURNS"},
"returnPolicyUri": "https://www.uri.com"
}

以下是成功调用的示例响应：

{
  "name": "accounts/ACCOUNT_ID/onlineReturnPolicies/ONLINE_RETURN_POLICY",
  "returnPolicyId": "ONLINE_RETURN_POLICY",
  "label": "label",
  "countries": ["US"],
  "policy": {
    "type": "NO_RETURNS"
  },
  "returnShippingFee": {
    "type": "FIXED",
    "fixedFee": {
      "amountMicros": "0",
      "currencyCode": ""
    }
  },
  "returnPolicyUri": "https://www.uri.com"
}

您还可以使用 Merchant Center 界面创建退货政策。如需了解详情，请参阅为购物广告和非付费商品详情设置退货政策。在 Merchant Center 中创建退货政策后，该政策最多可能需要 10 个工作日才能通过审核并生效。