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 की एमसीपी ऐक्सेस सेवा, अल्फ़ा वर्शन है. इसका दायरा और सुविधाएं बढ़ाई जाएंगी. साथ ही, इसमें बदलाव भी किए जा सकते हैं.

शुरू करने से पहले, यहां दी गई सीमाएं और सबसे सही तरीके देखें:

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

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

सुरक्षित तरीके से टेस्ट करना

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

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

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

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

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

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

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

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

शुरू करना

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

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

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

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

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

Antigravity

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

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

Claude Desktop

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

{
    "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. एजेंट, Merchant Center क्वेरी लैंग्वेज (एमसीक्यूएल) क्वेरी बनाता है जो product_performance_view टेबल को टारगेट करती है. साथ ही, clicks DESC के हिसाब से ऑर्डर करती है और 5 तक सीमित होती है.
2. एजेंट, बनाई गई क्वेरी के साथ report_search को कॉल करता है.
3. एमसीपी सर्वर, लाइव रिपोर्टिंग डेटाबेस के ख़िलाफ़ क्वेरी को एक्ज़ीक्यूट करता है और पंक्तियां दिखाता है.
4. एजेंट, नतीजों को आपके लिए साफ़-सुथरी मार्कडाउन टेबल में फ़ॉर्मैट करता है.

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

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

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

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

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

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

एमसीपी टूल और उनके ब्यौरे

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

एमसीपी टूल	ब्यौरा
get_product_by_name	संसाधन के सटीक नाम का इस्तेमाल करके, किसी दिए गए मर्चेंट के लिए प्रॉडक्ट की जानकारी पाना. प्रॉडक्ट का स्टेटस दिखाता है. इसमें रिपोर्टिंग का कॉन्टेक्स्ट और प्रॉडक्ट के लेवल की संभावित समस्याएं शामिल होती हैं.
list_products	किसी दिए गए मर्चेंट के लिए, एक से ज़्यादा प्रॉडक्ट की सूची बनाना या उन्हें खोजना. एक से ज़्यादा प्रॉडक्ट के लिए, प्रॉडक्ट का स्टेटस दिखाता है. इसमें रिपोर्टिंग का कॉन्टेक्स्ट और प्रॉडक्ट के लेवल की संभावित समस्याएं शामिल होती हैं.
report_search	प्रॉडक्ट की परफ़ॉर्मेंस मेट्रिक, प्रॉडक्ट के स्टेटस, कीमत की अहम जानकारी, और प्रतिस्पर्धी विज़िबिलिटी पाने के लिए, रिपोर्टिंग टेबल के बारे में क्वेरी करना. ज़्यादा जानकारी के लिए, रिपोर्ट की गाइड देखें.
list_data_sources	किसी दिए गए मर्चेंट के लिए, उपलब्ध डेटा सोर्स की सूची देखना.
get_data_source	किसी खास डेटा सोर्स की जानकारी पाना.
create_data_source	किसी दिए गए मर्चेंट के लिए, एक नया डेटा सोर्स बनाना.
fetch_data_source	किसी दिए गए मर्चेंट के लिए, डेटा सोर्स से जुड़ी फ़ाइल को फ़ेच और प्रोसेस करना.
get_file_upload	किसी दिए गए डेटा सोर्स के लिए, हाल ही में अपलोड की गई फ़ाइल का स्टेटस पाना.
list_accounts	किसी दिए गए उपयोगकर्ता के लिए, खातों की सूची देखना.
list_account_issues	खाते के लेवल की समस्याओं की पहचान करने के लिए, किसी दिए गए मर्चेंट के लिए, खाते के लेवल की समस्याओं की सूची देखना.
list_programs	किसी दिए गए मर्चेंट के लिए, प्रोग्राम की सूची देखना. इसमें शामिल होने का स्टेटस, चालू इलाके, और पूरी न की गई ज़रूरी शर्तें शामिल होती हैं.
list_aggregate_product_statuses	प्रॉडक्ट डेटा की पूरी क्वालिटी को मॉनिटर करने के लिए, प्रॉडक्ट के लेवल की समस्याओं की इकट्ठा की गई सूची देखना.
get_automatic_improvements	अपने-आप सुधार होने की सेटिंग पाना. इसमें आइटम के अपडेट, इमेज में सुधार, और शिपिंग में सुधार शामिल हैं.