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

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