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/v1/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 của bạn.

Để 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/v1/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 Content API for Shopping và Merchant API

Sau đây là một ví dụ so sánh Content API for Shopping với tài nguyên Chế độ cài đặt thông tin vận chuyển trong API phụ Tài khoản:

Content API Merchant API
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/shippingsettings/{ACCOUNT_ID} https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert
Giá trị nhận dạng {MERCHANT_ID}/shippingsettings/{ACCOUNT_ID} {NAME}

Danh sách sau đây đề cập đến các bản cập nhật chính trong tài nguyên Chế độ cài đặt thông tin vận chuyển trong API phụ Tài khoả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 địa điểm. 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. Một dịch vụ trong Merchant API hỗ trợ nhiều quốc gia giao hàng.
  4. Merchant API không cung cấp phương thức danh sách cho chế độ cài đặt thông tin vận chuyển, không giống như phương thức shippingsettings.list trong Content API.

Các trường mới được hỗ trợ

Tài nguyên Chế độ cài đặt thông tin vận chuyển trong API phụ Tài khoản hỗ trợ các trường mới sau đây so với Content API for Shopping:

  1. warehouses: Cung cấp thông tin về kho hàng thực hiện đơn đặt hàng, nơi lưu trữ và xử lý hàng tồn kho.
  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.

Các trường được đổi tên

Các trường sau đây đã được đổi tên trong tài nguyên Chế độ cài đặt thông tin vận chuyển trong API phụ Tài khoản:

Content API for Shopping Tài nguyên Chế độ cài đặt thông tin vận chuyển Mô tả
service services Một dịch vụ vận chuyển.
service.name services.serviceName Tên dịch vụ ở dạng tự do và phải là duy nhất trong tài khoản Merchant Center.
service.deliveryCountry services.deliveryCountries Mã lãnh thổ CLDR của quốc gia mà dịch vụ vận chuyển áp dụng.
service.currency services.currencyCode Mã CLDR của đơn vị tiền tệ mà dịch vụ này áp dụng.
service.deliveryTime.minTransitTimeInDays services.deliveryTime.minTransitDays Số ngày làm việc tối thiểu mà một đơn đặt hàng dành cho quá trình vận chuyển. Ví dụ: 0 có nghĩa là giao hàng trong 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à một đơn đặt hàng dành cho quá trình vận chuyển.
service.deliveryTime.minHandlingTimeInDays services.deliveryTime.minHandlingDays Số ngày làm việc tối thiểu trước khi một đơ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 một đơ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 ngừng xử lý đơ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 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 các mức phí vận chuyển của hãng vận chuyển.
service.minimumOrderValueTable.storeCodeSetWithMovs services.minimumOrderValueTable.storeCodeSetWithMovs Danh sách các tập hợp mã cửa hàng có cùng giá trị đơn đặt hàng tối thiểu.

Các phương thức bị xoá

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 bị xoá

Các trường sau đây từ Content API for Shopping đã bị xoá trong Merchant API. 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.

  • postal_code_group
  • service
    • Pickup_service
    • Eligibility
    • Scheduling_channel
    • Delivery_time
      • Holiday_cutoff

    • Rate_group
      • single_value_alternative_list

Phương thức

Sau đây là bảng so sánh các phương thức trong Content API for Shopping và tài nguyên Chế độ cài đặt thông tin vận chuyể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ó
list Có Không
getSupportedCarrier Có Không
getSupportedHolidays Có Không
Trước
Migrate data sources management
Tiếp
Migrate conversion sources management