版本说明

v2.1 (2019-02-14)

此版本发生的变化

不再支持空运行

v2.1 中移除了参数 dryRun。这一变化适用于所有 API 调用。

不再支持 patch 方法

以下服务不再支持 patch 方法:

  • Accounts
  • Accounttax
  • Datafeeds
  • Liasettings
  • Shippingsettings

移除 HTTP BATCH 方法

v2.1 中移除了所有 HTTP BATCH 方法,改用 customBatch 代替。受影响的服务如下:

  • Accounts
  • Accountstatuses
  • Datafeeds
  • Datafeedstatuses
  • Liasettings
  • Orderreports
  • Pos
  • Products
  • Productstatuses
  • Shippingsettings

Accounts 服务

Update

首次发布 Content API v2 之后,我们在请求中加入了字段 businessInformationgoogleMyBusinessLink。为此,我们推出了一项保护措施,可以防止商家无意中使用 update 删除这两个字段(如果 update 中未提供)中的信息。

在 v2 中,商家必须为这些字段明确提供空的正文(即 {})才能将其删除。v2.1 中移除了这一保护措施,未提供的字段将会被删除。

Account 资源

品牌从 AdWords 更名为 Google Ads

AdWords 更名为 Google Ads 后,以下与 AdWords 相关的字段也进行了重命名:

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId

移除已弃用的字段和值

已弃用的字段 reviewsUrl 已被移除。此外,adsLinksgoogleMyBusinessLinkyoutubeChannelLinks 的关联状态 inactive 也已被移除。

Accountstatuses 服务

AccountStatus 资源

移除 dataQualityIssues

这些已被 itemLevelIssues 取代。

Datafeed 服务

Datafeed 资源

移除已弃用的字段

targets 中,字段 contentLanguagetargetCountryintendedDestinations 已被移除,并替换为 countrylanguageincludedDestinationsexcludedDestinations

移除 product inventory update

类型为 product inventory update 的 Feed 已被移除。

Inventory 服务

v2.1 中移除了此服务 。以后将会添加一项新服务,用于支持管理补充数据

Orders 服务

CancelLineItem

请求中的字段 amountamountPretaxamountTax 已被移除。现在系统会自动计算退款金额。

CustomBatch

v2.1 中移除了 CustomBatch

InStoreRefundLineItem

字段 amountPretaxamountTax 已分别替换为 priceAmounttaxAmount。根据订单的地理位置,字段 priceAmount 可能是税前或税后值。

Refund

此方法已被移除,请改用 returnRefundLineItem

ReturnLineItem

此方法已被移除,请改用 returnRefundLineItem,而无需提供退款金额。

ReturnRefundLineItem

字段 amountPretaxamountTax 已分别替换为 priceAmounttaxAmount。根据订单的地理位置,字段 priceAmount 可能是税前或税后值。

ShipLineItem

请求中的字段 carriershipmentIdtrackingId 已移至 shipmentInfos

Order 和 TestOrder 资源

新的促销形式

v2.1 中有一种新的促销形式。目前,无法创建带促销活动的测试订单,但会在随后的阶段添加此支持功能。

移除已弃用的字段

字段 paymentMethod 已被移除。billingAddresspredefinedBillingAddress 现在分别是 OrderTestOrder 的顶级字段。

此外,在 OrderTestOrder 中,customer.explicitMarketingPreference 已被移除,并且替换为 customer.marketingRightsInfo

已弃用的字段 customer.email 已被移除。

Order 资源中的 promotions 字段的格式已变更。

Orderpayments 服务

v2.1 中移除了此服务。

Products 服务

insert 的响应将仅包含以下属性:

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

响应中不再返回非严重警告和错误。这样就会更好地与 Feed 规则和其他高级 Feed 管理功能集成。

现在有一种商品,插入后要延迟几分钟才能被 getlist 检索到。

无法保证返回的商品 ID 与输入商品 ID 相同。

现在,在插入商品之前,请先验证价格。值字符串中仅允许使用以下字符:+-. 和数字(即 0-9)。不再接受英文逗号。

Product 资源

CustomGroups 已替换为递归 customAttributes

以前,通过将自定义属性添加到 v2 中的同一自定义组下,可以将自定义属性组合在一起。现在,自定义属性在 v2.1 中是递归属性,因此无需自定义组。

除原始 value 字段外,自定义属性现在还具有其他 groupValues 字段;其中只有一个必须设置,即它们不能同时设置或省略。

因为商家可以在 v2 和 v2.1 之间切换,所以商品可能具有递归自定义属性。这些属性在 v2 中无法展示,因为自定义组最多有两个等级。在这种情况下,将截断自定义属性组。

移除 customAttributes 中的类型和单位

在 v2.1 中,自定义属性不再包含 typeunit。系统应该会自动检测到要附加到 value(如果存在)中的单位和类型。例如,将“1.23 EUR”或“5.6 cm”用作 v2.1 中的 value

ProductTypes 取代 productType 和 additionalProductTypes

以前,商品类型存储在两个字段中,第一种类型存储在单数字段 productType 中,其余类型存储在重复的字段 additionalProductTypes 中。在 v2.1 中,这两个字段已替换为单个重复的字段 productTypes

Destinations 属性已替换为 includedDestinations 和 excludedDestinations

在重复的字段 destinations 中,输入的 Destinations 是 v2 中的平台名称和意图对列表。此字段已替换为以下两个重复的字段:includedDestinationsexcludedDestinations。默认情况下,启用的平台不必包含在 includedDestinations. 中。 这样才会匹配 Feed 中平台替换的配置。

随着 AdWords 更名为 Google Ads,以下与 AdWords 相关的字段已重命名:

  • adwordsGrouping -> adsGrouping
  • adwordsLabels -> adsLabels
  • adwordsRedirect -> adsRedirect

移除已弃用的字段

下列已弃用的字段已被移除:

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Productstatuses 服务

Get 和 List

product 属性以及 includeAttributes 参数已被移除。要检索与状态对应的商品属性,请使用 Products 服务和新的 productId 字段的值。

List

参数 includeInvalidInsertedItems 已被移除。无论商品是否有效,所有商品都已返回。例如,list 现在的行为类似于 includeInvalidInsertedItems 始终设置为 true

ProductStatus 资源

DestinationsStatuses

destinationStatuses 中的字段 intentionapprovalStatusapprovalPending 已替换为 status,其为一个字符串,可以是以下值之一:approveddisapprovedpending

移除 dataQualityIssues

这些已被 itemLevelIssues 取代。