एपीआई इंटिग्रेशन और Code Assist Toolkit

Merchant API पर माइग्रेट करने की प्रोसेस को तेज़ करने के लिए, एपीआई इंटिग्रेशन और Code Assist टूलकिट का इस्तेमाल करें. साथ ही, एआई की मदद से काम करने वाले डेवलपमेंट टूल के साथ नए इंटिग्रेशन बनाएं.

खास जानकारी

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

  • कोड का अनुवाद और माइग्रेशन: इससे आपको Content API for Shopping के लेगसी कोड को नए Merchant API फ़ॉर्मैट में समझने और बदलने में मदद मिलती है. इसमें, प्रॉडक्ट एट्रिब्यूट को नए स्ट्रक्चर पर मैप करना और डिपेंडेंसी मैनेजमेंट फ़ाइलों को अपडेट करना शामिल है.
  • एपीआई के दस्तावेज़ों के बारे में विशेषज्ञता: इसमें Merchant API के संसाधनों, तरीकों, फ़ील्ड, कोटे, और सबसे सही तरीकों के बारे में साफ़ तौर पर बताया गया है. यह जानकारी, Google के आधिकारिक एपीआई के दस्तावेज़ों से लिए गए भरोसेमंद कॉन्टेक्स्ट पर आधारित है.
  • कोड जनरेट करना: यह Python, Java, PHP, और अन्य भाषाओं में Merchant API के अलग-अलग टास्क के लिए कोड स्निपेट जनरेट करता है.
  • समस्या हल करना: इससे एपीआई से जुड़ी सामान्य गड़बड़ियों का पता लगाने और उन्हें ठीक करने में मदद मिलती है.

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

नीचे दिए गए डायग्राम में, एआई की मदद से कोड माइग्रेट करने के लिए सेटअप के विकल्प दिखाए गए हैं. ये विकल्प, सबसे ज़्यादा इस्तेमाल किए जाने वाले इंटिग्रेटेड डेवलपमेंट एनवायरमेंट (आईडीई) के लिए उपलब्ध हैं. जैसे, Antigravity, Visual Studio Code, Cursor या Copilot. Gemini, Claude, ChatGPT, और Grok जैसे कोडिंग असिस्टेंट सेट अप किए जा सकते हैं. साथ ही, Merchant API डेवलपर दस्तावेज़ के एमसीपी सर्वर या Merchant API एजेंट स्किल की मदद से, इन्हें बेहतर बनाया जा सकता है. इससे इंटिग्रेशन की प्रोसेस को तेज़ करने के साथ-साथ, ज़्यादा सटीक नतीजे पाने में मदद मिलती है.

(Merchant API) एआई इंटिग्रेशन कोड असिस्ट का डायग्राम

Merchant API Developer Documentation MCP Server

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

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

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

वर्कफ़्लो का उदाहरण:

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

शुरू करना

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

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

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

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

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

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

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. एजेंट के लिए निर्देश जोड़ना (ज़रूरी नहीं)

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

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

इन सामान्य मामलों में, एमसीपी की मदद से अपने वर्कफ़्लो को बेहतर बनाया जा सकता है:

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

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

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

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

अपने एजेंट को सिस्टम के निर्देश और एमसीपी का ऐक्सेस देकर, आपका एजेंट सीधे आपके आईडीई में 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 का कौनसा तरीका इस्तेमाल किया जाता है?"

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

तीसरा विकल्प: कोड का सैंपल ढूंढना

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

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

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

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

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

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

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

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

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

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

एमसीपी सेवा, पुष्टि करने से जुड़ी आधिकारिक गाइड से कॉन्टेक्स्ट हासिल करती है. इनमें पुष्टि करने के अलग-अलग तरीके शामिल होते हैं. इसके बाद, आपकी Assistant उपलब्ध मुख्य विकल्पों के बारे में बता सकती है. जैसे, सर्वर-टू-सर्वर इंटरैक्शन के लिए सेवा खाते का इस्तेमाल करना या किसी उपयोगकर्ता की ओर से कार्रवाई करते समय 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'"

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

Merchant API एजेंट की स्किल

एजेंट की क्षमताओं का स्पेसिफ़िकेशन, एक ओपन स्टैंडर्ड है. इसे एआई डेवलपमेंट टूल में इस्तेमाल किया जाता है. Agent Skills का इस्तेमाल करके, डेवलपर के तौर पर अपने अनुभव को बेहतर बनाएं. साथ ही, Content API for Shopping से माइग्रेट करने और नए इंटिग्रेशन बनाने, दोनों को ऑप्टिमाइज़ करें. कारोबारी या कंपनी के लिए उपलब्ध Merchant API Agent Skills पैकेज में, डोमेन के हिसाब से जानकारी और टूल होते हैं. इनसे एआई एजेंट की क्षमताओं को बेहतर बनाया जा सकता है. साथ ही, दस्तावेज़ से जुड़ी क्वेरी, कोड जनरेट करने, और समस्या हल करने के लिए, मांग पर विशेषज्ञ की सहायता मिलती है.

