products.insert,
products.delete,
products.custombatch.insert, और
products.custombatch.delete तरीकों में कॉल करते समय, feedId को क्वेरी पैरामीटर के तौर पर जोड़कर, प्रॉडक्ट डेटा को कुछ हद तक अपडेट करने के लिए पूरक फ़ीड का इस्तेमाल किया जा सकता है.
उदाहरण के लिए, इस यूआरएल पर 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 आईडी है, जिसे इस तरह दिखाया जाता है: channel:contentLanguage:feedLabel:offerId:
DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId?feedId=feedId
पूरक फ़ीड products.delete तरीके वाले कॉल के लिए, अनुरोध के मुख्य हिस्से की ज़रूरत नहीं होती.
products.custombatch
custombatch के तरीकों से, एक एपीआई कॉल का इस्तेमाल करके, कई प्रॉडक्ट के लिए insert या delete पूरक फ़ीड डेटा हासिल किया जा सकता है. इससे एपीआई कॉल की संख्या कम हो जाती है.
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"
}
]
}