Di chuyển chế độ cài đặt thông tin vận chuyển từ Content API for Shopping

Để 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:

1. Người dùng Merchant API phải đặt accounts/{accountId}/shippingSettings vào trường {name} để có cùng hành vi.
2. 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.
3. 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 trong shippingsettings.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 trong warehouseBaseDeliveryTime.
4. 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:

1. 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.
2. 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.
3. 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 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 |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à Merchant Shipping settings API: Phương thức Content API for Shopping API người bán customBatch Có Không get Có Có cập nhật Có Không insert Không Có getSupportedCarrier Có Không getSupportedHolidays Có Không