Chiến lược phát hành đĩa đơn
ShippingSettings
cho phép bạn truy xuất và cập nhật chế độ cài đặt thông tin vận chuyển trong tài khoản của mình cũng như
tất cả tài khoản phụ liên kết với email đó. Để biết thêm thông tin về cách bạn có thể
thêm hoặc quản lý chế độ cài đặt thông tin vận chuyển trong tài khoản của bạn, hãy xem bài viết Tổng quan về thông tin vận chuyển
phần cài đặt.
Nếu bạn muốn dùng Merchant API để đọc thông tin về chế độ cài đặt thông tin vận chuyển, hãy làm như sau yêu cầu:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings
Thay thế {accountId} bằng giá trị nhận dạng duy nhất của Tài khoản Merchant Center.
Nếu bạn muốn dùng Merchant API để đọc thông tin về chế độ cài đặt thông tin vận chuyển, hãy làm như sau yêu cầu:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
Để biết thêm thông tin, hãy xem Phương thức:
accounts.shippingSettings.insert
.
So sánh giữa Content API for Shopping và Merchant API
Dưới đây là ví dụ so sánh giữa Content API for Shopping với người bán API cài đặt thông tin vận chuyể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 chế độ cài đặt thông tin vận chuyển của người bán so với Content API for Shopping:
- Người dùng API Merchant 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ư làm nhóm vị trí. Bạn chỉ có thể đọc các khu vực tuỳ chỉnh như nhóm vị trí hoặc được viết bằng dịch vụ khu vực.
- Cách thiết lập
WarehouseBasedDeliveryTime
API Merchant Center khác với Content API for Shopping. Nếu bạn đang sử dụng API Merchant, bạn phải xác định thông tin kho hàng theoshippingsettings.warehouses
. Sau đó, mỗi dịch vụ vận chuyển có thể tham chiếu kho hàng thông qua tên kho hàng theowarehouseBaseDeliveryTime
. - Một dịch vụ trong API Merchant hỗ trợ nhiều quốc gia giao hàng.
Các trường mới được hỗ trợ
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 so với Content API for Shopping:
- Kho hàng: Cung cấp thông tin về kho thực hiện đơn hàng, để lưu trữ và xử lý khoảng không quảng cáo.
- 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 để chế độ cài đặt thông tin vận chuyển của họ.
- 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 tại .
Các trường đã đổi tên
Các trường sau đây đã được đổi tên trong API Merchant:
Content API for Shopping | API cài đặt thông tin vận chuyển của người bán | 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ụ, 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à một đơn đặt hàng trải qua trong quá trình vận chuyển. Ví dụ: 0 là giao hàng trong cùng ngày và 1 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à một đơn đặt hàng phải trải qua 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 phải 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 đã bỏ ra 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 hạn chót nhận đơn hàng. |
service.deliveryTime.transitTimeTable.postalCodeGroupName |
services.deliveryTime.transitTimeTable.postalCodeGroupNames |
Tên của 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 các 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 bộ 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à
hãy 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 đây trong Content API không còn được dùng trong Merchant API nữa. Người bán API không cung cấp bất kỳ lựa chọn thay thế nào cho các trường này.
postal_code_group
service
Pickup_service
Eligibility
Scheduling_channel
Delivery_time
Holiday_cutoff
Min_scheduling_time_in_days
Max_scheduling_time_in_days
Scheduling_business_day_config
Rate_group
single_value_alternative_list
Phương thức
Dưới đây là so sánh các phương thức trong Content API for Shopping và API chế độ cài đặt thông tin vận chuyển của người bán:
Phương thức | Content API for Shopping | API người bán |
---|---|---|
customBatch |
Có | Không |
get |
Có | Có |
update |
Có | Không |
insert |
Không | Có |
getSupportedCarrier |
Có | Không |
getSupportedHolidays |
Có | Không |