MCP Tools Reference: paydeveloper.googleapis.com

टूल: list_merchants

इस तरीके से, पुष्टि किए गए खाते से जुड़े सभी Google Pay कारोबारियों या कंपनियों की पूरी सूची मिलती है. कारोबारी या कंपनी के खाते में उपयोगकर्ता की भूमिका के आधार पर, एडमिन को कारोबारी या कंपनी की पूरी जानकारी दिखती है. वहीं, डेवलपर को सिर्फ़ बुनियादी जानकारी दिखती है.

यहां दिए गए कोड सैंपल में, list_merchants MCP टूल को कॉल करने के लिए curl का इस्तेमाल करने का तरीका बताया गया है.

कर्ल अनुरोध 
curl --location 'https://paydeveloper.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_merchants",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

कारोबारियों या कंपनियों की लिस्टिंग के लिए मैसेज का अनुरोध करें.

ListMerchantsRequest

JSON के काेड में दिखाना 
{
  "view": enum (MerchantView)
}
फ़ील्ड
view

enum (MerchantView)

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

MerchantView

हर कारोबारी या कंपनी के लिए, जानकारी का लेवल.

Enums
MERCHANT_VIEW_UNSPECIFIED डिफ़ॉल्ट / सेट नहीं की गई वैल्यू. एपीआई, डिफ़ॉल्ट रूप से बुनियादी व्यू पर सेट होगा.
MERCHANT_VIEW_BASIC कारोबारी या कंपनी के बारे में बुनियादी जानकारी शामिल करें.
MERCHANT_VIEW_FULL कारोबारी या कंपनी के बारे में पूरी जानकारी शामिल करें.

आउटपुट स्कीमा

कारोबारियों या कंपनियों की लिस्टिंग के लिए जवाब का मैसेज.

ListMerchantsResponse

JSON के काेड में दिखाना 
{
  "merchants": [
    {
      object (Merchant)
    }
  ]
}
फ़ील्ड
merchants[]

object (Merchant)

उन कारोबारियों या कंपनियों की सूची जिनके खाते का ऐक्सेस उपयोगकर्ता के पास है.

व्यापारी

JSON के काेड में दिखाना 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
फ़ील्ड
merchantId

string

सिर्फ़ आउटपुट के लिए. कारोबारी या कंपनी का यूनीक आइडेंटिफ़ायर.
displayName

string

ज़रूरी है. कारोबारी या कंपनी का डिसप्ले नेम.
regionCode

string

ज़रूरी है. कारोबार की जगह का क्षेत्र कोड. फ़ॉर्मैट, यूनिकोड CLDR के क्षेत्र कोड होते हैं. जैसे, "US". भारत ("IN") में यह सुविधा उपलब्ध नहीं है.
mcc

enum (Mcc)

ज़रूरी है. कारोबारी या कंपनी का मर्चेंट कैटगरी कोड (एमसीसी).
corporateWebsiteUrl

string

ज़रूरी है. कारोबारी या कंपनी की कॉर्पोरेट वेबसाइट.
customerSupportWebsiteUrl

string

ज़रूरी है. कारोबारी या कंपनी की ग्राहक सहायता वेबसाइट.
customerSupportEmail

string

ज़रूरी है. कारोबारी या कंपनी की ग्राहक सहायता टीम का ईमेल पता.
customerSupportPhone

string

ज़रूरी है. कारोबारी या कंपनी का ग्राहक सहायता टीम का फ़ोन नंबर.
state

enum (State)

सिर्फ़ आउटपुट के लिए. कारोबारी या कंपनी की स्थिति.

Mcc

कारोबारी या कंपनी का मर्चेंट कैटगरी कोड (एमसीसी).

