このページでは、オンラインの返品に関するポリシーを表示する方法について説明します。
Merchant API は、オンライン返品ポリシーを取得するための次のメソッドをサポートしています。
オンラインの返品に関するポリシーを作成するには、Merchant Center の管理画面を使用する必要があります。詳しくは、ショッピング広告と無料リスティングの返品に関するポリシーを設定するをご覧ください。Merchant Center で返品に関するポリシーを作成した後、ポリシーが審査されて利用可能になるまでに最長で 10 営業日かかることがあります。
ベスト プラクティスとして、ウェブサイトにアクセスするすべてのユーザーが、ログイン、登録、個人情報の入力を行わなくても、返品に関するポリシーを見つけてアクセスできるようにしてください。また、返品に関するポリシーが Merchant Center と貴社のウェブサイトの間で一致していることを確認してください。
既存のオンライン返品に関するポリシーを取得する
既存のオンライン返品ポリシーを取得するには、accounts.onlineReturnPolicies.get メソッドを使用します。
GET https://merchantapi.googleapis.com/accounts/v1beta/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/v1beta/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 フィールドには、販売者が払い戻しを処理するまでに要する日数を指定します。