Merchant API Agent Skills, एआई की मदद से काम करने वाले कई कमांड-लाइन टूल और आईडीई के साथ काम करती हैं. जैसे, Antigravity और Claude Code.

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

Merchant API एजेंट स्किल, ओपन एजेंट स्किल स्टैंडर्ड पर आधारित एक खास विशेषज्ञता पैकेज उपलब्ध कराती हैं. हमारी एजेंट स्किल mapi-developer-assistant, आपके एआई डेवलपमेंट टूल और Merchant API Dev Doc MCP Server के बीच एक इंटेलिजेंट लेयर के तौर पर काम करती है. इसमें डोमेन की विशेषज्ञता और प्रक्रिया से जुड़ी गाइडेंस शामिल होती है. इसकी ये प्रॉपर्टी हैं:

  • ज़ीरो कॉन्फ़िगरेशन: एमसीपी सर्वर कनेक्शन को अपने-आप मैनेज करता है. इससे एंडपॉइंट को मैन्युअल तरीके से सेटअप करने की ज़रूरत नहीं पड़ती.
  • एक्सपर्ट वर्कफ़्लो: यह सुविधा, उपयोगकर्ता के प्रॉम्प्ट को ऑप्टिमाइज़ की गई क्वेरी में बदल देती है, ताकि सबसे काम की जानकारी को असरदार तरीके से हासिल किया जा सके.
  • कॉन्टेक्स्ट मैनेजमेंट और टोकन का बेहतर इस्तेमाल: यह "प्रोग्रेसिव डिसक्लोज़र" का इस्तेमाल करता है, ताकि ज़रूरत के हिसाब से जानकारी लोड की जा सके और एआई की कॉन्टेक्स्ट विंडो को सुरक्षित रखा जा सके.
  • बेहतर आउटपुट फ़ॉर्मैटिंग: इससे कार्रवाई करने लायक, पढ़ने में आसान, और सटीक जवाबों के लिए आउटपुट को फ़ॉर्मैट और स्ट्रक्चर करने के निर्देश मिलते हैं.

वर्कफ़्लो का उदाहरण:

  1. आपने एआई डेवलपमेंट टूल में Merchant API के बारे में कोई सवाल पूछा है.
  2. Merchant API Agent Skill, आपके इरादे का विश्लेषण करती है. इसके बाद, सटीक क्वेरी तैयार करती है और अनुरोध पर अपनी प्रक्रिया से जुड़ी जानकारी लागू करती है.
  3. एजेंट स्किल, Merchant API Dev Doc MCP सर्वर को कॉन्टेक्स्ट के लिए अनुरोध भेजता है. यह सर्वर merchantapi.googleapis.com/devdocs/mcp/ पर मौजूद है.
  4. एमसीपी सेवा, Merchant API के आधिकारिक दस्तावेज़, गाइड, और कोड सैंपल के इंडेक्स किए गए कलेक्शन को खोजती है.
  5. आपका एआई एजेंट, इस जानकारी का इस्तेमाल करके जवाब देता है. इससे आपको कार्रवाई करने में मदद मिलती है.

शुरू करना

Merchant API एजेंट की क्षमताओं के बारे में जानकारी देने वाली README फ़ाइल में, इन विषयों पर चरण-दर-चरण निर्देश दिए गए हैं:

  • Antigravity कमांड-लाइन टूल जैसे टूल के लिए ज़रूरी शर्तें.
  • चुने गए टूल में एजेंट की स्किल की सुविधा चालू करना.
  • GitHub रिपॉज़िटरी से mapi-developer-assistant स्किल इंस्टॉल करना. इसके लिए, README में दिए गए निर्देशों का पालन करें.
  • इंस्टॉलेशन की पुष्टि की जा रही है.
  • स्किल मैनेजमेंट के लिए बुनियादी निर्देश.

Antigravity कमांड-लाइन टूल, Claude Code, और अन्य एआई टूल को इंस्टॉल और सेटअप करने के बारे में ज़्यादा जानने के लिए, README फ़ाइल में दिए गए निर्देशों का पालन करें.

प्रॉम्प्ट के उदाहरण

एआई डेवलपमेंट टूल में इंस्टॉल और चालू होने के बाद, mapi-developer-assistant स्किल आम तौर पर तब अपने-आप चालू हो जाती है, जब Merchant API से जुड़े सवाल पूछे जाते हैं.

"मैं Python में Merchant API का इस्तेमाल करके, प्रॉडक्ट कैसे जोड़ूं?"

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

"मुझे Merchant API के साथ पुष्टि करने के लिए, Java का उदाहरण दिखाओ."

"productInputs.insert को कॉल करते समय, मुझे पुष्टि करने से जुड़ी गड़बड़ी के साथ '400 Bad Request' मैसेज मिल रहा है. मैं इस समस्या को कैसे ठीक करूं?"

"Merchant API में ProductInput और Product में क्या अंतर है?"

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

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