Enums
OTHERS अन्य
MISC_FOOD_STORES कई तरह के फ़ूड स्टोर – शॉपिंग स्टोर और खास बाज़ार
MISC_APPAREL मिसलेनियस अपेरल ऐंड ऐक्सेसरी शॉप
ARTISTS_SUPPLY कलाकार के सामान और क्राफ़्ट की दुकानें
AUTOMOTIVE_PARTS ऑटोमोटिव पार्ट्स, ऐक्सेसरीज़ स्टोर्स
HEALTH_AND_BEAUTY स्वास्थ्य और सौंदर्य की दुकान
BOOKS_PERIODICALS किताबें, पत्र-पत्रिकाएं, और अख़बार
CAMERA_STORES कैमरा और फ़ोटोग्राफ़ी के सामान की दुकानें
COMPUTERS_EQUIPMENT कंप्यूटर, कंप्यूटर के सहायक उपकरण, सॉफ़्टवेयर
COMPUTER_SOFTWARE कंप्यूटर सॉफ़्टवेयर स्टोर
ELECTRONICS_SALES इलेक्ट्रॉनिक सामान की बिक्री
GIFT_SHOPS कार्ड की दुकानें, गिफ़्ट, नोवल्टी, और सोविनियर की दुकानें
EATING_PLACES खाने-पीने की जगहें और रेस्टोरेंट
MISC_GENERAL_MERCHANDISE सामान्य मर्चंडाइज़
HOME_SUPPLY घरेलू सामान के वेयरहाउस स्टोर
COMPUTER_NETWORK_SERVICES कंप्यूटर नेटवर्क सेवाएं
DIGITAL_GOODS_MEDIA डिजिटल सामान: किताबें, फ़िल्में, संगीत
DIGITAL_GOODS_GAMES डिजिटल प्रॉडक्ट: गेम
DIGITAL_GOODS_APPLICATIONS डिजिटल प्रॉडक्ट: ऐप्लिकेशन (गेम शामिल नहीं हैं)
POLITICAL_ORGANIZATIONS राजनैतिक संगठन
CHARITABLE_ORGANIZATIONS चैरिटी और सामाजिक सेवा करने वाले संगठन
DRUG_STORES दवा की दुकानें और फ़ार्मेसी
REAL_ESTATE_RENTALS रीयल एस्टेट एजेंट और मैनेजर - रेंटल
MISC_PERSONAL_SERVICES अन्य निजी सेवाएं, जिन्हें कहीं और शामिल नहीं किया गया है
SPORTING_GOODS खेलकूद के सामान की दुकानें
STATIONERY_OFFICE_SUPPLIES स्टेशनरी, ऑफ़िस का सामान, प्रिंटिंग और राइटिंग पेपर
THEATRICAL_TICKET_AGENCIES थिएटर की टिकट एजेंसियां
TIMESHARES टाइमशेयर
TOURIST_ATTRACTIONS पर्यटकों के घूमने-फिरने की जगहें और प्रदर्शनी
HOBBY_TOY_GAME_SHOPS शौक, खिलौने, और गेम की दुकानें
PET_SHOPS पालतू जानवरों की दुकानें, पालतू जानवरों का खाना और अन्य सामान बेचने वाली दुकानें
OTHER_LODGING ठहरने की अन्य जगहें–होटल, मोटल, रिज़ॉर्ट
TELECOMMUNICATION_SERVICES दूरसंचार सेवाएं
TRANSPORTATION_SERVICES परिवहन सेवाएं
OTHER_AIRLINES अन्य एयरलाइंस
TRAVEL_AGENCIES ट्रैवल एजेंसी और टूर ऑपरेटर
GOVERNMENT_OWNED_LOTTERIES_US सरकार के मालिकाना हक वाली लॉटरी (सिर्फ़ अमेरिका के लिए)
GOVERNMENT_LICENSED_CASINOS_US सरकार से लाइसेंस पाए ऑनलाइन कसीनो (ऑनलाइन जुआ) (सिर्फ़ अमेरिका में)
BETTING सट्टेबाज़ी (इसमें लॉटरी टिकट, कसीनो गेमिंग चिप, ऑफ-ट्रैक बेटिंग, और दांव लगाना शामिल है)
GOVERNMENT_OWNED_LOTTERIES_NON_US सरकार के मालिकाना हक वाली लॉटरी (अमेरिका के बाहर के देशों/इलाकों के लिए)

