- JSON 表示法
- 服务
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- DeliveryTime
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CutoffTime
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TransitTable
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TransitTimeRow
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TransitTimeValue
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- BusinessDayConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 工作日
- WarehouseBasedDeliveryTime
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- RateGroup
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- Value
- 表
- 标头
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 体重
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- WeightUnit
- LocationIdSet
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 行
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- CarrierRate
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ShipmentType
- MinimumOrderValueTable
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- StoreCodeSetWithMov
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- StoreConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- StoreServiceType
- CutoffConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LocalCutoffTime
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 距离
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 单位
- LoyaltyProgram
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LoyaltyProgramTiers
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 仓库
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 地址
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- WarehouseCutoffTime
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
商家账号的 [配送设置]((https://support.google.com/merchants/answer/6069284)。
JSON 表示法 |
---|
{ "name": string, "services": [ { object ( |
字段 | |
---|---|
name |
标识符。运费设置的资源名称。格式: |
services[] |
可选。目标账号的服务列表。 |
warehouses[] |
可选。可在 |
etag |
必需。此字段用于避免异步问题。确保在 get call 和 insert call 之间未更改运费设置数据。用户应按以下步骤操作:
|
服务
配送服务。
JSON 表示法 |
---|
{ "deliveryCountries": [ string ], "rateGroups": [ { object ( |
字段 | |
---|---|
deliveryCountries[] |
必需。服务适用的国家/地区的 CLDR 地区代码。 |
rateGroups[] |
可选。配送费率组定义。只有最后一个选项的 |
loyaltyPrograms[] |
可选。提供此配送服务的会员回馈活动。 |
serviceName |
必需。自由格式的服务名称。在目标账号中必须是唯一的。 |
active |
必需。显示配送服务处于有效状态的布尔值。 |
currencyCode |
此服务适用的货币的 CLDR 代码。必须与费率组中的价格一致。 |
deliveryTime |
必需。从下单到交付商品的各个方面所花费的时间。 |
shipmentType |
此服务将订单所要送到的营业地点的类型。 |
minimumOrderValue |
此服务的最低订单金额。如果设置,则表示客户的支出不得低于此金额。一项服务中的所有价格都必须采用相同的币种。不能与 minimumOrderValueTable 一起设置。 |
minimumOrderValueTable |
此表格列出了提货履单类型对应的每家商店的最低订单金额。不能与 minimumOrderValue 同时设置。 |
storeConfig |
提供您商品的商店列表。这仅对本地配送类型有效。 |
DeliveryTime
从下单到交付商品的各个方面所花费的时间。
JSON 表示法 |
---|
{ "warehouseBasedDeliveryTimes": [ { object ( |
字段 | |
---|---|
warehouseBasedDeliveryTimes[] |
可选。表示应根据所选运输公司的设置按仓库(发货地)计算送货时间。设置后,不应在 [送货时间][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] 中设置其他与运送时间相关的字段。 |
minTransitDays |
在运输途中花费的最小工作日天数。0 表示当天送达,1 表示次日送达。必须设置 |
maxTransitDays |
在运输途中花费的工作日数上限。0 表示当天送达,1 表示次日送达。必须大于或等于 |
cutoffTime |
工作日截止时间定义。如果未配置,截止时间将默认为太平洋标准时间上午 8 点。 |
minHandlingDays |
订单发货前所需的最短工作日天数。0 表示当天发货,1 表示次日发货。 |
maxHandlingDays |
订单发货前所需的最长工作日天数。0 表示当天发货,1 表示次日发货。必须大于或等于 |
transitTimeTable |
运送时间表,运输途中花费的时间(基于行和列维度)。可以设置 |
handlingBusinessDayConfig |
可以处理订单的工作日。如果未提供,将假定为星期一至星期五的工作日。 |
transitBusinessDayConfig |
可以运送订单的工作日。如果未提供,将假定为星期一至星期五的工作日。 |
CutoffTime
工作日截止时间定义。
JSON 表示法 |
---|
{ "hour": integer, "minute": integer, "timeZone": string } |
字段 | |
---|---|
hour |
必需。截止时间的截止时间,在该时间之前,用户必须在截止时间之前下单才能当天处理。 |
minute |
必需。截止时间的截止时间,在该时间之前,用户必须在截止时间之前下单才能当天处理。 |
timeZone |
必需。时区标识符,例如“欧洲/苏黎世”。 |
TransitTable
运送时间表,运输途中花费的时间(基于行和列维度)。可以设置 minTransitDays
、maxTransitDays
或 transitTimeTable
,但不能同时设置两者。
JSON 表示法 |
---|
{
"postalCodeGroupNames": [
string
],
"transitTimeLabels": [
string
],
"rows": [
{
object ( |
字段 | |
---|---|
postalCodeGroupNames[] |
必需。区域名称 |
transitTimeLabels[] |
必需。运送时间标签的列表。最后一个值可以是 |
rows[] |
必需。如果只有一个维度集 |
TransitTimeRow
如果只有一个维度集 postalCodeGroupNames
或 transitTimeLabels
,则会有多行,每行都有一个该维度的值。如果有两个维度,则每行对应一个 postalCodeGroupNames
,列(值)对应一个 transitTimeLabels
。
JSON 表示法 |
---|
{
"values": [
{
object ( |
字段 | |
---|---|
values[] |
必需。运送时间范围(最小-最大),以工作日为单位。 |
TransitTimeValue
运送时间范围(最小-最大),以工作日为单位。
JSON 表示法 |
---|
{ "minTransitDays": integer, "maxTransitDays": integer } |
字段 | |
---|---|
minTransitDays |
最短运送时间范围(以工作日计)。0 表示当天送达,1 表示次日送达。 |
maxTransitDays |
必须大于或等于 |
BusinessDayConfig
显示仓库的工作日。
JSON 表示法 |
---|
{
"businessDays": [
enum ( |
字段 | |
---|---|
businessDays[] |
必需。普通工作日。不得为空。 |
星期几
枚举 | |
---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
WarehouseBasedDeliveryTime
表示应根据所选运输公司的设置按仓库(发货地)计算送货时间。设置后,不应在 deliveryTime
中设置其他与运送时间相关的字段。
JSON 表示法 |
---|
{ "carrier": string, "carrierService": string, "warehouse": string } |
字段 | |
---|---|
carrier |
必需。运营商,例如 |
carrierService |
必需。运营商服务,例如 |
warehouse |
必需。仓库名称。此属性应该与 [warehouse][ShippingSetting.warehouses.name] 匹配 |
RateGroup
配送费率组定义。只有最后一个选项的 applicableShippingLabels
为空,表示“其他”。另一个applicableShippingLabels
不得重叠。
JSON 表示法 |
---|
{ "applicableShippingLabels": [ string ], "subtables": [ { object ( |
字段 | |
---|---|
applicableShippingLabels[] |
必需。配送标签列表,用于定义此费率组所适用的产品。这是一种析取范畴:只有其中一个标签必须匹配,才能应用费率组。只能对服务的最后一个费率组为空。 |
subtables[] |
可选。 |
carrierRates[] |
可选。可通过 |
singleValue |
费率组的值(例如 10 美元固定费率)。只有在未设置 |
mainTable |
当 |
name |
可选。费率组的名称。如果设置在配送服务中必须是唯一的。 |
值
费率组的单个值或费率组表中单元格的值。必须设置 noShipping
、flatRate
、pricePercentage
、carrier_rateName
和 subtable_name
中的一个。
JSON 表示法 |
---|
{
"noShipping": boolean,
"flatRate": {
object ( |
字段 | |
---|---|
noShipping |
如果为 true,则表示商品无法配送。设置时必须为 true,只有在所有其他字段都未设置时才能设置。 |
flatRate |
固定费率。只有在所有其他字段都未设置时才能设置。 |
pricePercentage |
价格的百分比,用十进制数字表示(例如 |
carrierRate |
运输公司费率的名称,表示同一费率组中定义的运输公司费率。只有在所有其他字段都未设置时才能设置。 |
subtable |
子表格的名称。只能在表格单元格中设置(例如,不能针对单个值进行设置),并且只有在所有其他字段都未设置时才能进行设置。 |
表
当 singleValue
不够表达时,定义费率组的表。
JSON 表示法 |
---|
{ "rows": [ { object ( |
字段 | |
---|---|
rows[] |
必需。构成表的行的列表。长度必须与 |
name |
表的名称。对于子表而言是必需的,对于主表而言被忽略。 |
rowHeaders |
必需。表中各行的标题。 |
columnHeaders |
表格中各列的标题。可选:如果未设置,则该表格只有一个维度。 |
标头
表格的行标题或列标题的非空列表。必须设置 prices
、weights
、num_items
、postalCodeGroupNames
或 location
其中之一。
JSON 表示法 |
---|
{ "prices": [ { object ( |
字段 | |
---|---|
prices[] |
必需。包含订单价格上限的列表。通过将 price amountMicros = -1 设置为最终价格的值可以设置为无穷大。例如, |
weights[] |
必需。包含订单权重上限的列表。通过将 price amountMicros = -1 设置为最后一个权重值,该值可以为无穷大。例如, |
numberOfItems[] |
必需。包含项目数量上限的列表。最后一个值可以是 |
postalCodeGroupNames[] |
必需。邮政群组名称列表。最后一个值可以是 |
locations[] |
必需。地理位置 ID 集的列表。不得为空。只有在所有其他字段都未设置时才能设置。 |
重量
以字符串中的值和单位表示的重量。
JSON 表示法 |
---|
{
"unit": enum ( |
字段 | |
---|---|
unit |
必需。重量单位。可接受的值包括:kg 和 lb |
amountMicros |
必需。重量以微单位表示(100 万微单位等于一个货币标准单位,例如,1 千克 = 1000000 微单位)。此字段还可通过设置为 -1 来设置为无穷大。此字段仅支持 -1 和正值。 |
WeightUnit
重量单位。
枚举 | |
---|---|
WEIGHT_UNIT_UNSPECIFIED |
未指定单位 |
POUND |
磅单位。 |
KILOGRAM |
kg 单位。 |
LocationIdSet
地理位置 ID 集的列表。不得为空。只有在所有其他字段都未设置时才能设置。
JSON 表示法 |
---|
{ "locationIds": [ string ] } |
字段 | |
---|---|
locationIds[] |
必需。地理位置 ID 的非空列表。它们必须都属于相同的营业地点类型(例如州/省级行政区)。 |
行
添加单元格列表。
JSON 表示法 |
---|
{
"cells": [
{
object ( |
字段 | |
---|---|
cells[] |
必需。构成行的单元格的列表。对于二维表,长度必须与 |
CarrierRate
可通过 mainTable
或 singleValue
引用的运输公司费率的列表。
JSON 表示法 |
---|
{
"name": string,
"carrier": string,
"carrierService": string,
"originPostalCode": string,
"percentageAdjustment": string,
"flatAdjustment": {
object ( |
字段 | |
---|---|
name |
必需。运输公司费率的名称。每个费率组都必须唯一。 |
carrier |
必需。运营商服务,例如 |
carrierService |
必需。运营商服务,例如 |
originPostalCode |
必需。此运输公司费率的发货地。 |
percentageAdjustment |
可选。用十进制数字表示的乘法运费修饰符。可以是负数。例如, |
flatAdjustment |
可选。运费调节系数相加。可以是负数。例如, |
ShipmentType
配送服务的配送类型。
枚举 | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
此服务未指定运单类型。 |
DELIVERY |
这项服务会将订单配送到客户选择的地址。 |
LOCAL_DELIVERY |
这项服务会将订单配送到客户选择的地址。订单商品从附近的本地商店发货。 |
COLLECTION_POINT |
这项服务会将订单配送到客户选择的地址。订单商品从取件点发货。 |
MinimumOrderValueTable
此表格列出了提货履单类型对应的每家商店的最低订单金额。
JSON 表示法 |
---|
{
"storeCodeSetWithMovs": [
{
object ( |
字段 | |
---|---|
storeCodeSetWithMovs[] |
必需。具有相同最低订单金额 (MOV) 的一系列商店代码集。至少需要两组,最后一组必须为空,这表示“适用于所有其他商店的 MOV”。每个商店代码在所有集合中都只能出现一次。一项服务中的所有价格都必须采用相同的币种。 |
StoreCodeSetWithMov
具有相同最低订单金额的一系列商店代码。至少需要两组,最后一组必须为空,这表示“适用于所有其他商店的 MOV”。每个商店代码在所有集合中都只能出现一次。一项服务中的所有价格都必须采用相同的币种。
JSON 表示法 |
---|
{
"storeCodes": [
string
],
"value": {
object ( |
字段 | |
---|---|
storeCodes[] |
可选。唯一的商店代码列表或空的综合性商店代码。 |
value |
指定商店的最低订单金额。 |
StoreConfig
提供您商品的商店列表。这仅对本地配送类型有效。
JSON 表示法 |
---|
{ "storeCodes": [ string ], "storeServiceType": enum ( |
字段 | |
---|---|
storeCodes[] |
可选。一个提供本地送货服务的商店代码列表。如果为空,则 |
storeServiceType |
指明此商家列出的所有商店或选定的商店是否都提供本地送货服务。 |
cutoffConfig |
与本地配送相关的配置会在当天结束。 |
serviceRadius |
最大配送半径范围。只有本地送货配送类型需要此字段。 |
StoreServiceType
指明商家列出的所有商店或选定的商店是否提供本地送货服务。
枚举 | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
未指定商店服务类型。 |
ALL_STORES |
指明此商家列出的当前和未来的所有商店是否都提供本地送货服务。 |
SELECTED_STORES |
表示只有 storeCodes 中列出的商店才支持本地配送。 |
CutoffConfig
与本地配送相关的配置会在当天结束。
JSON 表示法 |
---|
{
"localCutoffTime": {
object ( |
字段 | |
---|---|
localCutoffTime |
当天本地送货结束的时间。 |
storeCloseOffsetHours |
仅对本地交付履单有效。表示截止时间为商店打烊前的几个小时。它与 |
noDeliveryPostCutoff |
如果商家的配送服务配置为 n 天本地送达,那么商家可以选择不显示 n+1 天本地送货服务。例如,如果配送服务定义当天送达,并且已超过截止时间,则将此字段设置为 |
LocalCutoffTime
当天本地送货结束的时间。
JSON 表示法 |
---|
{ "hour": string, "minute": string } |
字段 | |
---|---|
hour |
您必须在 之前按小时处理本地配送订单,才能在当天处理。 |
minute |
本地币种为分钟外卖订单的下单截止时间为“当天”。 |
距离
最大配送半径范围。只有本地送货配送类型需要此字段。
JSON 表示法 |
---|
{
"value": string,
"unit": enum ( |
字段 | |
---|---|
value |
距离的整数值。 |
unit |
单位可能会因国家/地区而异,其参数已包括英里和公里。 |
单位
单位可能会因国家/地区而异,其参数已包括英里和公里。
枚举 | |
---|---|
UNIT_UNSPECIFIED |
未指定单位 |
MILES |
以英里为单位 |
KILOMETERS |
单位(公里) |
LoyaltyProgram
商家提供的会员回馈活动。
JSON 表示法 |
---|
{
"loyaltyProgramTiers": [
{
object ( |
字段 | |
---|---|
loyaltyProgramTiers[] |
可选。此配送服务的会员回馈活动等级。 |
programLabel |
这是您在 Merchant Center 的会员回馈活动设置中设定的会员回馈活动标签。通过该子属性,Google 可以将您的会员回馈活动映射到符合条件的商品。 |
LoyaltyProgramTiers
商家会员回馈活动的子集。
JSON 表示法 |
---|
{ "tierLabel": string } |
字段 | |
---|---|
tierLabel |
层级标签 [tierLabel] 子属性用于区分各个层级的商品级福利。此值也是在 Merchant Center 的会员回馈活动设置中设定的,即使您的会员回馈活动只有一个层级,在更改数据源时也必须提供此值。 |
仓库
用来存储和处理库存的履单仓库。下一个代码:7
JSON 表示法 |
---|
{ "name": string, "shippingAddress": { object ( |
字段 | |
---|---|
name |
必需。仓库的名称。在账号中必须是唯一的。 |
shippingAddress |
必需。仓库的送货地址。 |
cutoffTime |
必需。一天中可接受订单并开始处理的最晚时间。较晚的订单将在次日处理。时间以仓库邮政编码为准。 |
handlingDays |
必需。此仓库打包并发货所需的天数。这在仓库级别,但可以根据商品的属性在商品级别被替换。 |
businessDayConfig |
显示仓库的工作日。如果未设置,则默认为周一至周五。 |
地址
仓库的送货地址。
JSON 表示法 |
---|
{ "streetAddress": string, "city": string, "administrativeArea": string, "postalCode": string, "regionCode": string } |
字段 | |
---|---|
streetAddress |
地址的街道级别部分。例如: |
city |
必需。城市、城镇或公社。还可以包括乡镇/郊区(例如社区或郊区)。 |
administrativeArea |
必需。国家/地区的顶级行政区划。例如,加利福尼亚州(以下简称“CA”)或魁北克之类的省(以下简称“魁北克”)。 |
postalCode |
必需。邮政编码(例如“100000”)。 |
regionCode |
必需。CLDR 国家/地区代码(例如“US”)。 |
WarehouseCutoffTime
一天中可接受订单并开始处理的最晚时间。较晚的订单将在次日处理。时间以仓库邮政编码为准。
JSON 表示法 |
---|
{ "hour": integer, "minute": integer } |
字段 | |
---|---|
hour |
必需。截止时间的截止时间,之后仓库必须下单才能当天处理订单。小时根据仓库所在的时区而定。 |
minute |
必需。截止时间的截止时间,以便仓库在当天处理订单。该分钟数根据仓库所在的时区而定。 |