Content API で補助フィードを使用する

補助フィードを使用して商品データを部分的に更新するには、 feedId をクエリ パラメータとして、 products.insert, products.delete, products.custombatch.insert, および products.custombatch.delete あります。

たとえば、products.insert 補助フィードのメソッド呼び出しを作成して、 次の URL をご覧ください。

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

products.insert

補助フィードの products.insert メソッドを使用して、送信する商品フィールドを追加します。 そのフィールドが存在する場合は上書きします。「 この方法では、その他すべての商品フィールドは変更されません。 フィールドが同じフィードの以前のリクエストに含まれている。一方、 他のフィードを介して追加された他のフィードは影響を受けないため、各リクエストは以前の リクエストの数を減らすことができます。つまり、 後続のフィールドにはそのフィールドを含めないでください。 省略されたフィールドのデータはフィードから削除されます。この動作 補助フィードなしで products.insert を呼び出す場合とは異なります。 既存の商品データをすべて削除し、送信したフィールドに置き換えます。 作成します。

次の URL を使用して補助フィードにリクエストを送信します Product.insert サービス:

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

offerIdfeedLabelchannel、および リクエスト本文の 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 を呼び出す場合とは異なります。 商品全体とそのすべてのデータが削除されます。

次の URL を使用して、補助フィード products.delete をリクエストします。 サービス。ここで、productId は、 REST ID 商品の 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 することができます。 1 回の API 呼び出しで、複数のプロダクトのデータをまとめて API の数を できます。

次のリクエスト URL を使用して custombatch を呼び出します。

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

補助フィードの custombatch 呼び出しにはすべて、batchId を含める必要があります。 リクエストの merchantIDmethodfeedId の各パラメータ できます。

products.custombatch:insert

products.custombatch:insert メソッドに対して補助フィード呼び出しを行う場合、 offerIdfeedLabelchannel、および リクエスト本文の contentLanguage(必須の batchId に加えて) merchantIDmethod パラメータ。その他の商品フィールドはすべて省略可能です。

既存の 2 つの商品の 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

指定した補助フィードを使用して 2 つの商品に加えられたすべての更新を削除するには、 次のリクエストを使用して、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"
    }
  ]
}