配送設定

shippingsettings リソースを使用すると、マルチクライアントの配送設定を取得、更新できます。 アカウント(MCA)とそれに関連付けられているすべてのサブアカウント。

MCA は通常、Google が運用する 複数の販売者のオンライン ショップと API サービスを管理する。次のような 複数のオンライン ショップやブランドが別々のウェブサイトで販売されている場合は、 1 つの MCA でサブアカウントを使用する。

一部の商品では、目安のお届け日数が自動的に更新されることがあります。 詳しくは、自動 改善をご覧ください。

shippingsettings.list

shippingsettings.list 呼び出しは、次の配送リソース情報をすべて返します。 またはすべてのサブアカウント(MCA アカウントを扱う場合)にのみ影響します。

shippingsettings.list メソッドの URL の例:

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shippingsettings

次のサンプル JSON レスポンスは、 MCA アカウントのサブアカウント 11112222:

{
 
"kind": "content#shippingsettingsListResponse",
 
"resources": [
 
{
   
"accountId": "1111",
   
"services": [
   
{
     
"name": "Standard Shipping",
     
"active": true,
     
"deliveryCountry": "US",
     
"currency": "USD",
     
"deliveryTime": {
     
"minHandlingTimeInDays": 0,
     
"maxHandlingTimeInDays": 1,
     
"transitTimeTable": {
       
"postalCodeGroupNames": [
       
"Region1",
       
"Region2",
       
"all other locations"
       
],
       
"transitTimeLabels": [
       
"all other labels"
       
],
       
"rows": [
       
{
         
"values": [
         
{
           
"minTransitTimeInDays": 1,
           
"maxTransitTimeInDays": 2
         
}
         
]
       
},
       
{
         
"values": [
         
{
           
"minTransitTimeInDays": 2,
           
"maxTransitTimeInDays": 3
         
}
         
]
       
},
       
{
         
"values": [
         
{
           
"minTransitTimeInDays": 3,
           
"maxTransitTimeInDays": 5
         
}
         
]
       
}
       
]
     
}
     
},
     
"rateGroups": [
     
{
       
"singleValue": {
       
"flatRate": {
         
"value": "0",
         
"currency": "USD"
       
}
       
},
       
"name": "Standard Shipping"
     
}
     
],
     
"eligibility": "All scenarios"
   
},
   
{
     
"name": "Expedited",
     
"active": true,
     
"deliveryCountry": "US",
     
"currency": "USD",
     
"deliveryTime": {
     
"minTransitTimeInDays": 2,
     
"maxTransitTimeInDays": 2,
     
"minHandlingTimeInDays": 0,
     
"maxHandlingTimeInDays": 1
     
},
     
"rateGroups": [
     
{
       
"singleValue": {
       
"flatRate": {
         
"value": "9.99",
         
"currency": "USD"
       
}
       
},
       
"name": "Expedited"
     
}
     
],
     
"eligibility": "All scenarios"
   
}
   
],
   
"postalCodeGroups": [
   
{
     
"name": "Region1",
     
"country": "US",
     
"postalCodeRanges": [
     
{
       
"postalCodeRangeBegin": "94035",
       
"postalCodeRangeEnd": "94070"
     
}
     
]
   
},
   
{
     
"name": "Region2",
     
"country": "US",
     
"postalCodeRanges": [
     
{
       
"postalCodeRangeBegin": "94071",
       
"postalCodeRangeEnd": "94082"
     
}
     
]
   
}
   
]
 
},
 
{
   
"accountId": "2222",
   
"services": [
   
{
     
"name": "FedEx",
     
"active": true,
     
"deliveryCountry": "US",
     
"currency": "USD",
     
"deliveryTime": {
     
"minTransitTimeInDays": 4,
     
"maxTransitTimeInDays": 6,
     
"minHandlingTimeInDays": 0,
     
"maxHandlingTimeInDays": 0
     
},
     
"rateGroups": [
     
{
       
"singleValue": {
       
"flatRate": {
         
"value": "5.99",
         
"currency": "USD"
       
}
       
},
       
"name": "All products"
     
}
     
],
     
"eligibility": "All scenarios except Shopping Actions"
   
},
   
{
     
"name": "GSA Shipping - Free Ship Over $49.99",
     
"active": true,
     
"deliveryCountry": "US",
     
"currency": "USD",
     
"deliveryTime": {
     
"minTransitTimeInDays": 3,
     
"maxTransitTimeInDays": 7,
     
"minHandlingTimeInDays": 1,
     
"maxHandlingTimeInDays": 2
     
},
     
"rateGroups": [
     
{
       
"mainTable": {
       
"rowHeaders": {
         
"prices": [
         
{
           
"value": "49.99",
           
"currency": "USD"
         
},
         
{
           
"value": "infinity",
           
"currency": "USD"
         
}
         
]
       
},
       
"rows": [
         
{
         
"cells": [
           
{
           
"flatRate": {
             
"value": "6.99",
             
"currency": "USD"
           
}
           
}
         
]
         
},
         
{
         
"cells": [
           
{
           
"flatRate": {
             
"value": "0",
             
"currency": "USD"
           
}
           
}
         
]
         
}
       
]
       
},
       
"name": "Free Ship Over $49.99"
     
}
     
],
     
"eligibility": "Shopping Actions"
   
}
   
]
 
}
 
]
}

