अपनी पसंद के कोडिंग असिस्टेंट से, Merchant API के बारे में कॉन्टेक्स्ट के हिसाब से जानकारी पाएं. अब इंटिग्रेटेड डेवलपमेंट एनवायरमेंट (आईडीई) में, मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सेवा का इस्तेमाल करके, डेवलपर दस्तावेज़ के इंटिग्रेशन को ऐक्सेस किया जा सकता है. यह सेवा, इंटिग्रेशन और माइग्रेशन के वर्कफ़्लो को तेज़ी से पूरा करने में आपकी मदद करती है. इसके लिए, यह सेवा आपके कोडिंग असिस्टेंट को Google के आधिकारिक एपीआई दस्तावेज़ों से भरोसेमंद कॉन्टेक्स्ट उपलब्ध कराती है.
प्रोटोकॉल के बारे में ज़्यादा जानने के लिए, मॉडल कॉन्टेक्स्ट प्रोटोकॉल स्टैंडर्ड देखें.
खास जानकारी
Content API for Shopping से Merchant API पर माइग्रेट करते समय या नया इंटिग्रेशन बनाते समय, आपको नई सेवा के स्ट्रक्चर, संसाधन के नाम, और तरीकों के बारे में जानकारी होनी चाहिए. एमसीपी सेवा, आधिकारिक दस्तावेज़ और कोड के सैंपल उपलब्ध कराकर, इस प्रोसेस को आसान बनाती है.
यह सेवा, खास तौर पर तैयार किए गए Retrieval-Augmented Generation (RAG) बैकएंड का इस्तेमाल करती है. जब एमसीपी की सुविधा वाले आईडीई कोडिंग असिस्टेंट से Merchant API के बारे में कोई सवाल पूछा जाता है, तो यह सेवा Google के आधिकारिक संसाधनों से टेक्स्ट और कोड के सबसे काम के स्निपेट ढूंढती है. इसके बाद, इन्हें कोडिंग असिस्टेंट के संदर्भ के तौर पर दिखाती है. इससे आपकी Assistant, आपको डेवलपमेंट एनवायरमेंट से बाहर निकले बिना ही सटीक और अप-टू-डेट जवाब दे पाती है.
यह कैसे काम करता है
एमसीपी का इस्तेमाल करके डेवलपर दस्तावेज़ इंटिग्रेशन, एआई की मदद से काम करने वाले मॉडर्न डेवलपमेंट वर्कफ़्लो में इंटिग्रेट होता है:
- आपने एमसीपी के साथ काम करने वाले कोडिंग असिस्टेंट या एजेंट से कोई सवाल पूछा हो. यह आम बोलचाल की भाषा में पूछा गया सवाल या Merchant API के तरीकों को लागू करने के लिए कोड सैंपल का अनुरोध हो सकता है.
- आपका कोडिंग असिस्टेंट, एमसीपी एंडपॉइंट को कॉन्टेक्स्ट के लिए अनुरोध भेजता है.
- MCP सेवा, Merchant API के आधिकारिक दस्तावेज़, गाइड, और कोड के सैंपल के इंडेक्स किए गए कलेक्शन में सबसे काम की जानकारी खोजती है.
- यह सेवा, कोडिंग में मदद करने वाले आपके टूल को कॉन्टेक्स्ट के तौर पर ये भरोसेमंद स्निपेट दिखाती है.
- आपकी कोडिंग असिस्टेंट, इस अच्छी क्वालिटी वाले कॉन्टेक्स्ट का इस्तेमाल करके आपके मूल सवाल का सटीक और मददगार जवाब जनरेट करती है.
शुरू करना
एमसीपी का इस्तेमाल करने के लिए, आपको ऐसे आईडीई या कोडिंग असिस्टेंट की ज़रूरत होगी जो स्ट्रीम किए जा सकने वाले एचटीटीपी ट्रांसपोर्ट के साथ मॉडल कॉन्टेक्स्ट प्रोटोकॉल के साथ काम करता हो.
एंडपॉइंट कॉन्फ़िगरेशन
अपने टूल को सेवा से कनेक्ट करने के लिए, दिए गए रिमोट एंडपॉइंट की जानकारी का इस्तेमाल करें. इसके लिए, आपको सीधे तौर पर सेवा का यूआरएल या एमसीपी की परिभाषा डालनी पड़ सकती है. यह आपके टूल के कॉन्फ़िगरेशन पर निर्भर करता है.
सेवा का यूआरएल यह है:
MCP Server Name: "MAPI Docs MCP"
MCP Server URL: "https://merchantapi.googleapis.com/devdocs/mcp/"
इस्तेमाल के उदाहरण
इन सामान्य इस्तेमाल के उदाहरणों में, एमसीपी आपके वर्कफ़्लो को बेहतर बना सकता है.
पहला उदाहरण: लेगसी एपीआई कॉल को माइग्रेट करना
आपके पास Content API for Shopping का इस्तेमाल करने वाला कोई मौजूदा ऐप्लिकेशन है और आपको उसे अपडेट करना है. किसी लेगसी तरीके के बारे में पूछकर, लागू करने के नए तरीके और उससे जुड़े कोड के सैंपल के बारे में जानकारी पाई जा सकती है.
उपयोगकर्ता का प्रॉम्प्ट:
"Content API for Shopping में accountstatuses.get तरीके के लिए, Merchant API का कौनसा तरीका इस्तेमाल किया जाता है?"
एमसीपी सेवा, माइग्रेशन से जुड़ी आधिकारिक गाइड और रेफ़रंस दस्तावेज़ों से कॉन्टेक्स्ट उपलब्ध कराती है. इससे आपका असिस्टेंट, नए एपीआई के नाम accounts.issues के साथ-साथ अन्य जानकारी भी दे पाता है.
दूसरा उदाहरण: कोड का सैंपल ढूंढना
आपको कोई नई सुविधा लागू करनी है और इसके लिए, आपको कोई व्यावहारिक उदाहरण चाहिए.
उपयोगकर्ता का प्रॉम्प्ट:
"Merchant API का इस्तेमाल करके, शिपिंग की नई सेवा जोड़ने के लिए Python कोड का सैंपल दिखाओ."
एमसीपी सेवा, Google के आधिकारिक GitHub डेटा स्टोर और डेवलपर गाइड से काम के कोड सैंपल ढूंढती है. इसके बाद, Assistant आपको कोड ब्लॉक का पूरा और इस्तेमाल के लिए तैयार वर्शन दिखा सकती है.
तीसरा उदाहरण: एपीआई के कॉन्सेप्ट समझना
आपको कोई नई अवधारणा समझनी हो या किसी संसाधन के स्ट्रक्चर या Merchant API के पूरे पैटर्न को समझना हो.
उपयोगकर्ता का प्रॉम्प्ट:
"मैं Merchant API का इस्तेमाल करके, किसी प्रॉडक्ट की इन्वेंट्री को कैसे अपडेट करूं?"
एमसीपी सेवा, प्रॉडक्ट रिसॉर्स के दस्तावेज़ और काम की गाइड से कॉन्टेक्स्ट दिखाती है. इसके बाद, आपका असिस्टेंट आपको accounts.productInputs.insert तरीके का इस्तेमाल करने का तरीका बता सकता है. साथ ही, प्रॉडक्ट के संसाधन का वह हिस्सा दे सकता है जिसमें सिर्फ़ productId और इन्वेंट्री से जुड़े वे फ़ील्ड शामिल हों जिन्हें आपको अपडेट करना है.
"मैं Merchant Center API के ज़रिए किए गए ऐप्लिकेशन कॉल को कैसे अनुमति दूँ?"
एमसीपी सेवा, पुष्टि करने की आधिकारिक गाइड से कॉन्टेक्स्ट वापस पाती है. इनमें पुष्टि करने के अलग-अलग तरीके शामिल होते हैं. इसके बाद, आपकी Assistant उपलब्ध मुख्य विकल्पों के बारे में बता सकती है. जैसे, सर्वर-टू-सर्वर इंटरैक्शन के लिए सेवा खाते का इस्तेमाल करना या किसी उपयोगकर्ता की ओर से कार्रवाई करते समय OAuth 2.0 क्लाइंट आईडी का इस्तेमाल करना.
चौथा उदाहरण: एपीआई में हुए बदलावों के मुताबिक ढलना
Merchant API में नए पैटर्न पेश किए गए हैं. जैसे, बैचिंग के अनुरोध. ये पैटर्न, Content API for Shopping से अलग हैं. Content API for Shopping में कुछ खास custombatch तरीकों का इस्तेमाल किया जाता है. वहीं, Merchant API में एचटीटीपी के लिए, एक से ज़्यादा अनुरोध एक साथ भेजने की सुविधा पहले से मौजूद होती है.
उपयोगकर्ता का प्रॉम्प्ट:
"Merchant API में products.custombatch का इस्तेमाल करने का नया तरीका क्या है?"
MCP सेवा, एक साथ कई अनुरोधों के लिए कोड को फिर से फ़ैक्टर करें से कॉन्टेक्स्ट को वापस लाती है. इसमें बताया गया है कि Merchant API में, custombatch के लिए खास तरीके मौजूद नहीं हैं.
इसके बजाय, इसमें multipart के Content-Type के साथ एचटीटीपी बैचिंग का इस्तेमाल करने के बारे में दस्तावेज़ दिया गया है. इसके बाद, आपका असिस्टेंट यह बता सकता है कि https://merchantapi.googleapis.com/batch/{sub-api}/v1 एंडपॉइंट को भेजे गए, कई एपीआई कॉल वाले एक एचटीटीपी अनुरोध को कैसे बनाया जाए. साथ ही, कई हिस्सों वाले अनुरोध को स्ट्रक्चर करने का उदाहरण भी दे सकता है. इससे माइग्रेशन के मुश्किल टास्क को आसान बनाया जा सकता है.
नॉलेज बेस के सोर्स
एमसीपी सेवा, अपने नॉलेज बेस को सिर्फ़ सार्वजनिक और आधिकारिक स्रोतों से बनाती है, ताकि यह पक्का किया जा सके कि वह जो कॉन्टेक्स्ट दे रही है वह सटीक और भरोसेमंद हो. यह सेवा, डेवलपर की आधिकारिक साइट और कोड सैंपल रिपॉज़िटरी के पूरे कॉन्टेंट को इंडेक्स करती है. इसमें ये चीज़ें शामिल हैं:
- Merchant API डेवलपर साइट: सभी गाइड, रेफ़रंस मटीरियल, और दस्तावेज़.
- Merchant API की Apps Script सेवा: Apps Script से Merchant API इस्तेमाल करने का उदाहरण.
- आधिकारिक कोड सैंपल: Merchant API के लिए, Google की ओर से उपलब्ध कराए गए सभी आधिकारिक कोड सैंपल, GitHub के डेटा स्टोर से.
- क्लाइंट लाइब्रेरी: Merchant Center API के साथ काम करने वाली सभी आधिकारिक क्लाइंट लाइब्रेरी