MCP Tools Reference: paydeveloper.googleapis.com

الأداة: list_pass_issuers

تسترد قائمة شاملة بجميع جهات إصدار البطاقات المسجّلة في Business Console في محفظة Google المرتبطة بالمستخدم الذي تم التحقّق من هويته. وتوفّر هذه الأداة معلومات أساسية للمطوّرين الذين يديرون بطاقات Wallet، مثل بطاقات الولاء أو بطاقات الهدايا أو تذاكر الرحلات الجوية.

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

مخطط الإدخال

رسالة الطلب لعرض قائمة بجهات إصدار البطاقات التي تتم مشاركتها مع المستخدم الذي تم التحقّق من هويته

مخطط النتائج

رسالة الرد لعرض قائمة بجهات إصدار البطاقات التي تتم مشاركتها مع المستخدم الذي تم التحقّق من هويته

ListPassIssuersResponse

تمثيل JSON 
{
  "passIssuers": [
    {
      object (PassIssuer)
    }
  ]
}
الحقول
passIssuers[]

object (PassIssuer)

المعلومات الأساسية لجهات إصدار البطاقات التي تتم مشاركتها مع المستخدم

PassIssuer

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

string (int64 format)

اختياريّ. المعرّف الفريد لجهة إصدار البطاقة
displayName

string

اختياريّ. اسم العرض لجهة إصدار البطاقة

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

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

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

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

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