Merchant API MCP Access Service (ऐल्फ़ा वर्शन)

Merchant API के मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) ऐक्सेस सेवा का इस्तेमाल करके, Merchant Center खाते के डेटा और अहम जानकारी का ऐक्सेस पाएं. इससे नए एजेंटिक अनुभव और ऑटोमेटेड वर्कफ़्लो बनाए जा सकते हैं.

खास जानकारी

Merchant API की एमसीपी ऐक्सेस सेवा, एलएलएम, एजेंट, और कोडिंग असिस्टेंट के लिए एक स्टैंडर्ड और सुरक्षित ब्रिज उपलब्ध कराती है. इसकी मदद से, Merchant Center के डेटा के आधार पर नए एजेंटिक अनुभव और ऑटोमेटेड वर्कफ़्लो बनाए और व्यवस्थित किए जा सकते हैं.

खास तौर पर, यह आपके Merchant Center खाते के डेटा और Google की जनरेट की गई रिपोर्ट और अहम जानकारी को ऐक्सेस करने की अनुमति देता है. इससे सिर्फ़ पढ़ने और सीमित तौर पर लिखने की कार्रवाइयां की जा सकती हैं. जैसे:

• प्रॉडक्ट अस्वीकार किए जाने की समस्या का पता लगाना और उसे ठीक करना
• परफ़ॉर्मेंस रिपोर्ट और अहम जानकारी जनरेट करना
• अपने-आप होने वाले सुधारों के लिए ऑप्ट-इन करने की सुविधा की समीक्षा करना
• डेटा सोर्स बनाना और फ़ेच करना

सुरक्षा और ऐक्सेस कंट्रोल

Merchant API की एमसीपी ऐक्सेस सेवा को सुरक्षा को ध्यान में रखकर डिज़ाइन किया गया है:

• पुष्टि: टूल को Merchant API की स्टैंडर्ड पुष्टि के हिसाब से इस्तेमाल किया जाता है. इसके लिए, OAuth 2.0 या सेवा खाते के क्रेडेंशियल की ज़रूरत होती है. हमारा सुझाव है कि आप ऐसे क्रेडेंशियल का इस्तेमाल करें जिनके ऐक्सेस के अधिकार सबसे ज़्यादा सीमित हों.
• सुरक्षित तरीके से लागू करना: एजेंट की मदद से टूल खोजने पर, टूल दिखने से जुड़ी कोई पाबंदी नहीं होती. हालांकि, टूल को लागू करने के लिए, आपके एपीआई क्रेडेंशियल का इस्तेमाल किया जाता है.
• सुरक्षा उपाय: टूल को सिर्फ़ पढ़ने की अनुमति होती है. साथ ही, सुरक्षा के लिए कम जोखिम वाले टूल (उदाहरण के लिए, डेटा सोर्स बनाना) इस्तेमाल करने की अनुमति होती है.

विचार करने वाली ज़रूरी बातें

Merchant API MCP Access Service का ऐल्फ़ा वर्शन उपलब्ध है. इसके स्कोप और सुविधाओं को बढ़ाया जाएगा और इनमें बदलाव भी किया जा सकता है.

शुरू करने से पहले, इन बातों का ध्यान रखें:

बदलाव और रिलीज़

बिना सूचना दिए बदलाव किए जा सकते हैं. इनकी जानकारी, रिलीज़ नोट में दी जाएगी.

सुरक्षित टेस्टिंग

हमारा सुझाव है कि लाइव प्रोडक्शन एनवायरमेंट में इन टूल का इस्तेमाल करने से पहले, टेस्ट खाते या नॉन-लाइव खाते का इस्तेमाल करके, इन टूल को आज़माएं.

शेयर किया गया कोटा

Merchant API MCP Access Service, Merchant API के स्टैंडर्ड कॉल के साथ एक ही कोटा पूल शेयर करती है. एजेंट चलाने से, कोटा जल्दी खत्म हो सकता है. खास तौर पर, डेटा सोर्स से डेटा फ़ेच करने के लिए. हमारा सुझाव है कि प्रोडक्शन सेवा में रुकावटों से बचने के लिए, टेस्ट खाते का इस्तेमाल करें.

