प्रॉडक्ट माइग्रेट करना

Merchant API की मदद से, प्रॉडक्ट डेटा को ज़्यादा बेहतर और आसानी से मैनेज किया जा सकता है. इसमें मुख्य बदलाव यह है कि प्रॉडक्ट डेटा को दो अलग-अलग संसाधनों में बांटा गया है: ProductInput जिसकी मदद से डेटा सबमिट किया जाता है और Product जिसकी मदद से प्रोसेस किया गया फ़ाइनल वर्शन देखा जाता है. इसमें प्रॉडक्ट का स्टेटस और समस्याएं भी शामिल होती हैं. इस नए स्ट्रक्चर से, ज़्यादा अनुमान लगाया जा सकता है और पारदर्शी अनुभव मिलता है.

इस गाइड में, मुख्य अंतरों के बारे में बताया गया है. इससे आपको अपने इंटिग्रेशन को Content API for Shopping से Merchant API पर माइग्रेट करने में मदद मिलेगी. नई सुविधाओं के इस्तेमाल के बारे में ज़्यादा जानकारी पाने के लिए, अपने प्रॉडक्ट मैनेज करना लेख पढ़ें.

मुख्य अंतर

Merchant API में प्रॉडक्ट मैनेज करने के तरीके में, Content API for Shopping की तुलना में ये सबसे अहम बदलाव किए गए हैं:

• इनपुट और प्रोसेस किए गए डेटा के लिए अलग-अलग संसाधन: Merchant API, प्रॉडक्ट मैनेजमेंट को दो संसाधनों में बांटता है. प्रॉडक्ट डेटा को जोड़ने, अपडेट करने, और मिटाने के लिए, ProductInput संसाधन का इस्तेमाल किया जा सकता है. Google की ओर से आपके इनपुट प्रोसेस करने, नियम लागू करने, और पूरक सोर्स से डेटा को एक साथ लाने के बाद, फ़ाइनल प्रॉडक्ट देखने के लिए, सिर्फ़ पढ़ने के लिए उपलब्ध Product संसाधन का इस्तेमाल किया जा सकता है.

• प्रॉडक्ट के नामों के लिए एन्कोडिंग: आप दोनों फ़ील्ड के लिए बिना पैडिंग वाले base64url (RFC 4648 सेक्शन 5) एन्कोडिंग का इस्तेमाल कर सकते हैं: ProductInput.name और Product.name अगर प्रॉडक्ट के नामों में Merchant API या यूआरएल के लिए रिज़र्व किए गए वर्ण शामिल हैं, तो एन्कोडिंग करना ज़रूरी है. उदाहरण के लिए, अगर प्रॉडक्ट के नामों में इनमें से कोई भी वर्ण शामिल है, तो आपको उन्हें एन्कोड करना होगा:

  % . + / : ~ , ( * ! ) & ? = @ # $
  

• इंटिग्रेट किया गया प्रॉडक्ट स्टेटस: productstatuses सेवा हटा दी गई है. प्रॉडक्ट की पुष्टि करने से जुड़ी समस्याएं और डेस्टिनेशन के स्टेटस अब सीधे तौर पर शामिल किए जाते हैं में Product संसाधन में, productStatus फ़ील्ड में. इससे डेटा को आसानी से हासिल किया जा सकता है.

• प्रॉडक्ट के अपडेट का अनुमान लगाना: productInputs.patch का नया तरीका, किसी खास प्रॉडक्ट इनपुट में सीधे तौर पर बदलाव करता है. यह Content API for Shopping की तुलना में एक अहम सुधार है. इसमें, फ़ीड अपलोड करने के दौरान, अपडेट के अनचाहे तरीके से ओवरराइट होने की संभावना होती थी. Merchant API में, कोई अपडेट तब तक बना रहता है, जब तक उस खास प्रॉडक्ट इनपुट को फिर से अपडेट या मिटाया नहीं जाता. प्रॉडक्ट के अपडेट, प्रोसेस किए गए Product संसाधन के बजाय, ProductInput संसाधन पर लागू होते हैं.

• डेटा को बेहतर तरीके से मैनेज करने के लिए, अपना डेटा सोर्स चुनना: अब productInputs राइट ऑपरेशन के सभी dataSource क्वेरी पैरामीटर की ज़रूरत होती है. इससे यह साफ़ तौर पर पता चलता है कि आपने किस डेटा सोर्स में बदलाव किया है. यह तब ज़्यादा काम का होता है, जब आपके पास डेटा उपलब्ध कराने वाले कई सोर्स हों.

