Di chuyển tính năng quản lý chính sách trả lại hàng trực tuyến

Tài nguyên API nội dung OnlineReturnPolicy và các trường liên quan bao gồm cả ReturnPolicyPolicy và ReturnPolicySeasonalOverride đã thay đổi.

Merchant API tương đương với tài nguyên returnpolicy trong Content API là accounts.onlineReturnPolicies.

Bảng này giải thích những thay đổi trong OnlineReturnPolicy.

Content API Merchant API
"country": string "countries": [ string ]
"policy": { object (ReturnPolicyPolicy) } "policy": { object (Policy) }
"seasonalOverrides": [ { object (ReturnPolicySeasonalOverride) } ] "seasonalOverrides": [ { object (SeasonalOverride) } ],
nonFreeReturnReasons": [ string ] Trường này sẽ biến mất.
kind Trường này sẽ biến mất.
"returnShippingFee": { object (Price) } "returnShippingFee": { object (ReturnShippingFee) }

Ngoài ra, một số trường mới cũng được cung cấp trong Merchant API.

Trường Merchant API Mô tả
"restockingFee": { object (RestockingFee) }, Không bắt buộc. Phí nhập kho lại áp dụng cho tất cả danh mục lý do trả lại hàng. Giá trị này sẽ được coi là phí nhập kho lại miễn phí nếu bạn không đặt giá trị.
"returnMethods": [ enum (ReturnMethod) ] Không bắt buộc. Phương thức trả lại hàng mà khách hàng có thể sử dụng để trả lại mặt hàng. Giá trị này bắt buộc phải không để trống, trừ phi loại chính sách trả lại hàng là noReturns.
"itemConditions": [ enum (ItemCondition) ], Không bắt buộc. Tình trạng mặt hàng được chấp nhận trả lại không được để trống, trừ phi loại chính sách trả lại hàng là noReturns.
"returnShippingFee": { object (ReturnShippingFee) } Không bắt buộc. Phí vận chuyển trả lại hàng. Chỉ nên đặt khi khách hàng cần tải xuống và in nhãn trả lại hàng.
"returnPolicyUri": string Bắt buộc. URI chính sách trả lại hàng. Google sử dụng thông tin này để xác thực chính sách. Đó phải là một URL hợp lệ.
"acceptDefectiveOnly": boolean Bắt buộc. Chỉ định rằng người bán chỉ chấp nhận trả lại hàng đối với những sản phẩm bị lỗi.
"processRefundDays": integer Không bắt buộc. Chỉ định số ngày mà người bán cần để xử lý yêu cầu hoàn tiền.
"acceptExchange": boolean Không bắt buộc. Chỉ định xem người bán có cho phép khách hàng đổi sản phẩm hay không.
"returnLabelSource": enum (ReturnLabelSource) Chỉ định nguồn nhãn trả lại hàng. Bắt buộc khi phương thức trả về là BY_MAIL.

ReturnPolicyPolicy

ReturnPolicyPolicy của Content API trở thành Policy trong Merchant API. Sau đây là cách các trường đã thay đổi.

Content API Merchant API
"type": string, "type": enum (Type)
Các giá trị có thể là NUMBER_OF_DAYS_AFTER_DELIVERY, NO_RETURNS or LIFETIME_RETURNS.
"numberOfDays": string "days": string
"lastReturnDate": string Thay vào đó, hãy sử dụng days. Giá trị này thể hiện số ngày mà khách hàng có thể trả lại hàng sau khi giao hàng, trong đó một ngày được xác định là 24 giờ sau khi có dấu thời gian giao hàng. Bắt buộc đối với các giá trị trả về NUMBER_OF_DAYS_AFTER_DELIVERY.

ReturnPolicySeasonalOverride

Content API ReturnPolicySeasonalOverride trở thành SeasonalOverride trong Merchant API. Ngoài những thay đổi trong các trường, trường bổ sung return_window là một liên kết có thể là returnDays hoặc returnUntilDate:

  "returnDays": integer,
  "returnUntilDate": {
    object (Date)

Các cờ này có ý nghĩa như sau:

  • returnDays: Số ngày (kể từ ngày giao hàng) mà khách hàng vẫn có thể trả lại sản phẩm.
  • returnUntilDate: Ngày kết thúc cố định cho đến khi có thể trả lại sản phẩm.

Sau đây là những thay đổi đối với các trường.

Content API Merchant API
"name": string "label": string
"startDate": string "startDate": { object (Date) }
"endDate": string "endDate": { object (Date) }
"policy": { object (ReturnPolicyPolicy) } Thay vào đó, hãy sử dụng policy.

Định nghĩa của các đối tượng khác

Để biết định nghĩa về các đối tượng Merchant API mới

  • RestockingFee
  • ReturnMethod
  • ItemCondition
  • ReturnShippingFee
  • Type
  • ReturnLabelSource

xem accounts.onlineReturnPolicies.

Phương thức

Với Merchant API, cũng có một số thay đổi đối với các phương thức Content API.

Content API Merchant API
customBatch Với Merchant API, bạn cần áp dụng một phương pháp khác. Xem phần Tái cấu trúc mã cho các yêu cầu đồng thời.
delete delete
get get
insert Thay vào đó, hãy sử dụng create hoặc update.
list list
Trước
Migrate Local Inventory Ads settings
Tiếp
Configure API authentication from Merchant Center