MCP का इस्तेमाल करके, एपीआई इंटिग्रेशन और कोड असिस्ट टूलकिट

अपनी पसंद के कोडिंग असिस्टेंट से, Merchant API के बारे में कॉन्टेक्स्ट के हिसाब से अहम जानकारी पाएं. अब अपने इंटीग्रेटेड डेवलपमेंट एनवायरमेंट (आईडीई) में, मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सेवा का इस्तेमाल करके, डेवलपर दस्तावेज़ के इंटिग्रेशन को ऐक्सेस किया जा सकता है. यह सेवा, इंटिग्रेशन और माइग्रेशन के वर्कफ़्लो को तेज़ी से डेवलप करने में आपकी मदद करती है. इसके लिए, यह आपकी कोडिंग असिस्टेंट को Google API के आधिकारिक दस्तावेज़ों से भरोसेमंद कॉन्टेक्स्ट उपलब्ध कराती है.

प्रोटोकॉल के बारे में ज़्यादा जानने के लिए, मॉडल कॉन्टेक्स्ट प्रोटोकॉल स्टैंडर्ड देखें.

खास जानकारी

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

यह सेवा, खास तौर पर तैयार किए गए Retrieval-Augmented Generation (RAG) बैकएंड का इस्तेमाल करती है. जब एमसीपी की सुविधा वाले आईडीई कोडिंग असिस्टेंट से Merchant API के बारे में कोई सवाल पूछा जाता है, तो यह सेवा Google के आधिकारिक संसाधनों से टेक्स्ट और कोड के सबसे काम के स्निपेट ढूंढकर लाती है. इसके बाद, इन्हें कोडिंग असिस्टेंट को कॉन्टेक्स्ट के तौर पर भेजती है. इससे आपकी Assistant, आपको सटीक और अप-टू-डेट जवाब दे पाती है. इसके लिए, आपको अपने डेवलपमेंट एनवायरमेंट से बाहर जाने की ज़रूरत नहीं पड़ती.

यह कैसे काम करता है

एमसीपी का इस्तेमाल करके डेवलपर दस्तावेज़ इंटिग्रेशन, एआई की मदद से काम करने वाले आधुनिक डेवलपमेंट वर्कफ़्लो में इंटिग्रेट होता है:

  1. आपने एमसीपी के साथ काम करने वाले कोडिंग असिस्टेंट या एजेंट से कोई सवाल पूछा हो. यह सामान्य भाषा में पूछा गया सवाल, Merchant API के कोड सैंपल का अनुरोध या सीधे तौर पर अपने कोड को Merchant API में अनुवाद करने का अनुरोध भी हो सकता है.
  2. आपका कोडिंग असिस्टेंट, एमसीपी एंडपॉइंट को कॉन्टेक्स्ट के लिए अनुरोध भेजता है.
  3. एमसीपी सेवा, Merchant API के आधिकारिक दस्तावेज़, गाइड, और कोड सैंपल के इंडेक्स किए गए कलेक्शन में सबसे काम की जानकारी खोजती है.
  4. यह सेवा, कोडिंग में मदद करने वाले आपके असिस्टेंट को कॉन्टेक्स्ट के तौर पर ये भरोसेमंद स्निपेट दिखाती है.
  5. आपका कोडिंग असिस्टेंट, इस अच्छी क्वालिटी वाले कॉन्टेक्स्ट का इस्तेमाल करके, आपके मूल सवाल का सटीक और मददगार जवाब जनरेट करता है. इसके अलावा, वह कोड ट्रांसलेट करने का टास्क भी पूरा करता है.

शुरू करना

एमसीपी का इस्तेमाल करने के लिए, यह तरीका अपनाएं:

1. इसके साथ काम करने वाले टूल का इस्तेमाल करना

ऐसा आईडीई या कोडिंग असिस्टेंट खोलें जो स्ट्रीम किए जा सकने वाले एचटीटीपी ट्रांसपोर्ट के साथ मॉडल कॉन्टेक्स्ट प्रोटोकॉल के साथ काम करता हो.

2. एंडपॉइंट कॉन्फ़िगरेशन

अपने आईडीई या कोडिंग असिस्टेंट को एमसीपी से कनेक्ट करने के लिए, दिए गए रिमोट एंडपॉइंट की जानकारी का इस्तेमाल करें. इसके लिए, आपको सीधे तौर पर सेवा का यूआरएल या एमसीपी की परिभाषा डालनी पड़ सकती है. यह आपके टूल के कॉन्फ़िगरेशन पर निर्भर करता है.

सेवा का यूआरएल यह है:

MCP Server Name: "MAPI Docs MCP"
MCP Server URL:  "https://merchantapi.googleapis.com/devdocs/mcp/"
MCP Server Protocol: "http"

कॉन्फ़िगरेशन सेटअप:

