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

列出所有现有的退货政策。