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

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:

1. Người dùng API Merchant 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ư 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.
3. 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 theo shippingsettings.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 theo warehouseBaseDeliveryTime.
4. 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:

1. 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.
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 để chế độ cài đặt thông tin vận chuyển của họ.
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 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