Antigravity

Antigravity के दस्तावेज़ में दिए गए निर्देशों का पालन करें.

{
    "mcpServers": {
        "mapi-devdocs": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://merchantapi.googleapis.com/devdocs/mcp"
            ]
        }
    }
}

Visual Studio Code

Visual Studio Code के दस्तावेज़ में दिए गए निर्देशों का पालन करें.

{
    "servers": {
        "mapi-devdocs": {
            "type": "http",
            "url": "https://merchantapi.googleapis.com/devdocs/mcp/"
        }
    }
}
रेट लिमिट इसलिए तय की गई हैं, ताकि सभी लोग इसका सही तरीके से इस्तेमाल कर सकें और सेवा बिना किसी रुकावट के चलती रहे.

3. एजेंट के लिए निर्देश जोड़ना (ज़रूरी नहीं)

अपने एजेंट को एमसीपी का इस्तेमाल करके सीधे कोड का अनुवाद करने की सुविधा देने के लिए, उसे सिस्टम के निर्देश: MerchantIntegrator Agent Protocol दें. इन निर्देशों से एजेंट को यह समझने में मदद मिलती है कि कोड का अनुवाद करने के लिए, एमसीपी का सही तरीके से इस्तेमाल कैसे करना है. आपके टूल के आधार पर, इन निर्देशों को सिस्टम के निर्देशों के कॉन्फ़िगरेशन में या एजेंट के लिए अतिरिक्त कॉन्टेक्स्ट फ़ाइल के तौर पर दिया जा सकता है.

इस्तेमाल के उदाहरण

इन सामान्य इस्तेमाल के उदाहरणों में, एमसीपी आपके वर्कफ़्लो को बेहतर बना सकता है.

पहली स्थिति: products.insert कोड माइग्रेट करना

एजेंट से, Content API for Shopping products.insert इंटिग्रेशन कोड को सीधे Merchant API पर माइग्रेट करने के लिए कहा जा सकता है.

उपयोगकर्ता का प्रॉम्प्ट:

"Merchant API पर products.insert कोड माइग्रेट करें"

अपने एजेंट को सिस्टम के निर्देश: MerchantIntegrator Agent Protocol और एमसीपी का ऐक्सेस देकर, आपका एजेंट सीधे आपके आईडीई में Content API for Shopping कोड को Merchant API कोड में बदल सकता है. इस मामले में, यह productInputs.insert को मिलते-जुलते कॉल के तौर पर पहचान करेगा. साथ ही, प्रॉडक्ट एट्रिब्यूट को पुराने फ़ॉर्मैट से Merchant API के लिए ज़रूरी नए फ़ॉर्मैट में मैप करेगा. यह ज़रूरी इंपोर्ट और डिपेंडेंसी मैनेजमेंट फ़ाइल को भी अपडेट कर सकता है. उदाहरण के लिए, requirements.txt, pom.xml या package.json. एजेंट को बदलाव करने या नया फ़ोल्डर बनाने के लिए निर्देश दिए जा सकते हैं.

दूसरी स्थिति: मिलती-जुलती सुविधा ढूंढना

आपके पास Content API for Shopping का इस्तेमाल करने वाला कोई मौजूदा ऐप्लिकेशन है और आपको उसे अपडेट करना है. किसी लेगसी तरीके के बारे में पूछकर, लागू करने के नए तरीके और उससे जुड़े कोड के सैंपल के बारे में जानकारी पाई जा सकती है.

उपयोगकर्ता का प्रॉम्प्ट:

"Content API for Shopping में accountstatuses.get तरीके के लिए, Merchant API का कौनसा तरीका इस्तेमाल किया जाता है?"

एमसीपी सेवा, माइग्रेशन से जुड़ी आधिकारिक गाइड और रेफ़रंस दस्तावेज़ों से कॉन्टेक्स्ट उपलब्ध कराती है. इससे आपकी Assistant, नए एपीआई के नाम accounts.issues के साथ-साथ ज़्यादा जानकारी वाला जवाब दे पाती है.

तीसरा उदाहरण: कोड का सैंपल ढूंढना

आपको कोई नई सुविधा लागू करनी है और इसके लिए, आपको कोई उदाहरण चाहिए.

उपयोगकर्ता का प्रॉम्प्ट:

"Merchant API का इस्तेमाल करके, शिपिंग की नई सेवा जोड़ने के लिए Python कोड का सैंपल दिखाओ."

एमसीपी सेवा, Google के आधिकारिक GitHub डेटा स्टोर और डेवलपर गाइड से काम के कोड सैंपल वापस लाती है. इसके बाद, Assistant आपको कोड ब्लॉक का पूरा और इस्तेमाल के लिए तैयार वर्शन दिखा सकती है.

चौथा विकल्प: एपीआई के कॉन्सेप्ट समझना