टूल को फ़िल्टर करना और सुरक्षा

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

उपलब्ध सुविधाओं की खास जानकारी

Merchant API की एमसीपी ऐक्सेस सेवा का इस्तेमाल करके, एजेंटिक तरीके से ये कार्रवाइयां की जा सकती हैं:

• किसी खास प्रॉडक्ट के लिए, स्टेटस और रिपोर्टिंग की पूरी जानकारी पाएं. इसके लिए, रिसॉर्स के सटीक नामों का इस्तेमाल करें.
• एक से ज़्यादा प्रॉडक्ट लिस्ट करना और खोजना.
• खोज क्वेरी की परफ़ॉर्मेंस मेट्रिक, प्रॉडक्ट की स्थितियां, और लोकप्रिय प्रॉडक्ट, कीमत के बारे में अहम जानकारी, प्रतिस्पर्धी ब्रैंड के प्रॉडक्ट की विज़िबिलिटी, और YouTube Shopping Affiliate के आंकड़े के बारे में अहम जानकारी.
• खाते से जुड़ी उन समस्याओं की पहचान करें जिनकी वजह से प्रॉडक्ट की विज़िबिलिटी या प्रोग्राम में हिस्सा लेने पर असर पड़ता है.
• डेटा सोर्स के अपलोड स्टेटस की सूची बनाएं, उसे बनाएं, फ़ेच करें, और उसकी जांच करें.
• अपनी इन्वेंट्री में मौजूद प्रॉडक्ट के अस्वीकार होने की एक साथ कई वजहें दिखाएं.
• सामानों, इमेज, और शिपिंग के लिए, अपने-आप सुधार होने की सेटिंग की समीक्षा करें.
• Merchant Center के कुछ प्रोग्राम के लिए, देखें कि वे किन देशों/इलाकों में उपलब्ध हैं, ज़रूरी शर्तें पूरी नहीं की गई हैं या प्रोग्राम में शामिल होने की स्थिति क्या है.

शुरू करना

अपने आईडीई, कोडिंग असिस्टेंट या एजेंट को Merchant API MCP Access Service से कनेक्ट करने के लिए, एमसीपी क्लाइंट की सेटिंग अपडेट करें. उदाहरण के लिए, Google Agent Studio, Claude Desktop, Antigravity, Visual Studio Code या अपने कस्टम एजेंट फ़्रेमवर्क के लिए, mcp.json फ़ाइल अपडेट करें.

Merchant API MCP Access Service को स्थानीय तौर पर सेटअप करने के लिए, सेवा खाते की ज़रूरत होती है. इस हेडलेस लोकल एक्ज़ीक्यूशन के लिए, स्टैंडर्ड उपयोगकर्ता OAuth काम नहीं करता. आपको एक सेवा खाता बनाना होगा. साथ ही, उसकी JSON फ़ॉर्मैट वाली निजी कुंजी फ़ाइल डाउनलोड करनी होगी. इसके बाद, आपको अपने Merchant Center खाते के आईडी के साथ-साथ, उस फ़ाइल का पाथ भी देना होगा.

सेवा खाता बनाने और डाउनलोड करने के बारे में ज़्यादा जानकारी के लिए, सेवा खातों से जुड़ी गाइड देखें.

क्लाइंट कॉन्फ़िगरेशन

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

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

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

एजेंटिक अनुभव और ऑटोमेटेड वर्कफ़्लो बनाने के लिए, Merchant API की एमसीपी ऐक्सेस सेवा का इस्तेमाल कैसे किया जा सकता है, यह बताने के लिए यहां दिए गए उदाहरण देखें:

पहला उदाहरण: प्रॉडक्ट अस्वीकार किए जाने की समस्या का पता लगाना और उसे ठीक करना

आपको यह जानना है कि कोई खास प्रॉडक्ट, Google Search के नतीजों में क्यों नहीं दिख रहा है.

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

