通过 ShippingSettings
资源,您可以检索和更新账号及其关联的所有子账号的配送设置。如需详细了解如何添加或管理账号的配送设置,请参阅配送设置概览。
如需使用 Merchant API 读取配送设置信息,请使用以下请求:
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings
将 {ACCOUNT_ID} 替换为您的 Merchant Center 账号的唯一标识符。
如需使用 Merchant API 更新配送设置信息,请使用以下请求:
POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert
如需了解详情,请参阅方法:accounts.shippingSettings.insert
。
Content API for Shopping 与 Merchant API 之间的比较
下面是一个示例,用于比较 Content API for Shopping 与 Accounts 子 API 中的 Shipping 设置资源:
Content API | Merchant API | |
---|---|---|
网址 | https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/shippingsettings/{ACCOUNT_ID} |
https://merchantapi.googleapis.com/accounts/v1/accounts/ {ACCOUNT_ID}/shippingSettings:insert |
标识符 | {MERCHANT_ID}/shippingsettings/ {ACCOUNT_ID} |
{NAME} |
与 Content API for Shopping 相比,Accounts 子 API 中的配送设置资源有以下主要更新:
- 商家 API 用户必须将
accounts/{ACCOUNT_ID}/shippingSettings
放入 {NAME} 字段,才能获得相同的行为。 - Merchant API 不支持对自定义区域(例如营业地点组)执行读取和写入操作。位置组等自定义区域只能使用区域服务进行读取或写入。
- Merchant API 中的一项服务支持多个配送国家/地区。
- 与 Content API 中的 shippingsettings.list 方法不同,Merchant API 不提供用于列出配送设置的列表方法。
新增了支持的字段
与 Content API for Shopping 相比,Accounts 子 API 中的配送设置资源支持以下新字段:
warehouses
:提供有关仓储和处理商品目录的履单仓库的信息。- 会员回馈活动:Merchant API 用户可以在配送设置中输入会员回馈活动信息。
- Etag:Etag 旨在解决以下异步问题:当不同用户尝试同时使用 Merchant API 和 Merchant Center 界面更新配送设置时,可能会出现此类问题。
重命名的字段
在 Accounts 子 API 的“配送”设置资源中,以下字段已重命名:
Content API for Shopping | 配送设置资源 | 说明 |
---|---|---|
service |
services |
单个配送服务。 |
service.name |
services.serviceName |
服务的自由格式名称,在您的 Merchant Center 账号中必须是唯一的。 |
service.deliveryCountry |
services.deliveryCountries |
配送服务所适用的国家/地区的 CLDR 地区代码。 |
service.currency |
services.currencyCode |
相应服务所适用的币种的 CLDR 代码。 |
service.deliveryTime.minTransitTimeInDays |
services.deliveryTime.minTransitDays |
订单在运输途中所需的最少工作日数。例如,0 表示当天送达,1 表示次日送达。 |
service.deliveryTime.maxTransitTimeInDays |
services.deliveryTime.maxTransitDays |
订单在运送过程中花费的最长工作日天数。 |
service.deliveryTime.minHandlingTimeInDays |
services.deliveryTime.minHandlingDays |
订单发货前所需的最少工作日天数。 |
service.deliveryTime.maxHandlingTimeInDays |
services.deliveryTime.maxHandlingDays |
订单发货前所需的最长工作日天数。 |
service.deliveryTime.cutoffTime.timezone |
services.deliveryTime.cutoffTime.timeZone |
截止时间对应的时区标识符。 |
service.deliveryTime.transitTimeTable.postalCodeGroupName |
services.deliveryTime.transitTimeTable.postalCodeGroupNames |
邮政编码组的名称。 |
service.deliveryTime.transitTimeTable.transitTimeLabel |
services.deliveryTime.transitTimeTable.transitTimeLabel |
商品的运送时间标签。 |
service.rate_group |
services.rateGroups |
运费组定义。 |
service.rate_group.subtable |
services.rateGroups.subtables |
子表列表。 |
service.rate_group.carrier_rate |
services.rateGroups.carrierRates |
运营商费率列表。 |
service.minimumOrderValueTable.storeCodeSetWithMovs |
services.minimumOrderValueTable.storeCodeSetWithMovs |
共享同一最低订单金额的商店代码集列表。 |
已移除的方法
您无法使用 shippingsettings.custombatch
在单个请求中检索和更新多个账号的配送设置。
已移除的字段
Merchant API 中移除了 Content API for Shopping 中的以下字段。Merchant API 未提供这些字段的任何替代方案。
postal_code_group
service
Pickup_service
Eligibility
Scheduling_channel
Delivery_time
Holiday_cutoff
Rate_group
single_value_alternative_list
方法
以下是 Content API for Shopping 中的方法与配送设置资源之间的比较:
方法 | Content API for Shopping | Merchant API |
---|---|---|
customBatch |
是 | 否 |
get |
是 | 是 |
update |
是 | 否 |
insert |
否 | 是 |
list |
是 | 否 |
getSupportedCarrier |
是 | 否 |
getSupportedHolidays |
是 | 否 |