MCP Tools Reference: paydeveloper.googleapis.com

टूल: set_principal_role

यह टूल, किसी कारोबारी या कंपनी के लिए मुख्य खाते (उपयोगकर्ता) की भूमिका सेट करता है. इसके अलावा, यह तय की गई भूमिका के साथ एक नया मुख्य खाता जोड़ता है. मुख्य खाते को ईमेल से न्योता भेजा जाता है. ऐक्सेस चालू होने से पहले, उसे यह न्योता स्वीकार करना होगा. इस कार्रवाई के लिए, कारोबारी या कंपनी के लिए एडमिन का ऐक्सेस होना ज़रूरी है.

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

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": "set_principal_role",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

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

SetPrincipalRoleRequest

JSON के काेड में दिखाना 
{
  "merchantId": string,
  "email": string,
  "role": enum (PrincipalRole)
}
फ़ील्ड
merchantId

string

ज़रूरी है. कारोबारी या कंपनी का आईडी, जिसके लिए मुख्य खाता जोड़ना या अपडेट करना है.
email

string

ज़रूरी है. वह ईमेल पता जिसे मुख्य खाते के तौर पर जोड़ना या अपडेट करना है.
role

enum (PrincipalRole)

ज़रूरी है. मुख्य खाते को दी जाने वाली भूमिका.

PrincipalRole

यह भूमिका, किसी कारोबारी या कंपनी के लिए मुख्य खाते (उपयोगकर्ता) को दी जा सकती है.

Enums
PRINCIPAL_ROLE_UNSPECIFIED भूमिका तय नहीं की गई है.
ADMIN कारोबारी या कंपनी का पूरा ऐक्सेस, जिसमें उपयोगकर्ताओं को मैनेज करना भी शामिल है.
DEVELOPER यह ऐक्सेस, उन डेवलपर के लिए है जो कारोबारी या कंपनी के साथ इंटिग्रेट कर रहे हैं.

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

किसी कारोबारी या कंपनी के लिए मुख्य खाता जोड़ने या अपडेट करने का जवाब देने वाला मैसेज.

SetPrincipalRoleResponse

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

enum (State)

मुख्य खाता जोड़ने या अपडेट करने के बाद उसकी स्थिति.

State

किसी कारोबारी या कंपनी के लिए मुख्य खाते के ऐक्सेस की स्थिति.

Enums
STATE_UNSPECIFIED ऐक्सेस की स्थिति तय नहीं की गई है.
ACTIVE मुख्य खाते का ऐक्सेस चालू है और उसे स्वीकार कर लिया गया है.
PENDING मुख्य खाते को न्योता भेजा गया है, लेकिन उसने अभी तक न्योता स्वीकार नहीं किया है.
EXPIRED मुख्य खाते को भेजे गए न्योते की समयसीमा खत्म हो गई है.

टूल के एनोटेशन

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

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

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

डेटा मिटाने वाला हिंट: ✅ | एक ही आर्ग्युमेंट के साथ बार-बार कॉल करने पर कोई असर न पड़ने वाला हिंट: ❌ | सिर्फ़ पढ़ने की अनुमति देने वाला हिंट: ❌ | वर्चुअल दुनिया वाला हिंट: ❌