从 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