MCP Tools Reference: paydeveloper.googleapis.com

টুল: set_principal_role

কোনো মার্চেন্টের জন্য একজন প্রিন্সিপাল (ব্যবহারকারী)-এর ভূমিকা নির্ধারণ করে, অথবা নির্দিষ্ট ভূমিকা সহ একজন নতুন প্রিন্সিপাল যোগ করে। প্রিন্সিপালকে একটি ইমেল আমন্ত্রণ পাঠানো হয় এবং তার অ্যাক্সেস সক্রিয় হওয়ার আগে তাকে অবশ্যই সেটি গ্রহণ করতে হবে। এই অপারেশনের জন্য মার্চেন্টের অ্যাডমিন অ্যাক্সেস প্রয়োজন।

নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে curl ব্যবহার করে set_principal_role 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": "set_principal_role",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

কোনো মার্চেন্টের প্রিন্সিপাল যোগ বা আপডেট করার জন্য অনুরোধ বার্তা।

সেটপ্রিন্সিপালরোলরিকোয়েস্ট

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

string

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

email

string

আবশ্যক। যোগ বা হালনাগাদ করার জন্য অধ্যক্ষের ইমেল ঠিকানা।

role

enum ( PrincipalRole )

প্রয়োজনীয়। অধ্যক্ষকে পদটি প্রদান করতে হবে।

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

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

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

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

কোনো মার্চেন্টের ক্ষেত্রে প্রিন্সিপাল যোগ বা আপডেট করার প্রতিক্রিয়া বার্তা।

প্রধান ভূমিকার প্রতিক্রিয়া নির্ধারণ করুন

JSON উপস্থাপনা 
{
  "state": enum (State)
}
ক্ষেত্র
state

enum ( State )

যোগ বা হালনাগাদ করার পর প্রিন্সিপালের অবস্থা।

রাজ্য

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

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

টুল টীকা

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

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

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

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