此页面由 Cloud Translation API 翻译。

将补充 Feed 与 Content API 结合使用

您可以使用补充 Feed 对商品数据进行部分更新，方法是添加 feedId 作为查询参数在调用 products.insert, products.delete, products.custombatch.insert, 和 products.custombatch.delete 方法。

例如，您可以将 products.insert 补充 Feed 方法调用至以下网址：

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId

products.insert

补充 Feed 的 products.insert 方法会添加您发送的在请求正文中，覆盖这些字段（如果存在）。使用因此此方法会使其他所有商品字段保持不变，除非这些字段已包含在对同一 Feed 的上一个请求中。而数据通过其他 Feed 添加的新请求不受影响，每个请求都会覆盖同一 Feed 的请求。也就是说，如果您通过补充 Feed 请求，而后续便不会添加该字段请求中，系统会从 Feed 中移除被忽略字段的数据。此行为这与在不使用补充 Feed 的情况下调用 products.insert 不同，删除所有现有商品数据并将其替换为您在邮件中请求正文。

使用以下网址向补充 Feed 发出请求 Product.insert 服务：

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId

您必须将 offerId、feedLabel、channel 和 contentLanguage 字段。所有其他字段都是选填字段。

示例

要将商品的库存状况从“in stock”更改为“out of stock”，您需要可以使用以下请求正文创建补充 Feed Product.insert 方法调用：

{
 "offerId": "1111111111",
 "contentLanguage": "en",
 "feedLabel": "US",
 "channel": "online",
 "availability": "out of stock",
}

products.delete

products.delete 方法可移除之前由 products.insert 调用使用指定的补充数据添加 Feed。针对补充 Feed 调用此方法不会影响原始 Feed 在补充 Feed Product.insert 次调用之前添加的商品数据。您可以将其视为为特定 Feed 移除一层数据；通过其他 Feed 添加的数据不会受到影响，恢复到添加补充 Feed 层之前的状态。这个这与在不使用补充 Feed 的情况下调用 products.delete 不同，删除整个产品及其所有数据。

使用以下网址请求补充 Feed products.delete 服务，其中 productId 是 REST ID 商品的属性，表示为：channel:contentLanguage:feedLabel:offerId：

DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId?feedId=feedId

调用补充 Feed products.delete 方法不需要请求正文。

products.custombatch

借助 custombatch 方法，您可以 insert 或 delete 补充 Feed 使用单个 API 调用获取多件商品的数据，从而最大限度地减少 API 数量次调用。

使用以下请求网址进行 custombatch 调用：

https://shoppingcontent.googleapis.com/content/v2.1/products/batch

对于所有补充 Feed custombatch 调用，都必须添加 batchId，请求中的 merchantID、method 和 feedId 参数正文。

products.custombatch:insert

对 products.custombatch:insert 方法进行补充 Feed 调用时，必须包含 offerId、feedLabel、channel 和 contentLanguage，除了必需的 batchId 外， merchantID 和 method 参数。其他所有商品字段均为选填。

示例

如需更新两个现有商品的 price 值，您可以使用进行 products.custombatch:insert 方法调用的请求：

{
  "entries": [
    {
      "batchId": 1111,
      "merchantId": 1234567,
      "method": "insert",
      "feedId": "7654321",
      "product": {
         "offerId": "1111111111",
         "contentLanguage": "en",
         "targetCountry": "US",
         "feedLabel": "US",
         "channel": "online",
         "price": {
          "value": "30.99",
          "currency": "USD"
         }
      }
    },
    {
      "batchId": 1112,
      "merchantId": 1234567,
      "method": "insert",
      "feedId": "7654321",
      "product": {
         "offerId": "2222222222",
         "contentLanguage": "en",
         "targetCountry": "US",
         "feedLabel": "US",
         "channel": "online",
         "price": {
          "value": "33.99",
          "currency": "USD"
         },
      },
    }
}

products.custombatch:delete

要移除通过指定的补充 Feed 对两件商品所做的所有更新，请执行以下操作：您可以使用以下请求创建 products.custombatch:delete 方法调用：

{
  "entries": [
    {
      "batchId": 1115,
      "merchantId": 1234567,
      "method": "delete",
      "feedId": "7654321",
      "productId": "online:en:US:1111111111"
    },
    {
      "batchId": 1116,
      "merchantId": 1234567,
      "method": "delete",
      "feedId": "7654321",
      "productId": "online:en:US:2222222222"
    }
  ]
}