shippingsettings.get

shippingsettings.get 呼び出しにより、MCA アカウントで送料を取得できます。 個々のサブアカウント、またはスタンドアロン アカウントの設定情報を 固有のアカウントステータス情報が提供されます。

配送設定を取得するには、次の呼び出しを使用します。 情報。merchantId は MCA のアカウント番号、accountId サブアカウントになります。Merchant Center アカウントがマルチクライアント アカウントでない場合、 shippingsettings.get は引き続き配送設定情報を返送できます。この merchantIdaccountId パラメータ。

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shippingsettings/accountId

以下は、Standard があるサブアカウントの JSON レスポンスの例です。 と、該当の配送に使用された MCA アカウントで Expedited の配送サービスが list 呼び出し:

{
 
"accountId": "1111",
 
"services": [
 
{
   
"name": "Standard Shipping",
   
"active": true,
   
"deliveryCountry": "US",
   
"currency": "USD",
   
"deliveryTime": {
   
"minHandlingTimeInDays": 0,
   
"maxHandlingTimeInDays": 1,
   
"transitTimeTable": {
     
"postalCodeGroupNames": [
     
"Region1",
     
"Region2",
     
"all other locations"
     
],
     
"transitTimeLabels": [
     
"all other labels"
     
],
     
"rows": [
     
{
       
"values": [
       
{
         
"minTransitTimeInDays": 1,
         
"maxTransitTimeInDays": 2
       
}
       
]
     
},
     
{
       
"values": [
       
{
         
"minTransitTimeInDays": 2,
         
"maxTransitTimeInDays": 3
       
}
       
]
     
},
     
{
       
"values": [
       
{
         
"minTransitTimeInDays": 3,
         
"maxTransitTimeInDays": 5
       
}
       
]
     
}
     
]
   
}
   
},
   
"rateGroups": [
   
{
     
"singleValue": {
     
"flatRate": {
       
"value": "0",
       
"currency": "USD"
     
}
     
},
     
"name": "Standard Shipping"
   
}
   
],
   
"eligibility": "All scenarios"
 
},
 
{
   
"name": "Expedited",
   
"active": true,
   
"deliveryCountry": "US",
   
"currency": "USD",
   
"deliveryTime": {
   
"minTransitTimeInDays": 2,
   
"maxTransitTimeInDays": 2,
   
"minHandlingTimeInDays": 0,
   
"maxHandlingTimeInDays": 1
   
},
   
"rateGroups": [
   
{
     
"singleValue": {
     
"flatRate": {
       
"value": "9.99",
       
"currency": "USD"
     
}
     
},
     
"name": "Expedited"
   
}
   
],
   
"eligibility": "All scenarios"
 
}
 
],
 
"postalCodeGroups": [
 
{
   
"name": "Region1",
   
"country": "US",
   
"postalCodeRanges": [
   
{
     
"postalCodeRangeBegin": "94035",
     
"postalCodeRangeEnd": "94070"
   
}
   
]
 
},
 
{
   
"name": "Region2",
   
"country": "US",
   
"postalCodeRanges": [
   
{
     
"postalCodeRangeBegin": "94071",
     
"postalCodeRangeEnd": "94082"
   
}
   
]
 
}
 
]
}

shippingsettings.update

shippingsettings.update 呼び出しを使用すると、MCA アカウントで 送料設定の情報を変更することもできます。

PUT https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shippingsettings/accountId

maxTransitTimeInDays を更新する JSON リクエスト本文の例を次に示します。 配送先 7、配送サービス GSA Shipping - Free Ship Over $49.99、料金 MCA の変更 ID 10 内のアカウント ID 2222 のサブアカウントです。

