从 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 Shipping Settings API 的对比示例：

	Content API	Merchant 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. Merchant API 用户必须将 accounts/{accountId}/shippingSettings 放入 {name} 字段，才能实现相同的行为。
2. Merchant API 不支持对自定义区域（例如营业地点组）执行读写操作。只能使用地区服务读取或写入营业地点组等自定义区域。
3. 与 Content API for Shopping 相比，Merchant API 设置 WarehouseBasedDeliveryTime 的方式有所不同。如果您使用的是 Merchant API，则必须在 shippingsettings.warehouses 下定义仓库信息。然后，每个配送服务都可以通过 warehouseBaseDeliveryTime 下的仓库名称引用仓库。
4. Merchant API 中的一项服务支持多个配送国家/地区。

新增了支持的字段

与 Content API for Shopping 相比，Merchant Shipping Settings API 支持以下新字段：

1. 仓库：提供有关配送仓库的信息，该仓库用于存储和处理商品目录。
2. 会员回馈活动：Merchant API 用户可以在其配送设置中输入会员回馈活动信息。
3. Etag：当不同用户同时尝试使用 Merchant API 和 Merchant Center 界面更新配送设置时，Etag 旨在解决异步问题。

重命名了字段

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 中的以下字段。Merchant 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	Merchant API
customBatch	是	否
get	是	是
update	是	否
insert	否	是
getSupportedCarrier	是	否
getSupportedHolidays	是	否