遷移線上退貨政策管理

Content API 資源 OnlineReturnPolicy 和相關聯欄位 (包括 ReturnPolicyPolicy 和 ReturnPolicySeasonalOverride) 已變更。

Content API 中 returnpolicy 資源的 Merchant API 等價項目為 accounts.onlineReturnPolicies。

下表說明 OnlineReturnPolicy 的變更內容。

Content API	Merchant API
"country": string	"countries": [ string ]
"policy": { object (ReturnPolicyPolicy) }	"policy": { object (Policy) }
"seasonalOverrides": [ { object (ReturnPolicySeasonalOverride) } ]	"seasonalOverrides": [ { object (SeasonalOverride) } ],
nonFreeReturnReasons": [ string ]	這個欄位會消失。
kind	這個欄位會消失。
"returnShippingFee": { object (Price) }	"returnShippingFee": { object (ReturnShippingFee) }

此外，Merchant API 也新增了許多欄位。

Merchant API 欄位	說明
"restockingFee": { object (RestockingFee) },	(非必要) 適用於所有退貨原因類別的重新進貨費用。如果未設定值，系統會將其視為免費的退貨處理費。
"returnMethods": [ enum (ReturnMethod) ]	(非必要) 消費者可用來退回商品的退貨方式。除非退貨政策類型為 noReturns，否則此值不得空白。
"itemConditions": [ enum (ItemCondition) ],	(非必要) 除非退貨政策類型為 noReturns.，否則接受退貨的商品狀況不得為空白
"returnShippingFee": { object (ReturnShippingFee) }	(非必要) 退貨運費。只有在客戶需要下載及列印退貨標籤時，才應設定。
"returnPolicyUri": string	必要欄位。退貨政策 URI。Google 會使用這組號碼驗證政策。必須是有效的網址。
"acceptDefectiveOnly": boolean	必要欄位。指定商家只接受瑕疵產品的退貨。
"processRefundDays": integer	(非必要) 指定商家處理退款所需的天數。
"acceptExchange": boolean	(非必要) 指定商家是否允許消費者換貨。
"returnLabelSource": enum (ReturnLabelSource)	指定退貨標籤來源。退貨方式為 BY_MAIL 時為必填。

ReturnPolicyPolicy

Content API ReturnPolicyPolicy 會變成 Merchant API 中的 Policy。以下是欄位的變更方式。

Content API	Merchant API
"type": string,	"type": enum (Type) 可能的值包括 NUMBER_OF_DAYS_AFTER_DELIVERY, NO_RETURNS or LIFETIME_RETURNS.
"numberOfDays": string	"days": string
"lastReturnDate": string	請改用 days。這項屬性代表商品送達後可退回的期限，其中 1 天定義為送達時間戳記後的 24 小時。這是 NUMBER_OF_DAYS_AFTER_DELIVERY 退貨的必要資訊。

ReturnPolicySeasonalOverride

Content API ReturnPolicySeasonalOverride 會變成 Merchant API 中的 SeasonalOverride。除了欄位的變更之外，額外的欄位 return_window 是可為 returnDays 或 returnUntilDate 的聯集：

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

其意義如下：

• returnDays：產品退貨期限的天數 (從送達日期起算)。
• returnUntilDate：產品退貨的固定截止日期。

以下說明欄位的變更方式。

Content API	Merchant API
"name": string	"label": string
"startDate": string	"startDate": { object (Date) }
"endDate": string	"endDate": { object (Date) }
"policy": { object (ReturnPolicyPolicy) }	請改用 policy。

其他物件的定義

如需新 Merchant API 物件的定義

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

請參閱 accounts.onlineReturnPolicies。

方法

Merchant API 也有一些與 Content API 方法不同的變更。

Content API	Merchant API
customBatch	但 Mechant API 有不同的做法。請參閱「 為並行要求重構程式碼」一文。
delete	delete
get	get
insert	請改用 create 或 update。
list	list