MCP Tools Reference: paydeveloper.googleapis.com

الأداة: set_principal_role

تضبط هذه الطريقة دور جهة رئيسية (مستخدم) في تاجر، أو تضيف جهة رئيسية جديدة بالدور المحدّد. يتم إرسال دعوة عبر البريد الإلكتروني إلى مدير المدرسة، وعليه قبولها قبل أن يصبح بإمكانه الوصول إلى الحساب. تتطلّب هذه العملية إذن وصول إداري للتاجر.

يوضّح نموذج الرمز التالي كيفية استخدام curl لاستدعاء أداة 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

دور يمكن منحه إلى جهة أساسية (مستخدم) في تاجر.

عمليات التعداد
PRINCIPAL_ROLE_UNSPECIFIED الدور غير محدّد.
ADMIN الوصول الكامل إلى التاجر، بما في ذلك إدارة المستخدمين
DEVELOPER يُمنح هذا الإذن للمطوّرين الذين يدمجون تطبيقاتهم مع التاجر.

مخطط النتائج

رسالة الردّ لإضافة جهة اتصال رئيسية أو تعديلها في حساب تاجر

SetPrincipalRoleResponse

تمثيل JSON 
{
  "state": enum (State)
}
الحقول
state

enum (State)

حالة الجهة الرئيسية بعد الإضافة أو التعديل

ولاية

حالة إذن وصول الجهة الرئيسية إلى حساب تاجر

عمليات التعداد
STATE_UNSPECIFIED لم يتم تحديد حالة الوصول.
ACTIVE لدى الجهة الرئيسية إذن وصول نشط ومقبول.
PENDING تمت دعوة المدير ولكن لم يقبل الدعوة بعد.
EXPIRED انتهت صلاحية دعوة المسؤول.

التعليقات التوضيحية للأدوات

يتم إرسال تعليقات توضيحية للأدوات إلى عملاء MCP لوصف المخاطر الأساسية لأداة معيّنة. تتعامل معظم البرامج مع هذه التلميحات على أنّها غير موثوق بها، ولكن يمكن استخدامها لتحديد الوقت الذي قد يتم فيه إرسال طلب تأكيد إلى المستخدم.

بالإضافة إلى سلسلة العنوان، يتم تحديد تلميحات القيم المنطقية التالية على النحو التالي:

  • ‫readOnlyHint: إذا كانت القيمة صحيحة، لن تعدّل الأداة بيئتها. القيمة التلقائية: false.
  • ‫destructiveHint: إذا كانت القيمة صحيحة، يمكن للأداة تنفيذ إجراءات مدمّرة. إذا كانت القيمة "خطأ"، يمكن للأداة تنفيذ إجراءات إضافية فقط. القيمة التلقائية: true
  • idempotentHint: إذا كانت القيمة صحيحة، لن يكون لاستدعاء الأداة بشكل متكرر باستخدام الوسيطات نفسها أي تأثير إضافي على بيئتها. القيمة التلقائية: false.
  • openWorldHint: إذا كانت القيمة صحيحة، يمكن للأداة التفاعل مع "عالم مفتوح" من الكيانات الخارجية. إذا كانت القيمة خطأ، يمكن للأداة التفاعل مع الكيانات الداخلية فقط. على سبيل المثال، ستكون أداة البحث على الويب عالمًا مفتوحًا، بينما لن تكون أداة الذاكرة عالمًا مفتوحًا.

تلميح مدمّر: ✅ | تلميح متكرّر: ❌ | تلميح للقراءة فقط: ❌ | تلميح للعالم المفتوح: ❌