• नए संसाधन आइडेंटिफ़ायर: अब प्रॉडक्ट की पहचान, id फ़ील्ड के बजाय, RESTful संसाधन name से की जाती है. इसका फ़ॉर्मैट accounts/{account}/products/{product} है.

• कस्टम बैच उपलब्ध नहीं हैं: custombatch तरीका अब उपलब्ध नहीं है. एक एचटीटीपी कॉल में कई अनुरोध भेजने के लिए, एसिंक्रोनस अनुरोधों या एचटीटीपी बैचिंग का इस्तेमाल किया जा सकता है.

अहम जानकारी: चैनल पूल की मदद से थ्रूपुट बेहतर बनाएं: बल्क में किए जाने वाले ऑपरेशन के लिए थ्रूपुट को ज़्यादा से ज़्यादा करने के लिए, चैनल पूल कॉन्फ़िगर करें. इससे, एक gRPC चैनल की 100 स्ट्रीम की सामान्य सीमा को बायपास किया जा सकता है. ऐसा, कई अंडरलाइन कनेक्शन मैनेज करके किया जाता है. ज़्यादा जानकारी के लिए, एक साथ कई अनुरोधों के लिए कोड को फिर से फ़ैक्टर करना: चैनल पूल की मदद से थ्रूपुट बेहतर बनाना

लेख पढ़ें
• किसी भी फ़ीड लेबल और भाषा के लिए डेटा सोर्स: Merchant API की मदद से, फ़ीड लेबल और भाषा की जानकारी दिए बिना डेटा सोर्स बनाया जा सकता है. इसलिए, किसी भी फ़ीड लेबल और भाषा के साथ प्रॉडक्ट जोड़ा जा सकता है.

ध्यान दें: प्रॉडक्ट के इतिहास को मिटने से बचाने के लिए, Merchant API को कॉल करते समय, उसी प्रॉडक्ट के लिए वही offerId इस्तेमाल करें जो आपने Content API for Shopping के साथ इस्तेमाल किया था. इस पेज

पर, आइडेंटिफ़ायर सेक्शन भी देखें.

अनुरोध

इस सेक्शन में, Content API for Shopping और Merchant API के अनुरोध फ़ॉर्मैट की तुलना की गई है.

अनुरोध का ब्यौरा	Content API for Shopping	Merchant API
प्रॉडक्ट पाना	GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}	GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products/{product}
प्रॉडक्ट की सूची	GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products	GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products
एक प्रॉडक्ट जोड़ना	POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products	POST https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs:insert
प्रॉडक्ट अपडेट करना	PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}	PATCH https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs/{productinput}
प्रॉडक्ट मिटाना	DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}	DELETE https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs/{productinput}
प्रॉडक्ट का स्टेटस पाना	GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/productstatuses/{productId}	GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products/{product}
प्रॉडक्ट के स्टेटस की सूची	GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/productstatuses	GET https://merchantapi.googleapis.com/products/v1/accounts/{account}/products
कई अनुरोधों को बैच में भेजना	POST https://shoppingcontent.googleapis.com/content/v2.1/products/custombatch	एसिंक्रोनस अनुरोधों या एचटीटीपी बैचिंग का इस्तेमाल करना

आइडेंटिफ़ायर

Merchant API में, प्रॉडक्ट आइडेंटिफ़ायर का फ़ॉर्मैट बदलकर, स्टैंडर्ड REST संसाधन का नाम कर दिया गया है.

आइडेंटिफ़ायर का ब्यौरा	Content API for Shopping	Merchant API
प्रॉडक्ट आईडी	यह कॉलन (:) से अलग किए गए सेगमेंट से बनी एक स्ट्रिंग है. फ़ॉर्मैट: channel:contentLanguage:targetCountry:offerId या channel:contentLanguage:feedLabel:offerId. उदाहरण: online:en:US:sku123	यह REST संसाधन name स्ट्रिंग है. फ़ॉर्मैट: accounts/{account}/products/{product} जहां {product} का मतलब contentLanguage~feedLabel~offerId है. उदाहरण: accounts/12345/products/en~US~sku123. एन्कोडिंग: बिना पैडिंग वाले base64url एन्कोडिंग का सुझाव दिया जाता है. साथ ही, अगर प्रॉडक्ट आईडी में Merchant API या यूआरएल के लिए रिज़र्व किए गए वर्ण शामिल हैं, तो यह ज़रूरी है.

ध्यान दें: Merchant API में, channel फ़ील्ड अब मौजूद नहीं है. Content API for Shopping में LOCAL चैनल वाले प्रॉडक्ट के लिए, legacy_local फ़ील्ड को 'सही' पर सेट किया जाना चाहिए.

