MCP Tools Reference: paydeveloper.googleapis.com

ابزار: list_pass_issuers

فهرست جامعی از تمام صادرکنندگان کارت‌های اعتباری ثبت‌شده در کنسول تجاری گوگل والت مرتبط با کاربر احراز هویت‌شده را بازیابی می‌کند. این ابزار اطلاعات ضروری را برای توسعه‌دهندگانی که کارت‌های اعتباری والت مانند کارت‌های وفاداری، کارت‌های هدیه یا بلیط هواپیما را مدیریت می‌کنند، فراهم می‌کند.

نمونه کد زیر نحوه استفاده از curl برای فراخوانی ابزار list_pass_issuers MCP را نشان می‌دهد.

درخواست کرل 
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 )

اطلاعات اولیه صادرکنندگان کارت که با کاربر به اشتراک گذاشته می‌شود.

صادرکننده‌ی گذر

نمایش JSON 
{
  "issuerId": string,
  "displayName": string
}
فیلدها
issuerId

string ( int64 format)

اختیاری. شناسه منحصر به فرد صادرکننده مجوز.

displayName

string

اختیاری. نام نمایشی صادرکننده‌ی مجوز.

حاشیه‌نویسی ابزار

حاشیه‌نویسی‌های ابزار برای توصیف ریسک اولیه‌ی یک ابزار مشخص به کلاینت‌های MCP ارسال می‌شوند. اکثر کلاینت‌ها این نکات را غیرقابل اعتماد می‌دانند، اما می‌توان از آنها برای تصمیم‌گیری در مورد زمان ارسال پیام تأیید به کاربر استفاده کرد.

همراه با رشته عنوان، نکات بولی زیر به صورت زیر تعریف می‌شوند:

  • readOnlyHint : اگر درست باشد، ابزار محیط خود را تغییر نمی‌دهد. پیش‌فرض: نادرست.
  • destructiveHint : اگر درست باشد، ابزار می‌تواند اقدامات مخرب انجام دهد. اگر نادرست باشد، ابزار فقط می‌تواند اقدامات افزایشی انجام دهد. پیش‌فرض: درست.
  • idempotentHint : اگر مقدار آن درست باشد، فراخوانی مکرر ابزار با آرگومان‌های یکسان، هیچ تأثیر اضافی بر محیط آن نخواهد داشت. پیش‌فرض: false.
  • openWorldHint : اگر درست باشد، ابزار می‌تواند با «دنیای باز» از موجودیت‌های خارجی تعامل داشته باشد. اگر نادرست باشد، ابزار فقط می‌تواند با موجودیت‌های داخلی تعامل داشته باشد. برای مثال، یک ابزار جستجوی وب جهان‌باز خواهد بود، در حالی که یک ابزار حافظه جهان‌باز نخواهد بود.

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