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 अफ़िलिएट प्रोग्राम से जुड़े आंकड़े.
• खाते के लेवल पर मौजूद उन समस्याओं की पहचान करें जिनकी वजह से, प्रॉडक्ट की विज़िबिलिटी या प्रोग्राम में हिस्सा लेने पर असर पड़ता है.
• डेटा सोर्स की सूची देखना, उन्हें बनाना, फ़ेच करना, और उनके अपलोड होने का स्टेटस देखना.
• अपनी इन्वेंट्री में मौजूद प्रॉडक्ट अस्वीकार किए जाने की सभी वजहों की सूची देखें.
• सामान, इमेज, और शिपिंग के लिए, अपने-आप होने वाले सुधार की सेटिंग की समीक्षा करें.
• 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}" \
  -H "MCP-Protocol-Version: {MCP_PROTOCOL_VERSION}" \
  -H "Mcp-Method: tools/list" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {
      "_meta": {
        "io.modelcontextprotocol/protocolVersion":
          "{MCP_PROTOCOL_VERSION}"
      }
    }
  }'

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}" \
  -H "MCP-Protocol-Version: {MCP_PROTOCOL_VERSION}" \
  -H "Mcp-Method: tools/call" \
  -H "Mcp-Name: list_data_sources" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "list_data_sources",
      "arguments": {
        "parent": "accounts/{ACCOUNT_ID}"
      },
      "_meta": {
        "io.modelcontextprotocol/protocolVersion":
          "{MCP_PROTOCOL_VERSION}"
      }
    }
  }'

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

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