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"
   
}
 
]
}