配送设置

通过 shippingsettings 可用于检索和更新多客户的配送设置 账号 (MCA) 以及与其关联的所有子账号。

多客户账号 (MCA) 通常供满足以下条件的集成商、集合商家和渠道合作伙伴使用: 为多个商家管理在线商店和 API 服务。拥有 在多个不同网站上销售的网店或品牌 可以选择在单个 MCA 下拥有子账号。

Google 可以自动更新某些商品的预计送货时间。 请参见启用自动 功能改进

shippingsettings.list

shippingsettings.list 调用会返回以下所有配送资源信息: 一个账号或所有子账号(如果处理的是 MCA 账号)。

shippingsettings.list 方法的示例网址:

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 响应示例 以及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 merchange 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、唯一 batchId,并将 method 设置为 get 用于检索运费设置,update 用于修改运费 设置。

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

以下示例 JSON 请求正文包含两个部分:

  1. batchId=1,用于检索账号 ID 1111 的运费设置。
  2. batchId=2,用于将以下对象的 maxTransitTimeInDays 更新为 8: 配送服务 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
     
}
   
]
 
}
]

与在界面中一样,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"
   
}
   
]
 
}
 
]
}

使用取件点

如需详细了解自提/取件点订单,包括如何进行自提/取件 与送货上门订单有何不同,以及自提特定信息需要提供 处理,请参阅 取件/取件点指南。

当日送达

如果您有本地商店,可以使用 Content API for Shopping 配置当天送达配送服务 广告资源

当天送达配送服务的 shipmentTypelocal_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_cutofftrue。如果您关闭了次日送达功能,您的 配送服务仅在每天截止时间之前显示。

次日送达服务仅适用于shipmentTypelocal_delivery

测试

由于所有商品都在生产中,因此应注意避免更改 有关已发布项目的重要信息,特别是 update() 方法,因为这是唯一可更改现有值的方法。