तरीके

इस टेबल में, Content API for Shopping के तरीकों और Merchant API में उनके बराबर के तरीकों के बारे में बताया गया है.

Content API for Shopping का तरीका	Merchant API का तरीका	उपलब्धता और अहम जानकारी
products.get	products.get	प्रोसेस किया गया फ़ाइनल प्रॉडक्ट दिखाता है.
products.list	products.list	प्रोसेस किए गए फ़ाइनल प्रॉडक्ट की सूची दिखाता है.
products.insert	productInputs.insert	प्रॉडक्ट इनपुट जोड़ता है. इसके लिए, dataSource की ज़रूरत होती है.
products.update	productInputs.patch	इसका व्यवहार काफ़ी अलग होता है. यह किसी खास प्रॉडक्ट इनपुट को अपडेट करता है और यह अपडेट बना रहता है.
products.delete	productInputs.delete	किसी खास प्रॉडक्ट इनपुट को मिटाता है. इसके लिए, dataSource की ज़रूरत होती है.
products.custombatch	उपलब्ध नहीं है	एसिंक्रोनस अनुरोधों या एचटीटीपी बैचिंग का इस्तेमाल करें.
productstatuses.get	products.get	productstatuses सेवा हटा दी गई है. स्टेटस की जानकारी अब Product संसाधन का हिस्सा है.
productstatuses.list	products.list	productstatuses सेवा हटा दी गई है. स्टेटस की जानकारी अब Product संसाधन का हिस्सा है.
productstatuses.custombatch	उपलब्ध नहीं है	एसिंक्रोनस अनुरोधों या एचटीटीपी बैचिंग का इस्तेमाल करें.

फ़ील्ड में किए गए बदलावों के बारे में ज़्यादा जानकारी

इस टेबल में, Merchant API में जोड़े, हटाए या बदले गए अहम फ़ील्ड के बारे में बताया गया है.

Content API for Shopping	Merchant API	ब्यौरा
id	name	अब किसी प्रॉडक्ट के लिए प्राइमरी आइडेंटिफ़ायर, REST संसाधन name है. बिना पैडिंग वाले base64url एन्कोडिंग का सुझाव दिया जाता है. साथ ही, अगर प्रॉडक्ट के नामों में Merchant API या यूआरएल के लिए रिज़र्व किए गए वर्ण शामिल हैं, तो यह ज़रूरी है.
टॉप-लेवल प्रॉडक्ट डेटा स्पेसिफ़िकेशन एट्रिब्यूट (उदाहरण के लिए, title, price, link)	productAttributes ऑब्जेक्ट	title, price, और link जैसे प्रॉडक्ट एट्रिब्यूट अब टॉप-लेवल फ़ील्ड नहीं हैं. इन्हें अब productAttributes ऑब्जेक्ट में Product और ProductInput संसाधन, दोनों में ग्रुप किया गया है. इससे, संसाधन का स्ट्रक्चर ज़्यादा व्यवस्थित और साफ़-सुथरा दिखता है.
targetCountry	feedLabel	Merchant Center की सुविधाओं के मुताबिक, संसाधन के नाम में अब targetCountry के बजाय feedLabel का इस्तेमाल किया जाता है.
feedId	dataSource (क्वेरी पैरामीटर)	अब dataSource का नाम, productInputs के सभी राइट तरीकों (insert, update, delete) के लिए ज़रूरी क्वेरी पैरामीटर है.
channel	उपलब्ध नहीं है. सिर्फ़ स्थानीय प्रॉडक्ट के लिए, legacy_local का इस्तेमाल करें.	Merchant API में, channel फ़ील्ड अब मौजूद नहीं है. Content API for Shopping में LOCAL चैनल वाले प्रॉडक्ट के लिए, legacy_local फ़ील्ड को 'सही' पर सेट किया जाना चाहिए.
उपलब्ध नहीं है	versionNumber	ProductInput पर एक नया वैकल्पिक फ़ील्ड. इसका इस्तेमाल, प्राइमरी डेटा सोर्स में क्रम से बाहर की गई एंट्री को रोकने के लिए किया जा सकता है.
वैल्यू के तय सेट वाले string टाइप के फ़ील्ड	वैल्यू के तय सेट वाले enum टाइप के फ़ील्ड	प्रॉडक्ट एट्रिब्यूट में, वैल्यू के तय सेट वाले फ़ील्ड (उदाहरण के लिए, excluded_destinations, availability) अब enum टाइप के हैं.