MCP Tools Reference: paydeveloper.googleapis.com

টুল: list_principals

কোনো নির্দিষ্ট মার্চেন্টের অ্যাক্সেস আছে এমন প্রিন্সিপালদের (ব্যবহারকারীদের) তালিকা দেখায়। এই অপারেশনটির জন্য মার্চেন্টের অ্যাডমিন অ্যাক্সেস প্রয়োজন।

নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে curl ব্যবহার করে list_principals MCP টুলটিকে কল করতে হয়।

কার্ল অনুরোধ 
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_principals",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

একজন ব্যবসায়ীর প্রধানদের তালিকা তৈরির জন্য অনুরোধ বার্তা।

প্রধানদের তালিকা অনুরোধ

JSON উপস্থাপনা 
{
  "merchantId": string
}
ক্ষেত্র
merchantId

string

আবশ্যক। মার্চেন্ট আইডি, যার জন্য প্রিন্সিপালদের তালিকাভুক্ত করা হবে।

আউটপুট স্কিমা

কোনো বণিকের প্রধানদের তালিকাভুক্ত করার জন্য প্রতিক্রিয়া বার্তা।

তালিকা অধ্যক্ষদের প্রতিক্রিয়া

JSON উপস্থাপনা 
{
  "principals": [
    {
      object (Principal)
    }
  ]
}
ক্ষেত্র
principals[]

object ( Principal )

যেসব মূল ব্যক্তিরা বণিকের কাছে প্রবেশাধিকার রাখেন।

অধ্যক্ষ

JSON উপস্থাপনা 
{
  "email": string,
  "displayName": string,
  "role": enum (PrincipalRole),
  "state": enum (State)
}
ক্ষেত্র
email

string

আবশ্যক। অধ্যক্ষের ইমেইল ঠিকানা।

displayName

string

শুধুমাত্র আউটপুট। প্রিন্সিপালের প্রদর্শিত নাম।

role

enum ( PrincipalRole )

বণিকের উপর অধ্যক্ষের ভূমিকা।

state

enum ( State )

শুধুমাত্র আউটপুট। মার্চেন্টের উপর প্রিন্সিপালের অ্যাক্সেস অবস্থা।

প্রধান ভূমিকা

এমন একটি ভূমিকা যা কোনো মার্চেন্টের প্রিন্সিপালকে (ব্যবহারকারীকে) প্রদান করা যেতে পারে।

এনাম
PRINCIPAL_ROLE_UNSPECIFIED পদটি অনির্দিষ্ট।
ADMIN ব্যবহারকারী ব্যবস্থাপনা সহ মার্চেন্টের সম্পূর্ণ অ্যাক্সেস।
DEVELOPER মার্চেন্টের সাথে ইন্টিগ্রেটকারী ডেভেলপারদের জন্য উদ্দিষ্ট অ্যাক্সেস।

রাজ্য

কোনো বণিকের উপর কোনো প্রধানের প্রবেশাধিকারের অবস্থা।

এনাম
STATE_UNSPECIFIED অ্যাক্সেস অবস্থা অনির্দিষ্ট।
ACTIVE প্রিন্সিপালের একটি সক্রিয় ও স্বীকৃত অ্যাক্সেস রয়েছে।
PENDING অধ্যক্ষকে আমন্ত্রণ জানানো হয়েছে কিন্তু তিনি এখনো আমন্ত্রণটি গ্রহণ করেননি।
EXPIRED অধ্যক্ষের আমন্ত্রণের মেয়াদ শেষ হয়ে গেছে।

টুল টীকা

কোনো নির্দিষ্ট টুলের প্রাথমিক ঝুঁকি বর্ণনা করার জন্য টুল অ্যানোটেশনগুলো এমসিপি ক্লায়েন্টদের কাছে পাঠানো হয়। বেশিরভাগ ক্লায়েন্ট এই ইঙ্গিতগুলোকে অবিশ্বস্ত হিসেবে গণ্য করে, কিন্তু কখন একজন ব্যবহারকারীকে নিশ্চিতকরণের জন্য প্রম্পট পাঠানো হবে, সেই সিদ্ধান্ত নিতে এগুলো ব্যবহার করা যেতে পারে।

টাইটেল স্ট্রিং-এর পাশাপাশি, নিম্নলিখিত বুলিয়ান হিন্টগুলো নিম্নরূপভাবে সংজ্ঞায়িত করা হয়েছে:

  • readOnlyHint : যদি true হয়, টুলটি তার পরিবেশ পরিবর্তন করে না। ডিফল্ট: false।
  • destructiveHint : যদি true হয়, তাহলে টুলটি ধ্বংসাত্মক কাজ করতে পারবে। যদি false হয়, তাহলে টুলটি শুধুমাত্র সংযোজনমূলক কাজ করতে পারবে। ডিফল্ট: true।
  • idempotentHint : যদি true হয়, তাহলে একই আর্গুমেন্ট দিয়ে টুলটিকে বারবার কল করলেও এর এনভায়রনমেন্টের উপর কোনো অতিরিক্ত প্রভাব পড়বে না। ডিফল্ট: false।
  • openWorldHint : যদি true হয়, তাহলে টুলটি বাহ্যিক সত্তার 'ওপেন ওয়ার্ল্ড'-এর সাথে ইন্টারঅ্যাক্ট করতে পারবে। যদি false হয়, তাহলে টুলটি শুধুমাত্র অভ্যন্তরীণ সত্তার সাথে ইন্টারঅ্যাক্ট করতে পারবে। উদাহরণস্বরূপ, একটি ওয়েব সার্চ টুল ওপেন ওয়ার্ল্ড হবে, কিন্তু একটি মেমরি টুল ওপেন ওয়ার্ল্ড হবে না।

ধ্বংসাত্মক ইঙ্গিত: ❌ | স্বকীয় ইঙ্গিত: ✅ | শুধুমাত্র পঠনযোগ্য ইঙ্গিত: ✅ | উন্মুক্ত বিশ্ব ইঙ্গিত: ❌