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 bạn có thể 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 riêng biệ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/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

Dưới đây là ví dụ so sánh Content API for Shopping với tài nguyên 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 điểm 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 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. 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 list 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 hàng, nơi 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 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ùng lúc 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á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 duy nhất.
service.name services.serviceName Tên tuỳ ý của dịch vụ, phải là tên riêng biệ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à đơn đặt hàng được vận chuyển. Ví dụ: 0 nghĩa là giao hàng trong ngày và 1 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 được vận chuyển.
service.deliveryTime.minHandlingTimeInDays services.deliveryTime.minHandlingDays Số ngày làm việc tối thiểu để xử lý đơn đặt hàng trước khi vận chuyển.
service.deliveryTime.maxHandlingTimeInDays services.deliveryTime.maxHandlingDays Số ngày làm việc tối đa tính từ lúc người mua sắm đặt hàng đến lúc đơn đặt hàng được giao.
service.deliveryTime.cutoffTime.timezone services.deliveryTime.cutoffTime.timeZone Giá trị nhận dạng múi giờ cho thời gian ngừng nhận đơn đặt 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 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 Một 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 đã 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 duy nhất.

Các trường đã xoá

Các trường sau đây trong Content API for Shopping sẽ bị xoá trong Merchant API. Merchant API không cung cấp 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à nội dung 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