MCP Tools Reference: paydeveloper.googleapis.com

टूल: set_principal_role

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

यहां दिए गए कोड सैंपल में, set_principal_role 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": "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)

जोड़ने या अपडेट करने के बाद मूलधन की स्थिति.

राज्य

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

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

टूल एनोटेशन

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

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

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

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