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
在 Merchant API 中，Content API ReturnPolicyPolicy 會變成 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。這代表商品送達後可退貨的天數，一天是指送達時間戳記後的 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 物件的定義
RestockingFeeReturnMethodItemConditionReturnShippingFeeTypeReturnLabelSource
請參閱accounts.onlineReturnPolicies。
方法
Merchant API 也會進行一些變更，與 Content API 方法不同。
| Content API | Merchant API |
|---|---|
customBatch
|
使用 Merchant API 時，做法有所不同。請參閱「 重構程式碼以處理並行要求」。 |
delete
|
delete
|
get
|
get
|
insert
|
create
|
list
|
list
|