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.json या settings.json.

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

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

{
    "mcpServers": {
        "merchant-api-access": {
            "serverUrl": "https://merchantapi.googleapis.com/mcp",
            "headers": {
                "Authorization": "Bearer {ACCESS_TOKEN}",
                "x-goog-user-project": "{GOOGLE_CLOUD_PROJECT_ID}"
            }
        }
    }
}

claude mcp add --transport http merchant-api https://merchantapi.googleapis.com/mcp --scope local \
  --header "Authorization: Bearer {ACCESS_TOKEN}" \
  --header "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}"

curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "list_data_sources",
      "arguments": {
        "parent": "accounts/{ACCOUNT_ID}"
      }
    }
  }'

इनकी जगह ये डालें:

• ACCOUNT_ID: आपके Merchant Center का आईडी
• ACCESS_TOKEN: एपीआई कॉल करने के लिए अनुमति देने वाला टोकन
• GOOGLE_CLOUD_PROJECT_ID: यह आपके Merchant Center खाते से जुड़े Google क्लाउड प्रोजेक्ट का आईडी है

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

एजेंटिक अनुभव और ऑटोमेटेड वर्कफ़्लो बनाने के लिए, 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 Query Language (MCQL) क्वेरी बनाता है. यह क्वेरी, product_performance_view टेबल को टारगेट करती है. इसमें 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 की एमसीपी ऐक्सेस सेवा, आपके एजेंट के लिए इन टूल को उपलब्ध कराती है: