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: إذا كانت القيمة true، لا تعدّل الأداة بيئتها. القيمة التلقائية: false
  • destructiveHint: إذا كانت القيمة true، يمكن للأداة تنفيذ إجراءات مدمّرة. إذا كانت القيمة false، يمكن للأداة تنفيذ إجراءات إضافية فقط. القيمة التلقائية: true
  • idempotentHint: إذا كانت القيمة true، لن يؤدي استدعاء الأداة بشكل متكرّر باستخدام الوسيطات نفسها إلى أي تأثير إضافي على بيئتها. القيمة التلقائية: false
  • openWorldHint: إذا كانت القيمة true، يمكن للأداة التفاعل مع "عالم مفتوح" من الكيانات الخارجية. إذا كانت القيمة false، يمكن للأداة التفاعل مع الكيانات الداخلية فقط. على سبيل المثال، ستكون أداة البحث على الويب عالمًا مفتوحًا، بينما لن تكون أداة الذاكرة عالمًا مفتوحًا.

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