このページでは、オンラインの返品に関するポリシーを表示する方法について説明します。
Merchant API では、オンラインの返品に関するポリシーを取得するために次のメソッドがサポートされています。
- accounts.onlineReturnPolicies.get
- accounts.onlineReturnPolicies.list
- accounts.onlineReturnPolicies.create
効果的な手法として、返品に関するポリシーは、ウェブサイトを訪れるすべてのユーザーがログイン、登録、個人情報の入力を行わなくてもアクセスできるようにしてください。また、返品に関するポリシーが 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 営業日かかることがあります。