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 को कॉल करने से अलग है. पूरक फ़ीड के बिना 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"
}
]
}