搭配 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

您必須加入 offerIdfeedLabelchannelcontentLanguage 欄位。所有其他欄位皆為選填。

範例

如要將產品的供應情形從「有現貨」改為「缺貨中」, 可以使用以下要求主體來建立補充動態饋給 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 服務,其中 productIdREST ID 產品,以下列格式表示:channel:contentLanguage:feedLabel:offerId

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

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

products.custombatch

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

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

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

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

products.custombatch:insert

products.custombatch:insert 方法發出補充動態饋給時 您必須加入 offerIdfeedLabelchannel 和 要求主體中的 contentLanguage,除了必要的 batchId 以外, merchantIDmethod 參數所有其他產品欄位皆為選填。

範例

如要更新兩項現有產品的 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"
    }
  ]
}