आपको कोई नई अवधारणा समझनी हो या किसी संसाधन का स्ट्रक्चर या Merchant API का पूरा पैटर्न समझना हो.

उपयोगकर्ता का प्रॉम्प्ट:

"Merchant API का इस्तेमाल करके, किसी प्रॉडक्ट की इन्वेंट्री कैसे अपडेट करें?"

एमसीपी सेवा, प्रॉडक्ट रिसॉर्स के दस्तावेज़ और काम की गाइड से कॉन्टेक्स्ट दिखाती है. इसके बाद, आपका असिस्टेंट accounts.productInputs.insert तरीके का इस्तेमाल करने का तरीका बता सकता है. साथ ही, प्रॉडक्ट के संसाधन का वह हिस्सा उपलब्ध करा सकता है जिसमें सिर्फ़ productId और इन्वेंट्री से जुड़े वे फ़ील्ड शामिल हों जिन्हें आपको अपडेट करना है.

"मैं Merchant API के साथ अपने ऐप्लिकेशन कॉल को कैसे अनुमति दूं?"

एमसीपी सेवा, पुष्टि करने से जुड़ी आधिकारिक गाइड से कॉन्टेक्स्ट वापस लाती है. इनमें अनुमति देने के अलग-अलग तरीके शामिल होते हैं. इसके बाद, आपकी असिस्टेंट उपलब्ध मुख्य विकल्पों के बारे में बता सकती है. जैसे, सर्वर-टू-सर्वर इंटरैक्शन के लिए सेवा खाते का इस्तेमाल करना या किसी उपयोगकर्ता की ओर से कार्रवाई करते समय OAuth 2.0 क्लाइंट आईडी का इस्तेमाल करना.

पांचवां विकल्प: एपीआई में हुए बदलावों के हिसाब से खुद को ढालना

Merchant API में नए पैटर्न पेश किए गए हैं. जैसे, बैचिंग के अनुरोध. ये Content API for Shopping से अलग हैं. Content API for Shopping में कुछ खास custombatch तरीकों का इस्तेमाल किया जाता है. वहीं, Merchant API में एचटीटीपी के लिए, एक से ज़्यादा अनुरोध एक साथ भेजने की सुविधा पहले से मौजूद होती है.

उपयोगकर्ता का प्रॉम्प्ट:

"Merchant API में products.custombatch को इस्तेमाल करने का नया तरीका क्या है?"

एमसीपी सेवा, एक साथ कई अनुरोधों के लिए कोड को फिर से व्यवस्थित करें से कॉन्टेक्स्ट को वापस लाती है. इसमें बताया गया है कि Merchant API में, custombatch के लिए खास तरीके मौजूद नहीं हैं. इसके बजाय, यह multipart के Content-Type के साथ एचटीटीपी बैचिंग का इस्तेमाल करने के बारे में दस्तावेज़ उपलब्ध कराता है. इसके बाद, आपका असिस्टेंट यह बता सकता है कि एक एचटीटीपी अनुरोध कैसे बनाया जाए, जिसमें कई एपीआई कॉल शामिल हों. साथ ही, यह अनुरोध https://merchantapi.googleapis.com/batch/{sub-api}/v1 एंडपॉइंट को भेजा गया हो. इसके अलावा, वह कई हिस्सों वाले अनुरोध को स्ट्रक्चर करने का उदाहरण भी दे सकता है. इससे माइग्रेशन के मुश्किल टास्क को आसान बनाया जा सकता है.

छठा विकल्प: रिपोर्टिंग क्वेरी का अनुवाद करना

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

उपयोगकर्ता का प्रॉम्प्ट:

"इस रिपोर्टिंग क्वेरी को Content API से Merchant API पर माइग्रेट करें: SELECT metrics.impressions, metrics.clicks, metrics.ctr FROM MerchantPerformanceView WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'"

एमसीपी सेवा, रिपोर्टिंग के रेफ़रंस से जुड़े नए दस्तावेज़, डेवलपर गाइड, और माइग्रेशन गाइड को फिर से हासिल करती है. इस जानकारी के आधार पर, यह क्वेरी को नए स्ट्रक्चर में बदलता है. साथ ही, फ़ील्ड को उनके नए नामों और वैल्यू के साथ अपडेट करता है.

नॉलेज बेस के सोर्स

एमसीपी सेवा, अपने नॉलेज बेस को सिर्फ़ सार्वजनिक और आधिकारिक सोर्स से बनाती है. इससे यह पक्का होता है कि वह जो कॉन्टेक्स्ट दे रही है वह सटीक और भरोसेमंद हो. यह सेवा, डेवलपर की आधिकारिक साइट और कोड सैंपल रिपॉज़िटरी के पूरे कॉन्टेंट को इंडेक्स करती है. इसमें ये शामिल हैं: