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 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 पूरक फ़ीड डेटा को इकट्ठा किया जा सकता है. इससे एपीआई कॉल की संख्या को कम किया जा सकता है.
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"
}
]
}