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 से कनेक्ट करने के लिए, अपने एमसीपी क्लाइंट की सेटिंग अपडेट करें. उदाहरण के लिए, mcp.json या settings.json.

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

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

Antigravity

OAuth 2.0 ऐक्सेस टोकन (स्कोप https://www.googleapis.com/auth/content के साथ) का इस्तेमाल करके, सीधे तौर पर होस्ट किए गए रिमोट एमसीपी एंडपॉइंट से कनेक्ट करें. Antigravity के दस्तावेज़ में दिए गए निर्देशों का पालन करें.

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

Claude CLI

claude mcp add कमांड का इस्तेमाल करके, होस्ट किए गए रिमोट एमसीपी एंडपॉइंट को सीधे Claude CLI में जोड़ें:

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}"

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

cURL

होस्ट किए गए Merchant API MCP एंडपॉइंट को सीधे तौर पर, स्टैंडर्ड JSON-RPC 2.0 अनुरोध भेजें.

उपलब्ध टूल की सूची:

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": {}
  }'

टूल कॉल को एक्ज़ीक्यूट करना (उदाहरण के लिए, list_data_sources):

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 क्लाउड प्रोजेक्ट का आईडी है

ध्यान दें: x-goog-user-project (या X-Goog-User-Project) हेडर, कोटा एट्रिब्यूशन के लिए आपके Google Cloud प्रोजेक्ट आईडी के बारे में बताता है. User Application Default Credentials (ADC) का इस्तेमाल करते समय, यह हेडर देना ज़रूरी है. सेवा खाते के निजी पासकोड या स्टैंडर्ड OAuth 2.0 क्लाइंट आईडी से पुष्टि करते समय, इसकी ज़रूरत नहीं होती.

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

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

एमसीपी टूल	ब्यौरा
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	अपने-आप होने वाले सुधारों की सेटिंग पाएं. इनमें सामान की लिस्टिंग अपडेट होने, इमेज में सुधार होने, और शिपिंग में सुधार होने की सेटिंग शामिल हैं.