ShippingSettings

商家账号的 [配送设置]((https://support.google.com/merchants/answer/6069284)。

JSON 表示法 
{
  "name": string,
  "services": [
    {
      object (Service)
    }
  ],
  "warehouses": [
    {
      object (Warehouse)
    }
  ],
  "etag": string
}
字段
name

string

标识符。运费设置的资源名称。格式：accounts/{account}/shippingSetting
services[]

object (Service)

可选。目标帐号的服务列表。
warehouses[]

object (Warehouse)

可选。可在 services 中引用的仓库列表。
etag

string

必需。此字段用于避免异步问题。确保在 get call 和 insert call 之间未更改运费设置数据。用户应按以下步骤操作：

  1. 在创建初始运费设置时，将 ETag 字段设置为空字符串。

  2. 初始创建后，调用 get 方法以获取 ETag 和当前的运费设置数据，然后再调用 insert。

  3. 修改为想要的配送设置信息。

  4. 使用从第 2 步获得的 ETag，使用所需的运费设置信息调用 insert 方法。

  5. 如果运费设置数据在第 2 步和第 4 步之间发生更改。插入请求将失败，因为每当运费设置数据更改时，etag 都会更改。用户应使用新的 etag 重复执行第 2-4 步。

服务

配送服务。

JSON 表示法 
{
  "deliveryCountries": [
    string
  ],
  "rateGroups": [
    {
      object (RateGroup)
    }
  ],
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "serviceName": string,
  "active": boolean,
  "currencyCode": string,
  "deliveryTime": {
    object (DeliveryTime)
  },
  "shipmentType": enum (ShipmentType),
  "minimumOrderValue": {
    object (Price)
  },
  "minimumOrderValueTable": {
    object (MinimumOrderValueTable)
  },
  "storeConfig": {
    object (StoreConfig)
  }
}
字段
deliveryCountries[]

string

必需。服务适用的国家/地区的 CLDR 地区代码。
rateGroups[]

object (RateGroup)

可选。配送费率组定义。只有最后一个选项的 applicableShippingLabels 为空，表示“其他”。另一个applicableShippingLabels不得重叠。
loyaltyPrograms[]

object (LoyaltyProgram)

可选。提供此配送服务的会员回馈活动。
serviceName

string

必需。自由格式的服务名称。在目标帐号中必须是唯一的。
active

boolean

必需。显示配送服务处于有效状态的布尔值。
currencyCode

string

此服务适用的货币的 CLDR 代码。必须与费率组中的价格一致。
deliveryTime

object (DeliveryTime)

必需。从下单到交付商品的各个方面所花费的时间。
shipmentType

enum (ShipmentType)

此服务将订单的配送地点类型。
minimumOrderValue

object (Price)

此服务的最低订单金额。如果设置，则表示客户的支出不得低于此金额。一项服务中的所有价格都必须采用相同的币种。不能与 minimumOrderValueTable 一起设置。
minimumOrderValueTable

object (MinimumOrderValueTable)

此表格列出了提货履单类型对应的每家商店的最低订单金额。不能与 minimumOrderValue 同时设置。
storeConfig

object (StoreConfig)

提供您商品的商店列表。这仅对本地配送类型有效。

DeliveryTime

从下单到交付商品的各个方面所花费的时间。

JSON 表示法 
{
  "warehouseBasedDeliveryTimes": [
    {
      object (WarehouseBasedDeliveryTime)
    }
  ],
  "minTransitDays": integer,
  "maxTransitDays": integer,
  "cutoffTime": {
    object (CutoffTime)
  },
  "minHandlingDays": integer,
  "maxHandlingDays": integer,
  "transitTimeTable": {
    object (TransitTable)
  },
  "handlingBusinessDayConfig": {
    object (BusinessDayConfig)
  },
  "transitBusinessDayConfig": {
    object (BusinessDayConfig)
  }
}
字段
warehouseBasedDeliveryTimes[]

object (WarehouseBasedDeliveryTime)

可选。表示应根据所选运输公司的设置按仓库（发货地）计算送货时间。设置后，不应在 [送货时间][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] 中设置其他与运送时间相关的字段。
minTransitDays

integer

在运输途中花费的最小工作日天数。0 表示当天送达，1 表示次日送达。必须设置 minTransitDays、maxTransitDays 或 transitTimeTable，但不能同时设置两者。
maxTransitDays

integer

在运输途中花费的工作日数上限。0 表示当天送达，1 表示次日送达。必须大于或等于 minTransitDays。
cutoffTime

object (CutoffTime)

工作日截止时间定义。如果未配置，截止时间将默认为太平洋标准时间上午 8 点。
minHandlingDays

integer

订单发货前所需的最短工作日天数。0 表示当天发货，1 表示次日发货。
maxHandlingDays

integer

订单发货前所需的最长工作日天数。0 表示当天发货，1 表示次日发货。必须大于或等于 minHandlingDays。
transitTimeTable

object (TransitTable)

运送时间表，运输途中花费的时间（基于行和列维度）。可以设置 minTransitDays、maxTransitDays 或 transitTimeTable，但不能同时设置两者。
handlingBusinessDayConfig

object (BusinessDayConfig)

可以处理订单的工作日。如果未提供，将假定为星期一至星期五的工作日。
transitBusinessDayConfig

object (BusinessDayConfig)

可以运送订单的工作日。如果未提供，将假定为星期一至星期五的工作日。

CutoffTime

工作日截止时间定义。

JSON 表示法 
{
  "hour": integer,
  "minute": integer,
  "timeZone": string
}
字段
hour

integer

必需。截止时间的截止时间，在该时间之前，用户必须在截止时间之前下单才能当天处理。
minute

integer

必需。截止时间的截止时间，在该时间之前，用户必须在截止时间之前下单才能享受当天的处理服务。
timeZone

string

必需。时区标识符，例如“欧洲/苏黎世”。

TransitTable

运送时间表，运输途中花费的时间（基于行和列维度）。可以设置 minTransitDays、maxTransitDays 或 transitTimeTable，但不能同时设置两者。

JSON 表示法 
{
  "postalCodeGroupNames": [
    string
  ],
  "transitTimeLabels": [
    string
  ],
  "rows": [
    {
      object (TransitTimeRow)
    }
  ]
}
字段
postalCodeGroupNames[]

string

必需。区域名称 Region.name 列表。最后一个值可以是 "all other locations"。示例：["zone 1", "zone 2", "all other locations"]。推荐的邮政编码组必须与配送服务的送货国家/地区一致。
transitTimeLabels[]

string

必需。运送时间标签的列表。最后一个值可以是 "all other labels"。示例：["food", "electronics", "all other labels"]。
rows[]

object (TransitTimeRow)

必需。如果只有一个维度集 postalCodeGroupNames 或 transitTimeLabels，则会有多行，每行都有一个该维度的值。如果有两个维度，则每行对应一个 postalCodeGroupNames，列（值）对应一个 transitTimeLabels。

TransitTimeRow

如果只有一个维度集 postalCodeGroupNames 或 transitTimeLabels，则会有多行，每行都有一个该维度的值。如果有两个维度，则每行对应一个 postalCodeGroupNames，列（值）对应一个 transitTimeLabels。

JSON 表示法 
{
  "values": [
    {
      object (TransitTimeValue)
    }
  ]
}
字段
values[]

object (TransitTimeValue)

必需。运送时间范围（最小-最大），以工作日为单位。

TransitTimeValue

运送时间范围（最小-最大），以工作日为单位。

JSON 表示法 
{
  "minTransitDays": integer,
  "maxTransitDays": integer
}
字段
minTransitDays

integer

最短运送时间范围（以工作日计）。0 表示当天送达，1 表示次日送达。
maxTransitDays

integer

必须大于或等于 minTransitDays。

BusinessDayConfig

显示仓库的工作日。

JSON 表示法 
{
  "businessDays": [
    enum (Weekday)
  ]
}
字段
businessDays[]

enum (Weekday)

必需。普通工作日。不得为空。

星期几

枚举
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

WarehouseBasedDeliveryTime

表示应根据所选运输公司的设置按仓库（发货地）计算送货时间。设置后，不应在 deliveryTime 中设置其他与运送时间相关的字段。

JSON 表示法 
{
  "carrier": string,
  "carrierService": string,
  "warehouse": string
}
字段
carrier

string

必需。运营商，例如 "UPS" 或 "Fedex"。
carrierService

string

必需。运营商服务，例如 "ground" 或 "2 days"。服务的名称必须在 eddSupportedServices 列表中。
warehouse

string

必需。仓库名称。此属性应该与 [warehouse][ShippingSetting.warehouses.name] 匹配

RateGroup

配送费率组定义。只有最后一个选项的 applicableShippingLabels 为空，表示“其他”。另一个applicableShippingLabels不得重叠。

JSON 表示法 
{
  "applicableShippingLabels": [
    string
  ],
  "subtables": [
    {
      object (Table)
    }
  ],
  "carrierRates": [
    {
      object (CarrierRate)
    }
  ],
  "singleValue": {
    object (Value)
  },
  "mainTable": {
    object (Table)
  },
  "name": string
}
字段
applicableShippingLabels[]

string

必需。配送标签列表，用于定义此费率组所适用的产品。这是一种析取范畴：只有其中一个标签必须匹配，才能应用费率组。只能对服务的最后一个费率组为空。
subtables[]

object (Table)

可选。mainTable 引用的子表格列表。只有在已设置 mainTable 的情况下才能设置。
carrierRates[]

object (CarrierRate)

可选。可通过 mainTable 或 singleValue 引用的运输公司费率的列表。
singleValue

object (Value)

费率组的值（例如 10 美元固定费率）。只有在未设置 mainTable 和 subtables 时才能设置。
mainTable

object (Table)

当 singleValue 不够表达时，定义费率组的表。仅当未设置 singleValue 时才能设置。
name

string

可选。费率组的名称。如果设置在配送服务中必须是唯一的。

价值

费率组的单个值或费率组表中单元格的值。必须设置 noShipping、flatRate、pricePercentage、carrier_rateName 和 subtable_name 中的一个。

JSON 表示法 
{
  "noShipping": boolean,
  "flatRate": {
    object (Price)
  },
  "pricePercentage": string,
  "carrierRate": string,
  "subtable": string
}
字段
noShipping

boolean

如果为 true，则表示商品无法配送。设置时必须为 true，只有在所有其他字段都未设置时才能设置。
flatRate

object (Price)

固定费率。只有在所有其他字段都未设置时才能设置。
pricePercentage

string

用十进制数字表示的价格百分比（例如 "5.4"）。只有在所有其他字段都未设置时才能设置。
carrierRate

string

表示同一费率组中定义的运输公司费率的运输公司费率的名称。只有在所有其他字段都未设置时才能设置。
subtable

string

子表格的名称。只能在表格单元格中设置（例如，不能针对单个值进行设置），并且只有在所有其他字段都未设置时才能进行设置。

表

当 singleValue 不够表达时，定义费率组的表。

JSON 表示法 
{
  "rows": [
    {
      object (Row)
    }
  ],
  "name": string,
  "rowHeaders": {
    object (Headers)
  },
  "columnHeaders": {
    object (Headers)
  }
}
字段
rows[]

object (Row)

必需。构成表的行的列表。长度必须与 rowHeaders 相同。
name

string

表的名称。对于子表而言是必需的，对于主表而言被忽略。
rowHeaders

object (Headers)

必需。表中各行的标题。
columnHeaders

object (Headers)

表格中各列的标题。可选：如果未设置，则该表格只有一个维度。

标头

表格的行标题或列标题的非空列表。必须设置 prices、weights、num_items、postalCodeGroupNames 或 location 其中之一。

JSON 表示法 
{
  "prices": [
    {
      object (Price)
    }
  ],
  "weights": [
    {
      object (Weight)
    }
  ],
  "numberOfItems": [
    string
  ],
  "postalCodeGroupNames": [
    string
  ],
  "locations": [
    {
      object (LocationIdSet)
    }
  ]
}
字段
prices[]

object (Price)

必需。包含订单价格上限的列表。通过将 price amountMicros = -1 设置为最终价格的值可以设置为无穷大。例如，[{"amountMicros": 10000000, "currencyCode": "USD"}, {"amountMicros": 500000000, "currencyCode": "USD"}, {"amountMicros": -1, "currencyCode": "USD"}] 表示标题“<= $10”“<= $500”和 "> $500”。一项服务中的所有价格都必须采用相同的币种。不得为空。必须为正数，但 -1 除外。只有在所有其他字段都未设置时才能设置。
weights[]

object (Weight)

必需。包含订单权重上限的列表。通过将 price amountMicros = -1 设置为最后一个权重值，该值可以为无穷大。例如，[{"amountMicros": 10000000, "unit": "kg"}, {"amountMicros": 50000000, "unit": "kg"}, {"amountMicros": -1, "unit": "kg"}] 表示标头“<= 10kg”“<= 50kg”和 "> 50kg”。一项服务中的所有权重必须使用相同的单位。不得为空。必须为正数，但 -1 除外。只有在所有其他字段都未设置时才能设置。
numberOfItems[]

string

必需。包含项目数量上限的列表。最后一个值可以是 "infinity"。例如，["10", "50", "infinity"] 表示标题“<= 10 项”“<= 50 项”和“> 50 项”。不得为空。只有在所有其他字段都未设置时才能设置。
postalCodeGroupNames[]

string

必需。邮政群组名称列表。最后一个值可以是 "all other locations"。示例：["zone 1", "zone 2", "all other locations"]。推荐的邮政编码组必须与配送服务的送货国家/地区一致。不得为空。只有在所有其他字段都未设置时才能设置。
locations[]

object (LocationIdSet)

必需。地理位置 ID 集的列表。不得为空。只有在所有其他字段都未设置时才能设置。

重量

以字符串中的值和单位表示的重量。

JSON 表示法 
{
  "unit": enum (WeightUnit),
  "amountMicros": string
}
字段
unit

enum (WeightUnit)

必需。重量单位。可接受的值包括：kg 和 lb
amountMicros

string (int64 format)

必需。重量以微单位表示（100 万微单位等于一个货币标准单位，例如，1 千克 = 1000000 微单位）。此字段还可通过设置为 -1 来设置为无穷大。此字段仅支持 -1 和正值。

WeightUnit

重量单位。

枚举
WEIGHT_UNIT_UNSPECIFIED 未指定单位
POUND 磅单位。
KILOGRAM kg 单位。

LocationIdSet

地理位置 ID 集的列表。不得为空。只有在所有其他字段都未设置时才能设置。

JSON 表示法 
{
  "locationIds": [
    string
  ]
}
字段
locationIds[]

string

必需。地理位置 ID 的非空列表。它们必须都属于相同的营业地点类型（例如州/省级行政区）。

Row

添加单元格列表。

JSON 表示法 
{
  "cells": [
    {
      object (Value)
    }
  ]
}
字段
cells[]

object (Value)

必需。构成行的单元格的列表。对于二维表，长度必须与 columnHeaders 相同；对于一维表，长度必须为 1。

CarrierRate

可通过 mainTable 或 singleValue 引用的运输公司费率的列表。

JSON 表示法 
{
  "name": string,
  "carrier": string,
  "carrierService": string,
  "originPostalCode": string,
  "percentageAdjustment": string,
  "flatAdjustment": {
    object (Price)
  }
}
字段
name

string

必需。运输公司费率的名称。每个费率组都必须唯一。
carrier

string

必需。运营商服务，例如 "UPS" 或 "Fedex"。
carrierService

string

必需。运营商服务，例如 "ground" 或 "2 days"。
originPostalCode

string

必需。此运输公司费率的发货地。
percentageAdjustment

string

可选。用十进制数字表示的乘法运费修饰符。可以是负数。例如，"5.4" 会使费率提高 5.4%，"-3" 会使费率降低 3%。
flatAdjustment

object (Price)

可选。添加运费修饰符。可以是负数。例如，{ "amountMicros": 1, "currencyCode" : "USD" } 会在费率上增加 1 美元，{ "amountMicros": -3, "currencyCode" : "USD" } 则会从费率中移除 3 美元。

ShipmentType

配送服务的配送类型。

枚举
SHIPMENT_TYPE_UNSPECIFIED 此服务未指定运单类型。
DELIVERY 这项服务会将订单配送到客户选择的地址。
LOCAL_DELIVERY 这项服务会将订单配送到客户选择的地址。订单商品从附近的本地商店发货。
COLLECTION_POINT 这项服务会将订单配送到客户选择的地址。订单商品从取件点发货。

MinimumOrderValueTable

此表格列出了提货履单类型对应的每家商店的最低订单金额。

JSON 表示法 
{
  "storeCodeSetWithMovs": [
    {
      object (StoreCodeSetWithMov)
    }
  ]
}
字段
storeCodeSetWithMovs[]

object (StoreCodeSetWithMov)

必需。具有相同最低订单金额 (MOV) 的一系列商店代码。至少需要两组，最后一组必须为空，这表示“适用于所有其他商店的 MOV”。每个商店代码在所有集合中都只能出现一次。一项服务中的所有价格都必须采用相同的币种。

StoreCodeSetWithMov

具有相同最低订单金额的一系列商店代码。至少需要两组，最后一组必须为空，这表示“适用于所有其他商店的 MOV”。每个商店代码在所有集合中都只能出现一次。一项服务中的所有价格都必须采用相同的币种。

JSON 表示法 
{
  "storeCodes": [
    string
  ],
  "value": {
    object (Price)
  }
}
字段
storeCodes[]

string

可选。唯一的商店代码列表或空的综合性商店代码。
value

object (Price)

指定商店的最低订单金额。

StoreConfig

提供您商品的商店列表。这仅对本地配送类型有效。

JSON 表示法 
{
  "storeCodes": [
    string
  ],
  "storeServiceType": enum (StoreServiceType),
  "cutoffConfig": {
    object (CutoffConfig)
  },
  "serviceRadius": {
    object (Distance)
  }
}
字段
storeCodes[]

string

可选。一个提供本地送货服务的商店代码列表。如果为空，则 all_stores 必须为 true。
storeServiceType

enum (StoreServiceType)

指明此商家列出的所有商店或选定的商店是否都提供本地送货服务。
cutoffConfig

object (CutoffConfig)

与本地配送相关的配置会在当天结束。
serviceRadius

object (Distance)

最大配送半径范围。只有本地送货配送类型需要此字段。

StoreServiceType

指明商家列出的所有商店或选定的商店是否提供本地送货服务。

枚举
STORE_SERVICE_TYPE_UNSPECIFIED 未指定商店服务类型。
ALL_STORES 指明此商家列出的当前和未来的所有商店是否都提供本地送货服务。
SELECTED_STORES 表示只有 storeCodes 中列出的商店才支持本地配送。

CutoffConfig

与本地配送相关的配置会在当天结束。

JSON 表示法 
{
  "localCutoffTime": {
    object (LocalCutoffTime)
  },
  "storeCloseOffsetHours": string,
  "noDeliveryPostCutoff": boolean
}
字段
localCutoffTime

object (LocalCutoffTime)

当天本地送货结束的时间。
storeCloseOffsetHours

string (int64 format)

仅对本地交付履单有效。表示截止时间为商店打烊前的几个小时。它与 localCutoffTime 相互排斥。
noDeliveryPostCutoff

boolean

如果商家的配送服务配置为 n 天本地送达，那么商家可以选择不显示 n+1 天本地送货服务。例如，如果配送服务定义当天送达，并且已超过截止时间，则将此字段设置为 true 会导致计算出的配送服务费率返回 NO_DELIVERY_POST_CUTOFF。在同一个示例中，如果将此字段设置为 false，则计算的配送时间为一天。这仅适用于本地配送。

LocalCutoffTime

当天本地送货结束的时间。

JSON 表示法 
{
  "hour": string,
  "minute": string
}
字段
hour

string (int64 format)

您必须在 之前按小时处理本地配送订单，才能在当天处理。
minute

string (int64 format)

本地币种为分钟外卖订单的下单截止时间为“当天”。

距离

最大配送半径范围。只有本地送货配送类型需要此字段。

JSON 表示法 
{
  "value": string,
  "unit": enum (Unit)
}
字段
value

string (int64 format)

距离的整数值。
unit

enum (Unit)

单位可能会因国家/地区而异，其参数已包括英里和公里。

单位

单位可能会因国家/地区而异，其参数已包括英里和公里。

枚举
UNIT_UNSPECIFIED 未指定单位
MILES 以英里为单位
KILOMETERS 单位（公里）

LoyaltyProgram

商家提供的会员回馈活动。

JSON 表示法 
{
  "loyaltyProgramTiers": [
    {
      object (LoyaltyProgramTiers)
    }
  ],
  "programLabel": string
}
字段
loyaltyProgramTiers[]

object (LoyaltyProgramTiers)

可选。此配送服务的会员回馈活动等级。
programLabel

string

这是您在 Merchant Center 的会员回馈活动设置中设定的会员回馈活动标签。通过该子属性，Google 可以将您的会员回馈活动映射到符合条件的商品。

LoyaltyProgramTiers

商家会员回馈活动的子集。

JSON 表示法 
{
  "tierLabel": string
}
字段
tierLabel

string

层级标签 [tierLabel] 子属性用于区分各个层级的商品级福利。此值也是在 Merchant Center 的会员回馈活动设置中设定的，即使您的会员回馈活动只有一个层级，在更改数据源时也必须提供此值。

数据仓库

用来存储和处理库存的履单仓库。下一个代码：7

JSON 表示法 
{
  "name": string,
  "shippingAddress": {
    object (Address)
  },
  "cutoffTime": {
    object (WarehouseCutoffTime)
  },
  "handlingDays": string,
  "businessDayConfig": {
    object (BusinessDayConfig)
  }
}
字段
name

string

必需。仓库的名称。在帐号中必须是唯一的。
shippingAddress

object (Address)

必需。仓库的送货地址。
cutoffTime

object (WarehouseCutoffTime)

必需。一天中可接受订单并开始处理的最晚时间。之后的订单会在次日处理。时间以仓库邮政编码为准。
handlingDays

string (int64 format)

必需。此仓库打包并发货所需的天数。此属性在仓库级别，但可以根据商品的属性在商品级别被替换。
businessDayConfig

object (BusinessDayConfig)

显示仓库的工作日。如果未设置，则默认为周一至周五。

地址

仓库的送货地址。

JSON 表示法 
{
  "streetAddress": string,
  "city": string,
  "administrativeArea": string,
  "postalCode": string,
  "regionCode": string
}
字段
streetAddress

string

地址的街道级部分。例如：111w 31st Street。
city

string

必需。城市、城镇或公社。还可以包括乡镇/郊区（例如社区或郊区）。
administrativeArea

string

必需。国家/地区的顶级行政区划。例如，加利福尼亚州（以下简称“CA”）或魁北克等省（以下简称“魁北克”）。
postalCode

string

必需。邮政编码（例如“100000”）。
regionCode

string

必需。CLDR 国家/地区代码（例如“US”）。

WarehouseCutoffTime

一天中可接受订单并开始处理的最晚时间。之后的订单会在次日处理。时间以仓库邮政编码为准。

JSON 表示法 
{
  "hour": integer,
  "minute": integer
}
字段
hour

integer

必需。截止时间的截止时间，之后仓库必须下单才能当天处理订单。小时根据仓库所在的时区而定。
minute

integer

必需。截止时间的截止时间，以便仓库在当天处理订单。该分钟数根据仓库所在的时区而定。