"ऑफ़र आईडी 'offer123' वाले मेरे प्रॉडक्ट को क्यों अस्वीकार किया गया है?"

एमसीपी के साथ एजेंट का व्यवहार:

1. एजेंट, प्रॉडक्ट की स्थिति का पता लगाने के लिए list_products या get_product_by_name को कॉल करता है.
2. एमसीपी सर्वर, प्रॉडक्ट की स्थिति दिखाता है. इसमें issues की सूची भी शामिल होती है. उदाहरण के लिए, "कीमत का फ़ॉर्मैट गलत है" या "शिपिंग की वैल्यू मौजूद नहीं है".
3. एजेंट, समस्याओं का विश्लेषण करता है और आपको उनकी मुख्य वजह बताता है. साथ ही, उन्हें ठीक करने का तरीका भी बताता है. उदाहरण के लिए, कीमत की जानकारी अपडेट करना.

दूसरा तरीका: अपने-आप होने वाले सुधार की सुविधा के लिए ऑप्ट-इन करने की समीक्षा करना

आपको यह पुष्टि करनी है कि शिपिंग में अपने-आप सुधार होने की सुविधा चालू है या नहीं.

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

"क्या डिलीवरी में लगने वाले समय को अपने-आप सटीक दिखाने की सुविधा चालू है?"

एमसीपी के साथ एजेंट का व्यवहार:

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

तीसरा विकल्प: परफ़ॉर्मेंस रिपोर्ट और अहम जानकारी जनरेट करना

आपको Merchant Center के यूज़र इंटरफ़ेस (यूआई) पर नेविगेट किए बिना, अपनी हाल की परफ़ॉर्मेंस तुरंत देखनी हो.

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

"मुझे पिछले हफ़्ते के हिसाब से, क्लिक के आधार पर सबसे अच्छी परफ़ॉर्मेंस वाले पांच प्रॉडक्ट दिखाओ."

एमसीपी के साथ एजेंट का व्यवहार:

1. एजेंट, product_performance_view टेबल को टारगेट करने वाली Merchant Center Query Language (MCQL) क्वेरी बनाता है. इसमें clicks DESC के हिसाब से क्रम से लगाने और 5 तक सीमित करने की सुविधा होती है.
2. एजेंट, बनाई गई क्वेरी के साथ report_search को कॉल करता है.
3. MCP सर्वर, लाइव रिपोर्टिंग डेटाबेस के ख़िलाफ़ क्वेरी को एक्ज़ीक्यूट करता है और पंक्तियां दिखाता है.
4. एजेंट, नतीजों को आपके लिए साफ़-सुथरी मार्कडाउन टेबल में फ़ॉर्मैट करता है.

चौथा उदाहरण: डेटा सोर्स बनाना और उन्हें फ़ेच करना

आपको प्रॉडक्ट अपडेट अपलोड करने के लिए, नया डेटा सोर्स जोड़ना है.

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

"मेरे कारोबारी या कंपनी के खाते के लिए, 'price-updates' नाम का पूरक डेटा सोर्स बनाओ."

एमसीपी के साथ एजेंट का व्यवहार:

1. एजेंट, नई फ़ीड फ़ाइल को रजिस्टर करने के लिए, दी गई सेटिंग के साथ create_data_source को कॉल करता है.
2. एमसीपी सर्वर, डेटा सोर्स बनाता है और उसका यूनीक रिसोर्स नेम दिखाता है.
3. एजेंट, fetch_data_source को कॉल करके, उससे जुड़ी फ़ाइल को डाउनलोड और प्रोसेस करने के लिए कहता है.
4. अपलोड की प्रोग्रेस पर नज़र रखने और आइटम के प्रोसेस होने की स्थिति की पुष्टि करने के लिए, एजेंट get_file_upload को कॉल करता है.

एमसीपी टूल और उनकी जानकारी

Merchant API की एमसीपी ऐक्सेस सेवा, आपके एजेंट के लिए इन टूल को उपलब्ध कराती है: