Content API 资源 OnlineReturnPolicy 和相关字段（包括 ReturnPolicyPolicy 和 ReturnPolicySeasonalOverride）已发生变化。
Merchant API 中 returnpolicy 资源在 Content 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。它表示商品在送达后可以退货的天数，其中一天是指送达时间戳后的 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。
方法
与 Content API 方法相比，Merchant API 也发生了一些变化。
| Content API | Merchant API |
|---|---|
customBatch
|
使用 Merchant API 时，方法有所不同。请参阅 重构代码以支持并发请求。 |
delete
|
delete
|
get
|
get
|
insert
|
create
|
list
|
list
|