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 之后,我们在请求中加入了字段 businessInformation
和 googleMyBusinessLink
。为此,我们推出了一项保护措施,可以防止商家无意中使用 update
删除这两个字段(如果 update 中未提供)中的信息。
在 v2 中,商家必须为这些字段明确提供空的正文(即 {}
)才能将其删除。v2.1 中移除了这一保护措施,未提供的字段将会被删除。
Account 资源
品牌从 AdWords 更名为 Google Ads
在 AdWords 更名为 Google Ads 后,以下与 AdWords 相关的字段也进行了重命名:
adwordsLinks
->adsLinks
adwordsLinks.adwordsId
->adsLinks.adsId
移除已弃用的字段和值
已弃用的字段 reviewsUrl
已被移除。此外,adsLinks
、googleMyBusinessLink
和 youtubeChannelLinks
的关联状态 inactive
也已被移除。
Accountstatuses 服务
AccountStatus 资源
移除 dataQualityIssues
这些已被 itemLevelIssues
取代。
Datafeed 服务
Datafeed 资源
移除已弃用的字段
在 targets
中,字段 contentLanguage
、targetCountry
和 intendedDestinations
已被移除,并替换为 country
、language
、includedDestinations
和 excludedDestinations
。
移除 product inventory update
类型为 product inventory update
的 Feed 已被移除。
Inventory 服务
v2.1 中移除了此服务 。以后将会添加一项新服务,用于支持管理补充数据。
Orders 服务
CancelLineItem
请求中的字段 amount
、amountPretax
和 amountTax
已被移除。现在系统会自动计算退款金额。
CustomBatch
v2.1 中移除了 CustomBatch
。
InStoreRefundLineItem
字段 amountPretax
和 amountTax
已分别替换为 priceAmount
和 taxAmount
。根据订单的地理位置,字段 priceAmount
可能是税前或税后值。
Refund
此方法已被移除,请改用 returnRefundLineItem
。
ReturnLineItem
此方法已被移除,请改用 returnRefundLineItem
,而无需提供退款金额。
ReturnRefundLineItem
字段 amountPretax
和 amountTax
已分别替换为 priceAmount
和 taxAmount
。根据订单的地理位置,字段 priceAmount
可能是税前或税后值。
ShipLineItem
请求中的字段 carrier
、shipmentId
和 trackingId
已移至 shipmentInfos
。
Order 和 TestOrder 资源
新的促销形式
v2.1 中有一种新的促销形式。目前,无法创建带促销活动的测试订单,但会在随后的阶段添加此支持功能。
移除已弃用的字段
字段 paymentMethod
已被移除。billingAddress
和 predefinedBillingAddress
现在分别是 Order
和 TestOrder
的顶级字段。
此外,在 Order
和 TestOrder
中,customer.explicitMarketingPreference
已被移除,并且替换为 customer.marketingRightsInfo
。
已弃用的字段 customer.email
已被移除。
Order
资源中的 promotions
字段的格式已变更。
Orderpayments 服务
v2.1 中移除了此服务。
Products 服务
insert
的响应将仅包含以下属性:
channel
contentLanguage
id
offerId
targetCountry
响应中不再返回非严重警告和错误。这样就会更好地与 Feed 规则和其他高级 Feed 管理功能集成。
现在有一种商品,插入后要延迟几分钟才能被 get
或 list
检索到。
无法保证返回的商品 ID 与输入商品 ID 相同。
现在,在插入商品之前,请先验证价格。值字符串中仅允许使用以下字符:+
、-
、.
和数字(即 0
-9
)。不再接受英文逗号。
Product 资源
CustomGroups 已替换为递归 customAttributes
以前,通过将自定义属性添加到 v2 中的同一自定义组下,可以将自定义属性组合在一起。现在,自定义属性在 v2.1 中是递归属性,因此无需自定义组。
除原始 value
字段外,自定义属性现在还具有其他 groupValues
字段;其中只有一个必须设置,即它们不能同时设置或省略。
因为商家可以在 v2 和 v2.1 之间切换,所以商品可能具有递归自定义属性。这些属性在 v2 中无法展示,因为自定义组最多有两个等级。在这种情况下,将截断自定义属性组。
移除 customAttributes 中的类型和单位
在 v2.1 中,自定义属性不再包含 type
和 unit
。系统应该会自动检测到要附加到 value
(如果存在)中的单位和类型。例如,将“1.23 EUR”或“5.6 cm”用作 v2.1 中的 value
。
ProductTypes 取代 productType 和 additionalProductTypes
以前,商品类型存储在两个字段中,第一种类型存储在单数字段 productType
中,其余类型存储在重复的字段 additionalProductTypes
中。在 v2.1 中,这两个字段已替换为单个重复的字段 productTypes
。
Destinations 属性已替换为 includedDestinations 和 excludedDestinations
在重复的字段 destinations
中,输入的 Destinations 是 v2 中的平台名称和意图对列表。此字段已替换为以下两个重复的字段:includedDestinations
和 excludedDestinations
。默认情况下,启用的平台不必包含在 includedDestinations.
中。 这样才会匹配 Feed 中平台替换的配置。
重命名与 AdWords 相关的字段
随着 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
中的字段 intention
、approvalStatus
和 approvalPending
已替换为 status
,其为一个字符串,可以是以下值之一:approved
、disapproved
或 pending
。
移除 dataQualityIssues
这些已被 itemLevelIssues
取代。