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

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

खास जानकारी

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 की अपनी आईडी को आर्ग्युमेंट के तौर पर देना होगा.

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

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

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

{
    "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. एजेंट, 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 की एमसीपी ऐक्सेस सेवा, आपके एजेंट के लिए ये टूल उपलब्ध कराती है: