从 Content API for Shopping 迁移配送设置

借助 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 中的“配送设置”资源的比较示例：

	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 中的“配送设置”资源有以下主要更新：

1. Merchant API 用户必须将 accounts/{ACCOUNT_ID}/shippingSettings 放入 {NAME} 字段，才能获得相同的行为。
2. Merchant API 不支持对自定义区域（例如营业地点组）执行读取和写入操作。只能使用区域服务读取或写入营业地点组等自定义区域。
3. Merchant API 中的一项服务支持多个送货国家/地区。
4. 与 Content API 中的 shippingsettings.list 方法不同，Merchant API 不提供配送设置的列表方法。

新支持的字段

与 Content API for Shopping 相比，Accounts 子 API 中的“配送设置”资源支持以下新字段：

1. warehouses：提供有关履单仓库的信息，该仓库用于存储和处理库存。
2. 会员回馈活动：Merchant API 用户可以将会员回馈活动 信息输入到配送设置中。
3. 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	是	否