MCP Tools Reference: paydeveloper.googleapis.com

الأداة: delete_principal

تحذف هذه الأداة إذن وصول مستخدم إلى تاجر معيّن. ويتطلّب هذا الإجراء إذن وصول المشرف إلى التاجر.

يوضّح نموذج الرمز البرمجي التالي كيفية استخدام curl لاستدعاء أداة delete_principal في 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": "delete_principal",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

رسالة الطلب لحذف مستخدم من تاجر

DeletePrincipalRequest

تمثيل JSON 
{
  "merchantId": string,
  "email": string
}
الحقول
merchantId

string

الحقل مطلوب. معرّف التاجر الذي سيتم حذف المستخدم منه
email

string

الحقل مطلوب. عنوان البريد الإلكتروني للمستخدم الذي يجب حذف إذن وصوله

مخطط النتائج

رسالة الردّ لحذف مستخدم من تاجر

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

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

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

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

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