建立及管理線上退貨政策

本頁面提供如何查看線上退貨政策的相關資訊。

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 欄位代表線上退貨政策的專屬 ID。

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 UI 建立退貨政策。詳情請參閱「設定購物廣告和免費產品資訊的退貨政策」。在 Merchant Center 中建立退貨政策後，政策最慢可能需要 10 個工作天才能完成審查並開始生效。