从 Content API for Shopping 迁移配送设置

通过 ShippingSettings 通过该资源，您可以检索和更新自己账号的运费设置， 所有与之关联的子账号如需详细了解如何 添加或管理您账号的运费设置，请参阅运费概览 设置。

如需使用 Merchant API 读取运费设置信息，请使用以下 请求：

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings

将 {accountId} 替换为您的 Merchant Center 账号。

如需使用 Merchant API 读取运费设置信息，请使用以下 请求：

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert

如需了解详情，请参阅方法： accounts.shippingSettings.insert。

Content API for Shopping 与 Merchant API 之间的比较

以下是 Content API for Shopping 与 Merchant Center 账号的对比情况 Shipping Settings API：

	Content API	商家 API
网址	https://shoppingcontent.googleapis.com/content/v2.1/{accountId}/shippingsettings:insert	https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
标识符	{accountId}/shippingsettings/{accountId}	{name}

以下列表提及了 Merchant Shipping Settings API 中的重大更新 与 Content API for Shopping 相比：

1. 用户必须将 accounts/{accountId}/shippingSettings进入 {name} 字段，使系统具有相同的行为。
2. Merchant API 不支持对自定义区域（如 营业地点组。营业地点组等自定义区域只能读取 使用区域服务写入
3. WarehouseBasedDeliveryTime 的设置方式 与 Content API for Shopping 不同。如果您 使用 Merchant API，则必须在 shippingsettings.warehouses。然后，每项配送服务都可以参考 通过 warehouseBaseDeliveryTime 下的仓库名称指定仓库。
4. Merchant API 中的一项服务支持多个送货国家/地区。

支持的新字段

Merchant Shipping Settings API 支持以下新字段： Content API for Shopping：

1. 仓库：提供履单仓库的相关信息。 用于存储和处理库存
2. 会员回馈活动：Merchant API 用户可以输入会员回馈活动信息， 运费设置
3. Etag：Etag 旨在解决不同用户尝试 使用 Merchant API 和 Merchant Center 界面在 。

重命名的字段

Merchant API 中的以下字段已重命名：

Content API for Shopping	Merchant Shipping Settings API	说明
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 中的以下字段。商家 API 不为这些字段提供任何替代值。

• postal_code_group
• service
• Pickup_service
• Eligibility
• Scheduling_channel
• Delivery_time
• Holiday_cutoff
• Min_scheduling_time_in_days
• Max_scheduling_time_in_days
• Scheduling_business_day_config
• Rate_group
  • single_value_alternative_list

方法

下面对 Content API for Shopping 和 Merchant Shipping Settings API：

方法	Content API for Shopping	商家 API
customBatch	是	否
get	是	是
update	是	否
insert	否	是
getSupportedCarrier	是	否
getSupportedHolidays	是	否