Version v2 of the Content API is scheduled for sunset on September 30th, 2021. Onboarding to v2 will stop on April 30, 2021. To avoid disruptions with your integration, please migrate to v2.1 as soon as possible.

For more information, see Migrating to v2.1 and this blog post.

从 v2 迁移到 v2.1

行为变更

Accounts 服务

  • 现在,您可以在更新请求中删除 businessInformationgoogleMyBusinessLink,而不必提供空的正文 ({})。

  • 以下与 AdWords 相关的字段已重命名:

    • adwordsLinks -> adsLinks
    • adwordsLinks.adwordsId -> adsLinks.adsId

Order 和 TestOrder 资源

  • 商家不用在 API 调用中提供税费数据,因为系统会自动计算这些数据。如果订单满足采用市场公平法案或类似立法的州的规定,执行上述操作会导致调用失败。对于在没有采用市场公平法案的州运营的商家,计算出的税费取决于 Merchant Center 中的设置。如果未进行设置,计算出的税费将为 0

Products 服务

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

    • channel
    • contentLanguage
    • id
    • offerId
    • targetCountry
  • 响应中不再返回非严重警告和错误。

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

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

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

Product 资源

  • 以下属性的无效值不会再触发插入错误,而是作为 productstatus 中 itemLevelIssues 的一部分返回。

    • ageGroup
    • availability
    • condition
    • energyEfficiencyClass
    • gender
    • maxEnergyEfficiencyClass
    • minEnergyEfficiencyClass
    • sizeSystem
    • sizeType
  • 自定义属性现在是递归属性,无需自定义组。

  • 除原始 value 字段外,自定义属性现在还具有 groupValues 字段;必须设置一个字段值。

  • 自定义属性不再包含类型和单位。系统应该会自动检测到要附加到值中的单位和类型。

  • 重复的字段 productTypes 已替换 productTypeadditionalProductTypes

  • 重复的字段 includedDestinationsexcludedDestinations 已经替换重复的字段 destinations

  • 以下与 AdWords 相关的字段已重命名:

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

弃用

  • 不再支持 XML。有关详情和切换到 JSON 的方法建议,请查看相关博文

  • 参数 dryRun 已从 v2.1 中移除。这适用于所有 API 调用。

  • 所有 HTTP BATCH 方法都已从 v2.1 中移除。请改用 customBatch

  • patch() 方法已从以下属性中删除:

    • Accounts
    • Accounttax
    • Datafeeds
    • Liasettings
    • Shippingsettings

Accounts

  • 已弃用的字段 reviewsUrl 已被移除。

  • adsLinksgoogleMyBusinessLinkyoutubeChannelLinks 的关联状态 inactive 已被移除。

Datafeed

  • 在 targets 中,字段 contentLanguagetargetCountryintendedDestinations 已被移除,并替换为 languagecountryincludedDestinationsexcludedDestinations

  • 包含 contentType = "product inventory update" 的 Feed 已被移除。

Inventory

  • 此服务已被移除。对于在线商品价格和库存状况更新,请使用商品服务重新上传完整商品。我们正努力为实体店商品目录提供替代服务,并支持管理补充数据

Order 和 TestOrder

  • CancelLineItem

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

  • InStoreRefundLineItemReturnRefundLineItem

    • 字段 amountPretaxamountTax 已分别替换为 priceAmounttaxAmount。根据订单的地理位置,字段 priceAmount 可能是税前或税后值。
  • Refund 已被移除,请改用 returnRefundLineItem

  • ReturnLineItem 已被移除,请改用 returnRefundLineItem,而无需提供退款金额。

  • ShipLineItem

    • 请求中的字段 carriershipmentIdtrackingId 已移至 shipmentInfos
  • 字段 paymentMethod 已被移除。billingAddresspredefinedBillingAddress 现在分别是 OrderTestOrder 中的顶级字段。

  • customer.explicitMarketingPreference 已替换为 customer.marketingRightsInfo

  • 已弃用的字段 customer.emailchannelTypelineItem.product.channel 已被移除。

  • promotions 字段已从 TestOrder 移除,并且其格式已在 Order 中变更。

  • netAmount 字段拆分为 netPriceAmountnetTaxAmount

  • shippingOption 已替换为 lineItems[].shippingDetails

Orderinvoice

  • 已在 invoiceSummary 和促销扣款相关字段中移除余额(商家、客户、Google)。

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

Orderpayments

  • 此服务已被移除。

Products

  • 参数 includeInvalidInsertedItems 已被移除。

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

    • aspects
    • destinations
    • onlineOnly
    • validatedDestinations
    • warnings

Productstatuses

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

  • 参数 includeInvalidInsertedItems 已被移除。无论商品是否有效,现在都会返回每件商品的 productId

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

  • dataQualityIssues 已替换为 itemLevelIssues