{
...
   
"services": [
     
{
       
"name": "FedEx",
       
"active": true,
       
"deliveryCountry": "US",
       
"currency": "USD",
       
"deliveryTime": {
         
"minTransitTimeInDays": 4,
         
"maxTransitTimeInDays": 6,
         
"minHandlingTimeInDays": 0,
         
"maxHandlingTimeInDays": 0
       
},
       
"rateGroups": [
         
{
           
"singleValue": {
             
"flatRate": {
               
"value": "5.99",
               
"currency": "USD"
             
}
           
},
           
"name": "All products"
         
}
       
],
       
"eligibility": "All scenarios except Shopping Actions"
     
},
     
{
       
"name": "GSA Shipping - Free Ship Over $49.99",
       
"active": true,
       
"deliveryCountry": "US",
       
"currency": "USD",
       
"deliveryTime": {
         
"minTransitTimeInDays": 3,
         
"maxTransitTimeInDays": 7,
         
"minHandlingTimeInDays": 1,
         
"maxHandlingTimeInDays": 2
       
},
       
"rateGroups": [
         
{
           
"mainTable": {
             
"rowHeaders": {
               
"prices": [
                 
{
                   
"value": "49.99",
                   
"currency": "USD"
                 
},
                 
{
                   
"value": "infinity",
                   
"currency": "USD"
                 
}
               
]
             
},
             
"rows": [
               
{
                 
"cells": [
                   
{
                     
"flatRate": {
                       
"value": "6.99",
                       
"currency": "USD"
                     
}
                   
}
                 
]
               
},
               
{
                 
"cells": [
                   
{
                     
"flatRate": {
                       
"value": "0",
                       
"currency": "USD"
                     
}
                   
}
                 
]
               
}
             
]
           
},
           
"name": "Free Ship Over $49.99"
         
}
       
],
       
"eligibility": "Shopping Actions"
     
}
   
]
 
}
}

JSON レスポンスの本文の例を次に示します。

{
 
"accountId": "2222",
 
"services": [
 
{
   
"name": "FedEx",
   
"active": true,
   
"deliveryCountry": "US",
   
"currency": "USD",
   
"deliveryTime": {
   
"minTransitTimeInDays": 4,
   
"maxTransitTimeInDays": 6,
   
"minHandlingTimeInDays": 0,
   
"maxHandlingTimeInDays": 0
   
},
   
"rateGroups": [
   
{
     
"singleValue": {
     
"flatRate": {
       
"value": "5.99",
       
"currency": "USD"
     
}
     
},
     
"name": "All products"
   
}
   
],
   
"eligibility": "All scenarios except Shopping Actions"
 
},
 
{
   
"name": "GSA Shipping - Free Ship Over $49.99",
   
"active": true,
   
"deliveryCountry": "US",
   
"currency": "USD",
   
"deliveryTime": {
   
"minTransitTimeInDays": 3,
   
"maxTransitTimeInDays": 7,
   
"minHandlingTimeInDays": 1,
   
"maxHandlingTimeInDays": 2
   
},
   
"rateGroups": [
   
{
     
"mainTable": {
     
"rowHeaders": {
       
"prices": [
       
{
         
"value": "49.99",
         
"currency": "USD"
       
},
       
{
         
"value": "infinity",
         
"currency": "USD"
       
}
       
]
     
},
     
"rows": [
       
{
       
"cells": [
         
{
         
"flatRate": {
           
"value": "6.99",
           
"currency": "USD"
         
}
         
}
       
]
       
},
       
{
       
"cells": [
         
{
         
"flatRate": {
           
"value": "0",
           
"currency": "USD"
         
}
         
}
       
]
       
}
     
]
     
},
     
"name": "Free Ship Over $49.99"
   
}
   
],
   
"eligibility": "Shopping Actions"
 
}
 
]
}

shippingsettings.custombatch

shippingsettings.custombatch 呼び出しで配送設定を取得または更新する マルチクライアント アカウントの複数のサブアカウントに関する情報。

JSON リクエストには、MCA のアカウント番号の merchantId、 サブアカウントの accountId、一意の batchIdmethod を 配送設定を取得する get と、送料を変更する update 設定。

POST https://shoppingcontent.googleapis.com/content/v2.1/shippingsettings/batch

