ShippingSettings

商家账号的配送设置

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 调用和 insert 调用之间,配送设置数据没有更改。用户应按以下步骤操作:

  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 表示次日送达。必须设置 minTransitDaysmaxTransitDaystransitTimeTable,但不能同时设置两者。

maxTransitDays

integer

运送所需的最长工作日数。0 表示当天送达,1 表示次日送达。必须大于或等于 minTransitDays

cutoffTime

object (CutoffTime)

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

minHandlingDays

integer

订单发货前所需的最短工作日天数。0 表示当天发货,1 表示次日发货。“minHandlingDays”和“maxHandlingDays”应同时设置或同时不设置。

maxHandlingDays

integer

订单发货前所需的最长工作日天数。0 表示当天发货,1 表示次日发货。必须大于或等于 minHandlingDays。“minHandlingDays”和“maxHandlingDays”应同时设置或同时不设置。

transitTimeTable

object (TransitTable)

运送时间表,运输途中花费的时间(基于行和列维度)。您可以设置 minTransitDaysmaxTransitDaystransitTimeTable,但不能同时设置这两者。

handlingBusinessDayConfig

object (BusinessDayConfig)

可以处理订单的工作日。如果未提供,系统会假定为周一至周五的工作日。

transitBusinessDayConfig

object (BusinessDayConfig)

可以运送订单的工作日。如果未提供,系统会假定为周一至周五的工作日。

CutoffTime

工作日截止时间定义。

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

integer

必需。截止时间(下单截止时间),订单必须在此之前下单,才能在当天处理。

minute

integer

必需。截止时间的分钟数,订单必须在此时间之前下单,才能在当天处理。

timeZone

string

必需。时区标识符,例如“Europe/Zurich”。

TransitTable

运送时间表,运输途中花费的时间(基于行和列维度)。您可以设置 minTransitDaysmaxTransitDaystransitTimeTable,但不能同时设置这两者。

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)

必需。如果只有一个维度集 postalCodeGroupNamestransitTimeLabels,则会有多行,每行都有一个该维度的值。如果有两个维度,则每行对应一个 postalCodeGroupNames,列(值)对应一个 transitTimeLabels

TransitTimeRow

如果只有一个 postalCodeGroupNamestransitTimeLabels 维度集,则有多个行,每行包含一个该维度的值。如果有两个维度,则每行对应于 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)

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

singleValue

object (Value)

费率组的值(例如 10 美元固定费率)。只有在未设置 mainTablesubtables 时才能设置此项。

mainTable

object (Table)

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

name

string

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

费率组的单个值或费率组表中单元格的值。必须设置 noShippingflatRatepricePercentagecarrier_rateNamesubtable_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)

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

标头

表格的行标题或列标题的非空列表。必须设置 pricesweightsnum_itemspostalCodeGroupNameslocation 其中之一。

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 公斤单位。

LocationIdSet

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

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

string

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

添加单元格列表。

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

object (Value)

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

CarrierRate

可通过 mainTablesingleValue 引用的运输公司费率的列表。

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”)或魁北克省(“QC”)等州/省。

postalCode

string

必需。邮政编码(例如“100000”)。

regionCode

string

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

WarehouseCutoffTime

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

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

integer

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

minute

integer

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