本頁面由 Cloud Translation API 翻譯而成。

搭配 Content API 使用補充動態饋給

您可以使用補充動態饋給，對產品資料進行部分更新，方法是在將 feedId 當做查詢參數來呼叫 products.insert, products.delete, products.custombatch.insert，和 products.custombatch.delete 方法。

舉例來說，您可以對 products.insert 補充動態饋給方法呼叫下列網址：

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

products.insert

補充動態饋給 products.insert 方法會新增你傳送的產品欄位來覆寫要求主體中的欄位 (如有)。使用補充動態饋給，這個方法會讓所有其他產品欄位維持不變，這些欄位已加進先前同一個動態饋給的要求中。數據用量時透過其他動態饋給新增的動態饋給不會受到影響，每項要求都會覆寫先前相同動態饋給的要求也就是說，如果您透過，而且後續的請求中，省略欄位的資料將會從動態饋給中移除。這項行為不含補充動態饋給的 products.insert 會刪除所有現有產品資料，並替換成你傳送的欄位要求主體

使用以下網址向補充動態饋給提出要求 Product.insert 服務：

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

您必須加入 offerId、feedLabel、channel 和 contentLanguage 欄位。所有其他欄位皆為選填。

範例

如要將產品的供應情形從「有現貨」改為「缺貨中」，可以使用以下要求主體來建立補充動態饋給 Product.insert 方法呼叫：

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

products.delete

products.delete 方法會移除 products.insert 呼叫先前透過指定的補充資料來新增動態饋給為補充動態饋給呼叫這個方法不會影響原始資料在補充動態饋給 Product.insert 呼叫之前加入的產品資料執行。不妨想像一下，就像移除特定動態饋給的某層資料一樣；透過其他動態饋給新增的資料不會受到影響，產品本身也不會受到影響會還原至新增補充動態饋給圖層前的狀態。這個不含補充動態饋給的 products.delete 會刪除整個產品及其所有資料。

使用以下網址提出補充動態饋給的要求：products.delete 服務，其中 productId 是 REST ID 產品，以下列格式表示：channel:contentLanguage:feedLabel:offerId：

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

補充動態饋給 products.delete 方法呼叫不需要要求主體。

products.custombatch

custombatch 方法可讓您insert或 delete 補充動態饋給透過單一 API 呼叫將 API 用於多種產品的資料，盡可能減少通話。

請使用下列要求網址進行 custombatch 呼叫：

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

所有補充動態饋給 custombatch 呼叫都必須包含 batchId、要求中的 merchantID、method 和 feedId 參數

products.custombatch:insert

向 products.custombatch:insert 方法發出補充動態饋給時您必須加入 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

如要透過指定的補充動態饋給，移除對兩項產品的所有更新，您可以使用下列要求來發出 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"
    }
  ]
}

建立補充動態饋給

使用動態饋給規則