補助フィードを使用して商品データを部分的に更新するには、
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
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
を呼び出す場合とは異なります。
商品全体とそのすべてのデータが削除されます。
次の 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
を含める必要があります。
リクエストの merchantID
、method
、feedId
の各パラメータ
できます。
products.custombatch:insert
products.custombatch:insert
メソッドに対して補助フィード呼び出しを行う場合、
offerId
、feedLabel
、channel
、および
リクエスト本文の contentLanguage
(必須の batchId
に加えて)
merchantID
、method
パラメータ。その他の商品フィールドはすべて省略可能です。
例
既存の 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"
}
]
}