REST Resource: accounts.onlineReturnPolicies

资源:OnlineReturnPolicy

在线退货政策对象。此属性目前用于表示广告和非付费商品详情计划的退货政策。

JSON 表示法
{
  "name": string,
  "returnPolicyId": string,
  "label": string,
  "countries": [
    string
  ],
  "policy": {
    object (Policy)
  },
  "restockingFee": {
    object (RestockingFee)
  },
  "returnMethods": [
    enum (ReturnMethod)
  ],
  "itemConditions": [
    enum (ItemCondition)
  ],
  "returnShippingFee": {
    object (ReturnShippingFee)
  },
  "returnPolicyUri": string,
  "acceptDefectiveOnly": boolean,
  "processRefundDays": integer,
  "acceptExchange": boolean
}
字段
name

string

标识符。OnlineReturnPolicy 资源的名称。格式:accounts/{account}/onlineReturnPolicies/{return_policy}

returnPolicyId

string

仅限输出。Google 生成的退货政策 ID。

label

string

必需。不可变。此字段表示退货政策的用户定义的唯一标签。请务必注意,同一国家/地区的不同退货政策不能使用相同的标签。除非商品指定了特定的标签属性,否则系统会自动将政策标记为“默认”。如需为特定商品组分配自定义退货政策,请按照退货政策标签中提供的说明操作。标签最多可包含 50 个字符。

countries[]

string

必需。不可变。退货政策适用的销售国家/地区。值必须是有效的 2 个字母 ISO 3166 代码。

policy

object (Policy)

退货政策。

restockingFee

object (RestockingFee)

适用于所有退货原因类别的重新上架费。如果未设置此值,则系统会将其视为免费的重新上架费用。

returnMethods[]

enum (ReturnMethod)

客户可以通过哪些退货方式退回商品。除非退货政策类型为 noReturns,否则此值不得为空。

itemConditions[]

enum (ItemCondition)

除非退货政策类型为“noReturns”,否则接受退货的商品条件不得为空。

returnShippingFee

object (ReturnShippingFee)

退货运费。仅当客户需要下载和打印退货单时,才应设置此属性。

returnPolicyUri

string

必需。退货政策 URI。Google 可以使用此信息对政策进行合理性检查。此值必须是有效网址。

acceptDefectiveOnly

boolean

此字段用于指定商家是否仅接受有缺陷的商品的退货,并且此字段为必填字段。

processRefundDays

integer

此字段用于指定商家处理退款所需的天数,该字段为可选字段。

acceptExchange

boolean

此字段用于指定商家是否允许客户换货,此字段为必填字段。

政策

可用的政策。

JSON 表示法
{
  "type": enum (Type),
  "days": string
}
字段
type

enum (Type)

政策类型。

days

string (int64 format)

商品送达后的退货期限(天数),其中一天定义为送达时间戳后的 24 小时。NUMBER_OF_DAYS_AFTER_DELIVERY 返回时必需。

类型

退货政策类型。

枚举
TYPE_UNSPECIFIED 默认值。此值未使用。
NUMBER_OF_DAYS_AFTER_DELIVERY 商品送达后可退货的天数。
NO_RETURNS 不可退货。
LIFETIME_RETURNS 终身可退货。

RestockingFee

重新上架费。这可以是固定费用或微百分比。

JSON 表示法
{

  // Union field type can be only one of the following:
  "fixedFee": {
    object (Price)
  },
  "microPercent": integer
  // End of list of possible types for union field type.
}
字段

联合字段 type

type 只能是下列其中一项:

fixedFee

object (Price)

固定的重新上架费。

microPercent

integer

以百万分之一表示的总价百分比。15,000,000 表示系统会收取总价的 15%。

ReturnMethod

可用的退货方式。

枚举
RETURN_METHOD_UNSPECIFIED 默认值。此值未使用。
BY_MAIL 通过邮寄方式退回。
IN_STORE 在实体店内退货。
AT_A_KIOSK 在自助服务终端退货。

ItemCondition

可用的商品状况。

枚举
ITEM_CONDITION_UNSPECIFIED 默认值。此值未使用。
NEW 新建。
USED 已使用。

ReturnShippingFee

退货运费。这可以是固定费用,也可以是布尔值,用于指明客户支付实际运费。

JSON 表示法
{
  "type": enum (Type),
  "fixedFee": {
    object (Price)
  }
}
字段
type

enum (Type)

必需。退货运费的类型。

fixedFee

object (Price)

固定的退货运费金额。此值仅适用于类型为 FIXED 时。如果 type 为 FIXED 且未设置此值,我们将将退货运费视为免运费。

类型

退货运费类型。

枚举
TYPE_UNSPECIFIED 默认值。此值未使用。
FIXED 退货运费是固定值。
CUSTOMER_PAYING_ACTUAL_FEE 客户需支付实际的退货运费。

方法

get

获取指定商家的现有退货政策。

list

列出指定商家的所有现有退货政策。