オンライン返品ポリシーを作成、管理する

このページでは、オンラインの返品に関するポリシーを確認する方法について説明します。

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 UI を使用して返品に関するポリシーを作成することもできます。詳しくは、ショッピング広告と無料リスティングの返品に関するポリシーを設定するをご覧ください。Merchant Center で返品に関するポリシーを作成した後、ポリシーが審査され、利用可能になるまでには最大 10 営業日かかることがあります。