次のサンプル JSON リクエスト本文には 2 つの部分があります。

  1. アカウント ID 1111 の配送設定の取得に使用される batchId=1
  2. batchId=2。次のサービスの maxTransitTimeInDays8 に更新するために使用されます。 配送サービス: GSA Shipping - Free Ship Over $49.99。(以前の 前のレスポンス本文に表示されていたアカウント ID 22227 から変更されました (例: shippingsettings.update)。
{
 
"entries": [
   
{
     
"accountId": 1111,
     
"merchantId": 10,
     
"method": "get",
     
"batchId": 1
   
},
   
{
     
"accountId": 2222,
     
"merchantId": 10,
     
"method": "update",
     
"batchId": 2,
     
"shippingSettings": {
       
"services": [
         
{
           
"name": "FedEx",
           
"active": true,
           
"deliveryCountry": "US",
           
"currency": "USD",
           
"deliveryTime": {
             
"minTransitTimeInDays": 4,
             
"maxTransitTimeInDays": 5,
             
"minHandlingTimeInDays": 0,
             
"maxHandlingTimeInDays": 0
           
},
           
"rateGroups": [
             
{
               
"singleValue": {
                 
"flatRate": {
                   
"value": "5.99",
                   
"currency": "USD"
                 
}
               
},
               
"name": "All products"
             
}
           
],
           
"eligibility": "All scenarios except Shopping Actions"
         
},
         
{
           
"name": "GSA Shipping - Free Ship Over $49.99",
           
"active": true,
           
"deliveryCountry": "US",
           
"currency": "USD",
           
"deliveryTime": {
             
"minTransitTimeInDays": 3,
             
"maxTransitTimeInDays": 8,
             
"minHandlingTimeInDays": 1,
             
"maxHandlingTimeInDays": 2
           
},
           
"rateGroups": [
             
{
               
"mainTable": {
                 
"rowHeaders": {
                   
"prices": [
                     
{
                       
"value": "49.99",
                       
"currency": "USD"
                     
},
                     
{
                       
"value": "infinity",
                       
"currency": "USD"
                     
}
                   
]
                 
},
                 
"rows": [
                   
{
                     
"cells": [
                       
{
                         
"flatRate": {
                           
"value": "6.99",
                           
"currency": "USD"
                         
}
                       
}
                     
]
                   
},
                   
{
                     
"cells": [
                       
{
                         
"flatRate": {
                           
"value": "0",
                           
"currency": "USD"
                         
}
                       
}
                     
]
                   
}
                 
]
               
},
               
"name": "Free Ship Over $49.99"
             
}
           
],
           
"eligibility": "Shopping Actions"
         
}
       
]
     
}
   
}
 
]
}

JSON レスポンスの本文の例を次に示します。

{
 
"kind": "content#shippingsettingsCustomBatchResponse",
 
"entries": [
 
{
   
"kind": "content#shippingsettingsCustomBatchResponseEntry",
   
"batchId": 1,
   
"shippingSettings": {
   
"accountId": "1111",
   
"services": [
     
{
     
"name": "Standard Shipping",
     
"active": true,
     
"deliveryCountry": "US",
     
"currency": "USD",
     
"deliveryTime": {
       
"minHandlingTimeInDays": 0,
       
"maxHandlingTimeInDays": 1,
       
"transitTimeTable": {
       
"postalCodeGroupNames": [
         
"Region1",
         
"Region2",
         
"all other locations"
       
],
       
"transitTimeLabels": [
         
"all other labels"
       
],
       
"rows": [
         
{
         
"values": [
           
{
           
"minTransitTimeInDays": 1,
           
"maxTransitTimeInDays": 2
           
}
         
]
         
},
         
{
         
"values": [
           
{
           
"minTransitTimeInDays": 2,
           
"maxTransitTimeInDays": 3
           
}
         
]
         
},
         
{
         
"values": [
           
{
           
"minTransitTimeInDays": 3,
           
"maxTransitTimeInDays": 5
           
}
         
]
         
}
       
]
       
}
     
},
     
"rateGroups": [
       
{
       
"singleValue": {
         
"flatRate": {
         
"value": "0",
         
"currency": "USD"
         
}
       
},
       
"name": "Standard Shipping"
       
}
     
],
     
"eligibility": "All scenarios"
     
},
     
{
     
"name": "Expedited",
     
"active": true,
     
"deliveryCountry": "US",
     
"currency": "USD",
     
"deliveryTime": {
       
"minTransitTimeInDays": 2,
       
"maxTransitTimeInDays": 2,
       
"minHandlingTimeInDays": 0,
       
"maxHandlingTimeInDays": 1
     
},
     
"rateGroups": [
       
{
       
"singleValue": {
         
"flatRate": {
         
"value": "9.99",
         
"currency": "USD"
         
}
       
},
       
"name": "Expedited"
       
}
     
],
     
"eligibility": "All scenarios"
     
}
   
],
   
"postalCodeGroups": [
     
{
     
"name": "Region1",
     
"country": "US",
     
"postalCodeRanges": [
       
{
       
"postalCodeRangeBegin": "94035",
       
"postalCodeRangeEnd": "94070"
       
}
     
]
     
},
     
{
     
"name": "Region2",
     
"country": "US",
     
"postalCodeRanges": [
       
{
       
"postalCodeRangeBegin": "94071",
       
"postalCodeRangeEnd": "94082"
       
}
     
]
     
}
   
]
   
}
 
},
 
{
   
"kind": "content#shippingsettingsCustomBatchResponseEntry",
   
"batchId": 2,
   
"shippingSettings": {
   
"accountId": "2222",
   
"services": [
     
{
     
"name": "FedEx",
     
"active": true,
     
"deliveryCountry": "US",
     
"currency": "USD",
     
"deliveryTime": {
       
"minTransitTimeInDays": 4,
       
"maxTransitTimeInDays": 5,
       
"minHandlingTimeInDays": 0,
       
"maxHandlingTimeInDays": 0
     
},
     
"rateGroups": [
       
{
       
"singleValue": {
         
"flatRate": {
         
"value": "5.99",
         
"currency": "USD"
         
}
       
},
       
"name": "All products"
       
}
     
],
     
"eligibility": "All scenarios except Shopping Actions"
     
},
     
{
     
"name": "GSA Shipping - Free Ship Over $49.99",
     
"active": true,
     
"deliveryCountry": "US",
     
"currency": "USD",
     
"deliveryTime": {
       
"minTransitTimeInDays": 3,
       
"maxTransitTimeInDays": 8,
       
"minHandlingTimeInDays": 1,
       
"maxHandlingTimeInDays": 2
     
},
     
"rateGroups": [
       
{
       
"mainTable": {
         
"rowHeaders": {
         
"prices": [
           
{
           
"value": "49.99",
           
"currency": "USD"
           
},
           
{
           
"value": "infinity",
           
"currency": "USD"
           
}
         
]
         
},
         
"rows": [
         
{
           
"cells": [
           
{
             
"flatRate": {
             
"value": "6.99",
             
"currency": "USD"
             
}
           
}
           
]
         
},
         
{
           
"cells": [
           
{
             
"flatRate": {
             
"value": "0",
             
"currency": "USD"
             
}
           
}
           
]
         
}
         
]
       
},
       
"name": "Free Ship Over $49.99"
       
}
     
],
     
"eligibility": "Shopping Actions"
     
}
   
]
   
}
 
}
 
]
}

shippingsettings.getsupportedcarriers

shippingsettings.getsupportedcarriers の呼び出しにより MCA アカウントが許可されます またはスタンドアロンのアカウントを使用して、対応している携帯通信会社を入手してください。

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/supportedCarriers

JSON レスポンスの本文の例を次に示します。

{
 
"kind": "content#shippingsettingsGetSupportedCarriersResponse",
 
"carriers": [
 
{
   
"name": "FedEx",
   
"country": "US",
   
"services": [
   
"Ground",
   
"Home Delivery",
   
"Express Saver",
   
"First Overnight",
   
"Priority Overnight",
   
"Standard Overnight",
   
"2Day"
   
]
 
},
 
{
   
"name": "UPS",
   
"country": "US",
   
"services": [
   
"2nd Day Air",
   
"2nd Day Air AM",
   
"3 Day Select",
   
"Ground",
   
"Next Day Air",
   
"Next Day Air Early AM",
   
"Next Day Air Saver"
   
]
 
},
 
{
   
"name": "USPS",
   
"country": "US",
   
"services": [
   
"Priority Mail Express",
   
"Media Mail",
   
"Retail Ground",
   
"Priority Mail",
   
"First Class Package Service Retail",
   
"First Class Package Service Commercial Base"
   
]
 
},
 
{
   
"name": "Australia Post",
   
"country": "AU",
   
"services": [
   
"Regular Parcel",
   
"Express Post"
   
]
 
},
 
{
   
"name": "TNT",
   
"country": "AU",
   
"services": [
   
"Road Express",
   
"Overnight Express"
   
]
 
},
 
{
   
"name": "TOLL",
   
"country": "AU",
   
"services": [
   
"Road Delivery",
   
"Overnight Priority"
   
]
 
},
 
{
   
"name": "DHL",
   
"country": "DE",
   
"services": [
   
"Paket",
   
"Päckchen"
   
]
 
},
 
{
   
"name": "DPD",
   
"country": "DE",
   
"services": [
   
"Express 12",
   
"Express",
   
"Classic Parcel"
   
]
 
},
 
{
   
"name": "Hermes",
   
"country": "DE",
   
"services": [
   
"Päckchen",
   
"Paketklasse S",
   
"Paketklasse M",
   
"Paketklasse L"
   
]
 
},
 
{
   
"name": "UPS",
   
"country": "DE",
   
"services": [
   
"Express",
   
"Express Saver",
   
"Standard"
   
]
 
},
 
{
   
"name": "DHL UK",
   
"country": "GB",
   
"services": [
   
"Express",
   
"Express 12"
   
]
 
},
 
{
   
"name": "DPD UK",
   
"country": "GB",
   
"services": [
   
"Express 12",
   
"Express Next Day",
   
"Standard Parcel 12",
   
"Standard Parcel Next Day",
   
"Standard Parcel Two Day"
   
]
 
},
 
{
   
"name": "RMG",
   
"country": "GB",
   
"services": [
   
"1st Class Small Parcel",
   
"1st Class Medium Parcel",
   
"2nd Class Small Parcel",
   
"2nd Class Medium Parcel"
   
]
 
},
 
{
   
"name": "TNT UK",
   
"country": "GB",
   
"services": [
   
"Express",
   
"Express 10",
   
"Express 12"
   
]
 
},
 
{
   
"name": "UPS UK",
   
"country": "GB",
   
"services": [
   
"Express",
   
"Express Saver",
   
"Standard"
   
]
 
},
 
{
   
"name": "Yodel",
   
"country": "GB",
   
"services": [
   
"B2C 48HR",
   
"B2C 72HR",
   
"B2C Packet"
   
]
 
}
 
]
}

shippingsettings.getsupportedholidays

shippingsettings.getsupportedholidays の呼び出しにより MCA アカウントが許可されます 単体のアカウントで サポートされている休日を取得できます

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/supportedHolidays

JSON レスポンスの例を次に示します。

{
 
"kind": "content#shippingsettingsGetSupportedHolidaysResponse",
 
"holidays": [
 
{
   
"id": "FR_Christmas_2019-12-25",
   
"countryCode": "FR",
   
"type": "Christmas",
   
"date": "2019-12-25",
   
"deliveryGuaranteeDate": "2019-12-24",
   
"deliveryGuaranteeHour": "18"
 
},
 
{
   
"id": "US_Easter_2019-04-21",
   
"countryCode": "US",
   
"type": "Easter",
   
"date": "2019-04-21",
   
"deliveryGuaranteeDate": "2019-04-20",
   
"deliveryGuaranteeHour": "18"
 
},
 
{
   
"id": "US_Mother's Day_2019-05-12",
   
"countryCode": "US",
   
"type": "Mother's Day",
   
"date": "2019-05-12",
   
"deliveryGuaranteeDate": "2019-05-11",
   
"deliveryGuaranteeHour": "18"
 
},
 
{
   
"id": "US_Father's Day_2019-06-16",
   
"countryCode": "US",
   
"type": "Father's Day",
   
"date": "2019-06-16",
   
"deliveryGuaranteeDate": "2019-06-15",
   
"deliveryGuaranteeHour": "18"
 
},
 
{
   
"id": "US_Independence Day (USA)_2019-07-04",
   
"countryCode": "US",
   
"type": "Independence Day (USA)",
   
"date": "2019-07-04",
   
"deliveryGuaranteeDate": "2019-07-03",
   
"deliveryGuaranteeHour": "18"
 
},
 
{
   
"id": "US_Halloween_2019-10-31",
   
"countryCode": "US",
   
"type": "Halloween",
   
"date": "2019-10-31",
   
"deliveryGuaranteeDate": "2019-10-30",
   
"deliveryGuaranteeHour": "18"
 
},
 
{
   
"id": "US_Thanksgiving_2019-11-28",
   
"countryCode": "US",
   
"type": "Thanksgiving",
   
"date": "2019-11-28",
   
"deliveryGuaranteeDate": "2019-11-27",
   
"deliveryGuaranteeHour": "18"
 
},
 
{
   
"id": "US_Christmas_2019-12-25",
   
"countryCode": "US",
   
"type": "Christmas",
   
"date": "2019-12-25",
   
"deliveryGuaranteeDate": "2019-12-24",
   
"deliveryGuaranteeHour": "18"
 
}
 
]
}

郵便番号グループを設定する

Merchant Center で地域を作成すると便利ですが、Content API を使用することをおすすめします。 頻繁に変更される複数の地域を持つアカウントを維持するためです。

配送設定サービス では、配送設定と地域を設定、取得、更新できます。API では postalCodeGroups と呼びます。

"postalCodeGroups": [
 
{
   
"name": "string,
   
"country": string,
   
"postalCodeRanges": [
     
{
       
"postalCodeRangeBegin": string,
       
"postalCodeRangeEnd": string
     
}
   
]
 
}
]

UI と同様に、postalCodeGroups は郵便番号、郵便番号の単純なリストです。 範囲、郵便番号のプレフィックス、または範囲を指定します。

地域は配送設定とともに取得、設定されるため、 postalCodeGroups に既存の値を 送料設定 リソース 配送サービスを削除します

API を使用して地域を設定する適切な方法は次のとおりです。

  1. get を呼び出して、すべての配送サービスと postalCodeGroups を取得します (リージョン)。
  2. 配送サービスを get 呼び出しから update 呼び出しにコピーします。
  3. 交通機関を使用しない場合は、リクエスト本文から次のエントリを削除してください 配送サービスの時間ラベル:

    "transitTimeLabels": [
       
    "all other labels"
    ],
  4. update 呼び出しの postalCodeGroups セクションでリージョンを入力します。

  5. 配送サービスと postalCodeGroups の両方を指定して update を呼び出します。 セクションが入力されます。

最初の get の例の update 呼び出しリクエスト本文の例を次に示します。 上記で使用したリージョン 1 の postalCodeGroups を、94035 から 94036 に更新:

{
 
"services": [
   
{
     
"name": "Standard Shipping",
     
"active": true,
     
"deliveryCountry": "US",
     
"currency": "USD",
     
"deliveryTime": {
       
"minHandlingTimeInDays": 0,
       
"maxHandlingTimeInDays": 1,
       
"transitTimeTable": {
         
"postalCodeGroupNames": [
           
"Region1",
           
"Region2",
           
"all other locations"
         
],
         
"rows": [
           
{
             
"values": [
               
{
                 
"minTransitTimeInDays": 1,
                 
"maxTransitTimeInDays": 2
               
}
             
]
           
},
           
{
             
"values": [
               
{
                 
"minTransitTimeInDays": 2,
                 
"maxTransitTimeInDays": 3
               
}
             
]
           
},
           
{
             
"values": [
               
{
                 
"minTransitTimeInDays": 3,
                 
"maxTransitTimeInDays": 5
               
}
             
]
           
}
         
]
       
}
     
},
     
"rateGroups": [
       
{
         
"singleValue": {
           
"flatRate": {
             
"value": "0",
             
"currency": "USD"
           
}
         
},
         
"name": "Standard Shipping"
       
}
     
],
     
"eligibility": "All scenarios"
   
},
   
{
     
"name": "Expedited",
     
"active": true,
     
"deliveryCountry": "US",
     
"currency": "USD",
     
"deliveryTime": {
       
"minTransitTimeInDays": 2,
       
"maxTransitTimeInDays": 2,
       
"minHandlingTimeInDays": 0,
       
"maxHandlingTimeInDays": 1
     
},
     
"rateGroups": [
       
{
         
"singleValue": {
           
"flatRate": {
             
"value": "9.99",
             
"currency": "USD"
           
}
         
},
         
"name": "Expedited"
       
}
     
],
     
"eligibility": "All scenarios"
   
}
 
],
 
"postalCodeGroups": [
   
{
     
"name": "Region1",
     
"country": "US",
     
"postalCodeRanges": [
       
{
         
"postalCodeRangeBegin": "94036",
         
"postalCodeRangeEnd": "94070"
       
}
     
]
   
},
   
{
     
"name": "Region2",
     
"country": "US",
     
"postalCodeRanges": [
       
{
         
"postalCodeRangeBegin": "94071",
         
"postalCodeRangeEnd": "94082"
       
}
     
]
   
}
 
]
}

JSON レスポンスの例を次に示します。

{
 
"accountId": "1111",
 
"services": [
 
{
   
"name": "Standard Shipping",
   
"active": true,
   
"deliveryCountry": "US",
   
"currency": "USD",
   
"deliveryTime": {
   
"minHandlingTimeInDays": 0,
   
"maxHandlingTimeInDays": 1,
   
"transitTimeTable": {
     
"postalCodeGroupNames": [
     
"Region1",
     
"Region2",
     
"all other locations"
     
],
     
"rows": [
     
{
       
"values": [
       
{
         
"minTransitTimeInDays": 1,
         
"maxTransitTimeInDays": 2
       
}
       
]
     
},
     
{
       
"values": [
       
{
         
"minTransitTimeInDays": 2,
         
"maxTransitTimeInDays": 3
       
}
       
]
     
},
     
{
       
"values": [
       
{
         
"minTransitTimeInDays": 3,
         
"maxTransitTimeInDays": 5
       
}
       
]
     
}
     
]
   
}
   
},
   
"rateGroups": [
   
{
     
"singleValue": {
     
"flatRate": {
       
"value": "0",
       
"currency": "USD"
     
}
     
},
     
"name": "Standard Shipping"
   
}
   
],
   
"eligibility": "All scenarios"
 
},
 
{
   
"name": "Expedited",
   
"active": true,
   
"deliveryCountry": "US",
   
"currency": "USD",
   
"deliveryTime": {
   
"minTransitTimeInDays": 2,
   
"maxTransitTimeInDays": 2,
   
"minHandlingTimeInDays": 0,
   
"maxHandlingTimeInDays": 1
   
},
   
"rateGroups": [
   
{
     
"singleValue": {
     
"flatRate": {
       
"value": "9.99",
       
"currency": "USD"
     
}
     
},
     
"name": "Expedited"
   
}
   
],
   
"eligibility": "All scenarios"
 
}
 
],
 
"postalCodeGroups": [
 
{
   
"name": "Region1",
   
"country": "US",
   
"postalCodeRanges": [
   
{
     
"postalCodeRangeBegin": "94036",
     
"postalCodeRangeEnd": "94070"
   
}
   
]
 
},
 
{
   
"name": "Region2",
   
"country": "US",
   
"postalCodeRanges": [
   
{
     
"postalCodeRangeBegin": "94071",
     
"postalCodeRangeEnd": "94082"
   
}
   
]
 
}
 
]
}

受け取り/集荷所を使用する

受け取り/集荷所の注文の詳細(受け取り方法など) 店舗受け取り固有の情報によって、 詳しくは、 集荷/集荷所に関するガイド。

同日配達

ローカル インベントリ

当日配達サービスの shipmentType には local_delivery が設定されています。現時点では、local_delivery のすべての配送サービスは当日配達とみなされます。ローカル配送の deliveryTime 情報は変更できません。

使用 shippingsettings.update ローカル在庫商品の当日配達を設定します

以下は、すべての店舗に当日配達サービスを追加するリクエスト本文の例です。 :

実装で使用する前に、次のサンプルのすべての値を更新してください。

{
   
"accountId":"accountId",
   
"services":[
     
{
         
"name": "Local Delivery",
         
"active":true,
         
"shipmentType":"local_delivery",
         
"deliveryCountry":"US",
         
"currency":"USD",
         
"rateGroups":[
           
{
               
"singleValue":{
                 
"flatRate":{
                     
"value":"0",
                     
"currency":"USD"
                 
}
               
}
           
}
         
],
         
"eligibility":"All scenarios",
         
"storeConfig":{
           
"storeServiceType":"all stores",
           
"storeCodes":[
               
           
],
           
"cutoffConfig":{
               
"storeCloseOffsetHours":2,
               
"no_delivery_post_cutoff":true
           
},
           
"serviceRadius":{
               
"value":4,
               
"unit":"Miles"
           
}
         
}
     
}
   
]
}

翌日配達

同日配達の受付終了時間を過ぎてから行われた注文は、次の時間にスケジュール設定されます デフォルトで設定されます。翌日配達をオフにするには、次のように設定します。 no_delivery_post_cutoff から true に変更。翌日配達をオフにした場合、 配送サービスは毎日、受付終了時間より前にのみ表示されます。

翌日配達は、shipmentTypelocal_delivery の場合にのみご利用いただけます。

テスト

すべての項目が本番環境にあるため、変更しないように注意する必要があります。 公開されているアイテムに関する重要な情報(特に update()) 既存の値を変更する唯一のメソッドであるため、このメソッドを使用します。