राज्य

कारोबारी या कंपनी की स्थिति.

Enums
STATE_UNSPECIFIED कारोबारी या कंपनी की स्थिति की जानकारी नहीं दी गई है.
VERIFIED कारोबारी या कंपनी की पुष्टि हो गई है और उसे मंज़ूरी मिल गई है.
IN_REVIEW कारोबारी की प्रोफ़ाइल में किए गए बदलाव की समीक्षा की जा रही है.
REJECTED कारोबारी या कंपनी की प्रोफ़ाइल में किए गए बदलाव को अस्वीकार कर दिया गया है.
INCOMPLETE_SIGNUP कारोबारी या कंपनी की प्रोफ़ाइल में पूरी जानकारी नहीं दी गई है.
SANCTIONS_HIT कारोबारी या कंपनी की प्रोफ़ाइल पर पाबंदियां लगी हों.
READY_FOR_REVIEW कारोबारी या कंपनी की प्रोफ़ाइल पूरी हो गई है और समीक्षा के लिए तैयार है.
DISABLED कारोबारी या कंपनी की प्रोफ़ाइल बंद है या सक्रिय नहीं है.

टूल एनोटेशन

टूल के एनोटेशन, एमसीपी क्लाइंट को भेजे जाते हैं. इनसे किसी टूल से जुड़े बुनियादी जोखिम के बारे में जानकारी मिलती है. ज़्यादातर क्लाइंट, इन संकेतों को भरोसेमंद नहीं मानते. हालांकि, इनका इस्तेमाल यह तय करने के लिए किया जा सकता है कि किसी उपयोगकर्ता को पुष्टि करने का प्रॉम्प्ट कब भेजा जाए.

टाइटल स्ट्रिंग के साथ-साथ, यहां दिए गए बूलियन हिंट भी तय किए गए हैं:

  • readOnlyHint: अगर यह सही है, तो टूल अपने एनवायरमेंट में बदलाव नहीं करता है. डिफ़ॉल्ट: गलत.
  • destructiveHint: अगर यह वैल्यू 'सही है' पर सेट है, तो टूल, डेटा को मिटाने जैसी कार्रवाइयां कर सकता है. अगर यह वैल्यू 'गलत है' पर सेट है, तो टूल सिर्फ़ जोड़ने वाली कार्रवाइयां कर सकता है. डिफ़ॉल्ट: सही.
  • idempotentHint: अगर यह वैल्यू 'सही है' पर सेट है, तो एक ही आर्ग्युमेंट के साथ टूल को बार-बार कॉल करने से, उसके एनवायरमेंट पर कोई अतिरिक्त असर नहीं पड़ेगा. डिफ़ॉल्ट: गलत.
  • openWorldHint: अगर यह वैल्यू सही है, तो टूल बाहरी इकाइयों की 'ओपन वर्ल्ड' के साथ इंटरैक्ट कर सकता है. अगर यह गलत है, तो टूल सिर्फ़ इंटरनल इकाइयों के साथ इंटरैक्ट कर सकता है. उदाहरण के लिए, वेब पर खोज करने वाला टूल ओपन वर्ल्ड होगा, जबकि मेमोरी टूल ओपन वर्ल्ड नहीं होगा.

डेटा में बदलाव करने से जुड़ी जानकारी: ❌ | एक ही अनुरोध को कई बार भेजने पर भी नतीजे में कोई बदलाव न होने से जुड़ी जानकारी: ✅ | सिर्फ़ पढ़ने से जुड़ी जानकारी: ✅ | ओपन वर्ल्ड से जुड़ी जानकारी: ❌