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

Tài nguyê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 của tài khoản và tất cả tài khoản phụ được liên kết với tài khoản đó. Để biết thêm thông tin về cách thêm hoặc quản lý chế độ cài đặt thông tin vận chuyển của tài khoản, hãy xem bài viết Tổng quan về chế độ cài đặt thông tin vận chuyển.

Để sử dụng Merchant API 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/{ACCOUNT_ID}/shippingSettings

Thay thế {ACCOUNT_ID} bằng giá trị nhận dạng duy nhất của tài khoản Merchant Center.

Để sử dụng Merchant API nhằm cập nhật 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/{ACCOUNT_ID}/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 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	Merchant API
URL	https://shoppingcontent.googleapis.com/content/v2.1/{ACCOUNT_ID}/shippingsettings:insert	https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/shippingSettings:insert
Giá trị nhận dạng	{ACCOUNT_ID}/shippingsettings/{ACCOUNT_ID}	{NAME}

Danh sách sau đây đề cập đến các 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 Merchant API phải đặt accounts/{ACCOUNT_ID}/shippingSettings vào trường {NAME} để có cùng hành vi.
2. Merchant API không hỗ trợ các 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 địa điểm bằng dịch vụ khu vực.
3. Cách thiết lập WarehouseBasedDeliveryTime cho Merchant API sẽ 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 trong shippingsettings.warehouses. Sau đó, mỗi dịch vụ vận chuyển có thể tham chiếu đến kho thông qua tên kho 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 mới được hỗ trợ

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:

1. Kho hàng: Cung cấp thông tin về kho thực hiện đơn hàng, nơi 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 Merchant API 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 Merchant API và giao diện người dùng Merchant Center cùng một lúc.

Đổi tên các trường

Các trường sau đây đã được đổi tên trong Merchant API:

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.
service.name	services.serviceName	Tên tuỳ ý của dịch vụ, tên này phải là duy nhấ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 cho 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 mất để vận chuyển. Ví dụ: 0 có nghĩa là giao hàng cùng ngày và 1 có nghĩa là giao hàng vào ngày hôm sau.
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	Số ngày làm việc tối đa mà đơn đặt hàng mất để vận chuyển.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Số ngày làm việc tối thiểu 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 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 gian cắt.
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 nhóm mức phí vận chuyển.
service.rate_group.subtable	services.rateGroups.subtables	Danh sách bảng con.
service.rate_group.carrier_rate	services.rateGroups.carrierRates	Danh sách mức giá của nhà mạng.
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.

Các trường không còn dùng nữa

Các trường sau đây của Content API không còn được dùng nữa trong Merchant API. Merchant API không cung cấp phương á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à thông tin 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	Merchant API
customBatch	Có	Không
get	Có	Có
update	Có	Không
insert	Không	Có
getSupportedCarrier	Có	Không
getSupportedHolidays	Có	Không