Tài nguyên shippingsettings giúp bạn truy xuất và cập nhật chế độ cài đặt thông tin vận chuyển của tài khoản nhiều khách hàng (MCA) cũng như tất cả tài khoản phụ liên kết với tài khoản đó.
MCA thường được các đơn vị tích hợp, đơn vị tổng hợp và đối tác kênh quản lý các cửa hàng trực tuyến và dịch vụ API cho nhiều người bán sử dụng. Những người bán có nhiều cửa hàng trực tuyến hoặc thương hiệu bán trên các trang web riêng biệt cũng có thể chọn sử dụng các tài khoản phụ thuộc một MCA duy nhất.
Google có thể tự động cập nhật thời gian giao hàng dự kiến cho một số sản phẩm. Hãy xem bài viết Bật tính năng cải thiện tự động để biết thêm thông tin chi tiết.
shippingsettings.list
Lệnh gọi shippingsettings.list sẽ trả về tất cả thông tin về tài nguyên vận chuyển của một tài khoản hoặc tất cả các tài khoản phụ nếu giao dịch với tài khoản nhiều khách hàng.
URL mẫu cho phương thức shippingsettings.list:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shippingsettings
Dưới đây là phản hồi JSON mẫu cho thấy chế độ cài đặt thông tin vận chuyển cho các tài khoản phụ 1111 và 2222 của một tài khoản MCA:
{
"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
Lệnh gọi shippingsettings.get cho phép tài khoản MCA lấy thông tin về chế độ cài đặt thông tin vận chuyển cho một tài khoản phụ duy nhất hoặc cho một tài khoản độc lập nhận thông tin trạng thái tài khoản của riêng tài khoản đó.
Sử dụng lệnh gọi sau để lấy thông tin về chế độ cài đặt thông tin vận chuyển, trong đó merchantId là số tài khoản MCA và accountId là tài khoản phụ. Nếu tài khoản Merchant Center không phải là tài khoản nhiều khách hàng,
shippingsettings.get vẫn có thể trả về thông tin cài đặt thông tin vận chuyển. Trong trường hợp này, hãy sử dụng cùng một số tài khoản Merchant Center cho cả thông số merchantId và accountId.
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shippingsettings/accountId
Dưới đây là phản hồi JSON mẫu cho tài khoản phụ có dịch vụ vận chuyển Standard và Expedited được định cấu hình từ tài khoản MCA dùng cho lệnh gọi 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
Lệnh gọi shippingsettings.update cho phép tài khoản MCA cập nhật thông tin cài đặt thông tin vận chuyển cho một tài khoản phụ hoặc một tài khoản độc lập.
PUT https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shippingsettings/accountId
Dưới đây là nội dung yêu cầu JSON mẫu để cập nhật maxTransitTimeInDays thành 7 cho Dịch vụ vận chuyển GSA Shipping - Free Ship Over $49.99 cho tài khoản phụ có mã tài khoản là 2222 trong mã thương mại MCA của 10.
{
...
"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"
}
]
}
}
Dưới đây là nội dung phản hồi JSON mẫu:
{
"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
Lệnh gọi shippingsettings.custombatch truy xuất hoặc cập nhật thông tin về chế độ cài đặt thông tin vận chuyển cho nhiều tài khoản phụ của tài khoản nhiều khách hàng.
Yêu cầu JSON bao gồm merchantId của số tài khoản MCA, accountId của tài khoản phụ, batchId duy nhất và method được đặt thành get để truy xuất chế độ cài đặt thông tin vận chuyển và update để sửa đổi chế độ cài đặt thông tin vận chuyển.
POST https://shoppingcontent.googleapis.com/content/v2.1/shippingsettings/batch
Nội dung yêu cầu JSON mẫu sau đây có hai phần:
batchId=1được dùng để truy xuất chế độ cài đặt thông tin vận chuyển cho mã tài khoản1111.batchId=2, dùng để cập nhậtmaxTransitTimeInDaysthành8cho Dịch vụ vận chuyểnGSA Shipping - Free Ship Over $49.99. (Chế độ cài đặt này đã được thay đổi từ7đối với mã tài khoản2222như trong ví dụ về nội dung phản hồi trước đó choshippingsettings.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"
}
]
}
}
]
}
Dưới đây là nội dung phản hồi JSON mẫu:
{
"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
Lệnh gọi shippingsettings.getsupportedcarriers cho phép một tài khoản MCA hoặc tài khoản độc lập sử dụng các nhà mạng được hỗ trợ.
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/supportedCarriers
Dưới đây là nội dung phản hồi JSON mẫu:
{
"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
Lệnh gọi shippingsettings.getsupportedholidays cho phép một tài khoản MCA hoặc tài khoản độc lập truy xuất các ngày lễ được hỗ trợ.
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/supportedHolidays
Dưới đây là phản hồi JSON mẫu:
{
"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"
}
]
}
Đặt nhóm mã bưu chính
Mặc dù việc xây dựng khu vực trong Merchant Center là một cách thuận tiện, nhưng bạn nên sử dụng Content API để duy trì các tài khoản có nhiều khu vực thường xuyên thay đổi.
Dịch vụ Cài đặt thông tin vận chuyển cho phép bạn thiết lập, nhận và cập nhật chế độ cài đặt thông tin vận chuyển và khu vực. Trong API, các vùng được gọi là postalCodeGroups.
"postalCodeGroups": [
{
"name": "string,
"country": string,
"postalCodeRanges": [
{
"postalCodeRangeBegin": string,
"postalCodeRangeEnd": string
}
]
}
]
Như trong giao diện người dùng, postalCodeGroups là một danh sách đơn giản gồm các mã bưu chính, phạm vi mã bưu chính, tiền tố mã bưu chính hoặc phạm vi tiền tố.
Vì các khu vực được truy xuất và thiết lập cùng với chế độ cài đặt thông tin vận chuyển, nên nếu bạn chỉ điền postalCodeGroups thông qua tài nguyên Chế độ cài đặt thông tin vận chuyển hiện có thì dịch vụ vận chuyển sẽ bị xoá.
Sau đây là cách phù hợp để đặt khu vực thông qua API:
- Thực hiện lệnh gọi
getđể truy xuất tất cả dịch vụ vận chuyển vàpostalCodeGroups(khu vực). - Sao chép dịch vụ vận chuyển từ lệnh gọi
getđến lệnh gọiupdate. Xoá mục sau khỏi nội dung yêu cầu nếu bạn không sử dụng nhãn thời gian vận chuyển trong dịch vụ vận chuyển:
"transitTimeLabels": [ "all other labels" ],Điền các khu vực trong phần
postalCodeGroupscho lệnh gọiupdate.Thực hiện lệnh gọi
updatekhi điền sẵn các phần dịch vụ vận chuyển và phầnpostalCodeGroups.
Sau đây là nội dung yêu cầu gọi update mẫu từ ví dụ get đầu tiên được dùng ở trên với postalCodeGroups cho Khu vực 1, được cập nhật từ 94035 thành 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"
}
]
}
]
}
Dưới đây là phản hồi JSON mẫu:
{
"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"
}
]
}
]
}
Sử dụng điểm đến lấy hàng/đến lấy hàng
Để biết thêm thông tin về đơn đặt hàng đến lấy hàng/đến lấy hàng, bao gồm sự khác biệt giữa đơn đặt hàng này với đơn đặt hàng giao tận nhà và những thông tin cụ thể về tính năng đến lấy hàng cần được xử lý, hãy xem hướng dẫn về điểm đến lấy hàng/đến lấy hàng.
Giao hàng trong ngày
Bạn có thể sử dụng Content API for Shopping để thiết lập dịch vụ vận chuyển cùng ngày nếu có kho hàng tại địa phương.
Dịch vụ vận chuyển giao hàng trong cùng ngày áp dụng shipmentType là local_delivery. Hiện tại, tất cả các dịch vụ vận chuyển của local_delivery đều được xem là dịch vụ giao hàng cùng ngày. Bạn không thể thay đổi thông tin deliveryTime đối với dịch vụ giao hàng tại địa phương.
Sử dụng shippingsettings.update để thiết lập dịch vụ giao hàng cùng ngày cho các sản phẩm kho hàng tại địa phương.
Dưới đây là nội dung yêu cầu mẫu thêm dịch vụ giao hàng cùng ngày cho tất cả các cửa hàng trong tài khoản của bạn:
Hãy cập nhật tất cả các giá trị trong mẫu sau đây trước khi sử dụng trong quá trình triển khai.
{
"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"
}
}
}
]
}
Giao hàng ngày hôm sau
Theo mặc định, các đơn đặt hàng sau hạn chót nhận đơn hàng để giao hàng cùng ngày sẽ được lên lịch giao hàng vào ngày tiếp theo. Để tắt tính năng giao hàng vào ngày tiếp theo, hãy đặt no_delivery_post_cutoff thành true. Nếu bạn tắt tính năng giao hàng vào ngày tiếp theo, thì các dịch vụ vận chuyển của bạn chỉ hiển thị trước hạn chót nhận đơn hàng mỗi ngày.
Bạn chỉ có thể giao hàng vào ngày tiếp theo khi shipmentType là local_delivery.
Kiểm thử
Vì tất cả các mục đều đang trong quá trình sản xuất, nên bạn cần chú ý để tránh thay đổi bất kỳ nội dung quan trọng nào trên các mục đang hoạt động, cụ thể là bằng phương thức update() vì đây là phương thức duy nhất thay đổi các giá trị hiện có.