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

  1. 商家 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