Để sử dụng API Merchant nhằm đọc thông tin về chế độ cài đặt thông tin vận chuyển, hãy sử dụng các yêu cầu sau:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings
Thay thế {accountId} bằng mã nhận dạng duy nhất của tài khoản Merchant Center.
Để sử dụng API Merchant nhằm đọc thông tin về chế độ cài đặt thông tin vận chuyển, hãy sử dụng các yêu cầu sau:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
So sánh giữa Content API for Shopping và Merchant API
Dưới đây là phép so sánh mẫu giữa Content API for Shopping với API chế độ cài đặt thông tin vận chuyển của người bán:
Content API | API người bán | |
---|---|---|
URL | https://shoppingcontent.googleapis.com/content/v2.1/ {accountId}/shippingsettings:insert |
https://merchantapi.googleapis.com/accounts/v1beta/accounts/ {accountId}/shippingSettings:insert |
Giá trị nhận dạng | {accountId}/shippingsettings/ {accountId} |
{name} |
Danh sách sau đây đề cập đến những nội dung cập nhật chính trong API cài đặt thông tin vận chuyển của Merchant Center so với Content API for Shopping:
- Người dùng Merchant API phải đặt
accounts/{accountId}/shippingSettings
vào trường {name} để có cùng hành vi. - Merchant API không hỗ trợ thao tác đọc và ghi trên các khu vực tuỳ chỉnh, chẳng hạn như nhóm vị trí. Bạn chỉ có thể đọc hoặc ghi các khu vực tuỳ chỉnh như nhóm vị trí bằng dịch vụ khu vực.
- Cách thiết lập
WarehouseBasedDeliveryTime
cho Merchant API khác với Content API for Shopping. Nếu đang sử dụng Merchant API, bạn phải xác định thông tin kho hàng trongshippingsettings.warehouses
. Sau đó, mỗi dịch vụ vận chuyển có thể tham chiếu đến kho hàng thông qua tên kho hàng trongwarehouseBaseDeliveryTime
. - Một dịch vụ trong Merchant API hỗ trợ nhiều quốc gia giao hàng.
Các trường được hỗ trợ mới
So với Content API for Shopping, API chế độ cài đặt thông tin vận chuyển của người bán hỗ trợ các trường mới sau đây:
- Kho hàng: Cung cấp thông tin về kho thực hiện đơn hàng, có chức năng lưu trữ và xử lý kho hàng.
- Chương trình khách hàng thân thiết: Người dùng API Merchant có thể nhập thông tin về chương trình khách hàng thân thiết vào chế độ cài đặt thông tin vận chuyển.
- Etag: Etag được thiết kế để giải quyết các vấn đề không đồng bộ khi nhiều người dùng cố gắng cập nhật chế độ cài đặt thông tin vận chuyển bằng API Merchant Center và giao diện người dùng Merchant Center cùng lúc.
Các trường đã được đổi tên
Các trường sau đây đã được đổi tên trong API Merchant:
Content API for Shopping | API chế độ cài đặt thông tin vận chuyển của người bán | Nội dung mô tả |
---|---|---|
service |
services |
Một dịch vụ vận chuyển duy nhất. |
service.name |
services.serviceName |
Tên dạng tự do của dịch vụ và phải là tên riêng biệt trong tài khoản Merchant Center của bạn. |
service.deliveryCountry |
services.deliveryCountries |
Mã lãnh thổ CLDR của quốc gia áp dụng dịch vụ vận chuyển. |
service.currency |
services.currencyCode |
Mã CLDR của đơn vị tiền tệ áp dụng dịch vụ này. |
service.deliveryTime.minTransitTimeInDays |
services.deliveryTime.minTransitDays |
Số ngày làm việc tối thiểu mà đơn đặt hàng dành trong quá trình vận chuyển. Ví dụ: 0 có nghĩa là giao hàng trong cùng ngày và 1 có nghĩa là giao hàng vào ngày tiếp theo. |
service.deliveryTime.maxTransitTimeInDays |
services.deliveryTime.maxTransitDays |
Số ngày làm việc tối đa mà đơn đặt hàng dành trong quá trình vận chuyển. |
service.deliveryTime.minHandlingTimeInDays |
services.deliveryTime.minHandlingDays |
Số ngày làm việc tối thiểu đã bỏ ra trước khi đơn đặt hàng được vận chuyển. |
service.deliveryTime.maxHandlingTimeInDays |
services.deliveryTime.maxHandlingDays |
Số ngày làm việc tối đa đã dùng trước khi đơn đặt hàng được vận chuyển. |
service.deliveryTime.cutoffTime.timezone |
services.deliveryTime.cutoffTime.timeZone |
Giá trị nhận dạng múi giờ cho thời hạn đặt hàng. |
service.deliveryTime.transitTimeTable.postalCodeGroupName |
services.deliveryTime.transitTimeTable.postalCodeGroupNames |
Tên nhóm mã bưu chính. |
service.deliveryTime.transitTimeTable.transitTimeLabel |
services.deliveryTime.transitTimeTable.transitTimeLabel |
Nhãn thời gian vận chuyển của sản phẩm. |
service.rate_group |
services.rateGroups |
Định nghĩa về nhóm mức phí vận chuyển. |
service.rate_group.subtable |
services.rateGroups.subtables |
Danh sách bảng phụ. |
service.rate_group.carrier_rate |
services.rateGroups.carrierRates |
Danh sách mức phí của hãng vận chuyển. |
service.minimumOrderValueTable.storeCodeSetWithMovs |
services.minimumOrderValueTable.storeCodeSetWithMovs |
Danh sách các nhóm mã cửa hàng có cùng giá trị đơn đặt hàng tối thiểu. |
Các phương thức ngừng hoạt động
Bạn không thể sử dụng shippingsettings.custombatch
để truy xuất và cập nhật chế độ cài đặt thông tin vận chuyển của nhiều tài khoản trong một yêu cầu duy nhất.
Các trường không dùng nữa
Các trường sau không còn được dùng trong API Merchant nữa. Xin lưu ý rằng Merchant API không cung cấp bất kỳ lựa chọn thay thế nào cho các trường này.
Content API for Shopping | API người bán | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
postal_code_group |
region |
||||||||||||||||||||
service
| Phương thứcDưới đây là so sánh các phương thức trong Content API for Shopping và Merchant Shipping settings API:
|