从 v2 迁移到 v2.1

行为变更

Accounts 服务

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

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

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

Order 和 TestOrder 资源

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

Products 服务

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

    • channel
    • contentLanguage
    • id
    • offerId
    • targetCountry

  • 响应中不再返回非严重警告和错误。

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

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

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

Product 资源

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

    • ageGroup
    • availability
    • condition
    • energyEfficiencyClass
    • gender
    • maxEnergyEfficiencyClass
    • minEnergyEfficiencyClass
    • sizeSystem
    • sizeType

  • 自定义属性现在是递归属性，无需自定义组。

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

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

  • 重复的字段 productTypes 已替换 productType 和 additionalProductTypes。

  • 重复的字段 includedDestinations 和 excludedDestinations 已经替换重复的字段 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 已被移除。

  • adsLinks、googleMyBusinessLink 和 youtubeChannelLinks 的关联状态 inactive 已被移除。

Datafeed

  • 在 targets 中，字段 contentLanguage、targetCountry 和 intendedDestinations 已被移除，并替换为 language、country、includedDestinations 和 excludedDestinations。

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

Inventory

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

Order 和 TestOrder

  • CancelLineItem

    • 请求中的字段 amount、amountPretax 和 amountTax 已被移除。现在系统会自动计算退款金额。

  • CustomBatch 已被移除。

  • InStoreRefundLineItem 和 ReturnRefundLineItem

    • 字段 amountPretax 和 amountTax 已分别替换为 priceAmount 和 taxAmount。根据订单的地理位置，字段 priceAmount 可能是税前或税后值。

  • Refund 已被移除，请改用 returnRefundLineItem。

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

  • ShipLineItem

    • 请求中的字段 carrier、shipmentId 和 trackingId 已移至 shipmentInfos。

  • 字段 paymentMethod 已被移除。billingAddress 和 predefinedBillingAddress 现在分别是 Order 和 TestOrder 中的顶级字段。

  • customer.explicitMarketingPreference 已替换为 customer.marketingRightsInfo。

  • 已弃用的字段 customer.email、channelType 和 lineItem.product.channel 已被移除。

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

  • netAmount 字段拆分为 netPriceAmount 和 netTaxAmount。

  • shippingOption 已替换为 lineItems[].shippingDetails。

Orderinvoice

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

  • 字段 amountPretax 和 amountTax 已分别替换为 priceAmount 和 taxAmount。根据订单的地理位置，字段 priceAmount 可能是税前或税后值。

Orderpayments

  • 此服务已被移除。

Products

  • 参数 includeInvalidInsertedItems 已被移除。

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

    • aspects
    • destinations
    • onlineOnly
    • validatedDestinations
    • warnings

Productstatuses

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

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

  • destinationStatuses 中的字段 intention、approvalStatus 和 approvalPending 已替换为 status，其为一个字符串，可以是以下值之一：approved、disapproved 或 pending。

  • dataQualityIssues 已替换为 itemLevelIssues。