MCP Tools Reference: paydeveloper.googleapis.com

ابزار: list_merchants

فهرست جامعی از تمام فروشندگان Google Pay مرتبط با حساب احراز هویت شده را بازیابی می‌کند. بسته به نقش کاربر در یک فروشنده، مدیران می‌توانند اطلاعات کامل و دقیق فروشنده را مشاهده کنند، در حالی که توسعه‌دهندگان فقط می‌توانند اطلاعات اولیه فروشنده را مشاهده کنند.

نمونه کد زیر نحوه استفاده از curl برای فراخوانی ابزار list_merchants 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_merchants",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

طرحواره ورودی

درخواست پیام برای فهرست کردن بازرگانان.

درخواست لیست فروشندگان

نمایش JSON 
{
  "view": enum (MerchantView)
}
فیلدها
view

enum ( MerchantView )

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

مرچنت ویو

سطح جزئیاتی که باید برای هر فروشنده برگردانده شود.

انوم‌ها
MERCHANT_VIEW_UNSPECIFIED مقدار پیش‌فرض / تنظیم نشده. API به طور پیش‌فرض به نمای BASIC خواهد رفت.
MERCHANT_VIEW_BASIC اطلاعات اولیه در مورد فروشنده را وارد کنید.
MERCHANT_VIEW_FULL تمام جزئیات مربوط به فروشنده را ذکر کنید.

طرحواره خروجی

پیام پاسخ برای فهرست کردن بازرگانان.

پاسخ ListMerchants

نمایش JSON 
{
  "merchants": [
    {
      object (Merchant)
    }
  ]
}
فیلدها
merchants[]

object ( Merchant )

فروشگاه‌هایی که کاربر به آنها دسترسی دارد.

تاجر

نمایش JSON 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
فیلدها
merchantId

string

فقط خروجی. شناسه منحصر به فرد فروشنده.

displayName

string

الزامی. نام نمایشی فروشنده.

regionCode

string

الزامی. کد منطقه محل کسب و کار فروشنده. قالب آن کدهای منطقه یونیکد CLDR است، مثلاً "US". هند ("IN") پشتیبانی نمی‌شود.

mcc

enum ( Mcc )

الزامی. کد دسته‌بندی فروشگاه (MCC) فروشگاه.

corporateWebsiteUrl

string

الزامی. وب‌سایت شرکتیِ فروشنده.

customerSupportWebsiteUrl

string

الزامی. وب‌سایت پشتیبانی مشتری فروشنده.

customerSupportEmail

string

الزامی. ایمیل پشتیبانی مشتری فروشنده.

customerSupportPhone

string

الزامی. شماره تلفن پشتیبانی مشتری فروشنده.

state

enum ( State )

فقط خروجی. وضعیت تاجر.

مک سی سی

کد دسته‌بندی تاجر (MCC) یک تاجر.

انوم‌ها
OTHERS دیگران
MISC_FOOD_STORES فروشگاه‌های مواد غذایی متفرقه - فروشگاه‌های رفاه و بازارهای تخصصی
MISC_APPAREL فروشگاه‌های پوشاک و لوازم جانبی متفرقه
ARTISTS_SUPPLY فروشگاه‌های لوازم هنری و صنایع دستی
AUTOMOTIVE_PARTS فروشگاه‌های قطعات خودرو و لوازم جانبی
HEALTH_AND_BEAUTY فروشگاه سلامت و زیبایی
BOOKS_PERIODICALS کتاب‌ها، نشریات و روزنامه‌ها
CAMERA_STORES فروشگاه‌های لوازم دوربین و عکاسی
COMPUTERS_EQUIPMENT کامپیوتر، تجهیزات جانبی کامپیوتر، نرم‌افزار
COMPUTER_SOFTWARE فروشگاه‌های نرم‌افزار کامپیوتر
ELECTRONICS_SALES فروش لوازم الکترونیکی
GIFT_SHOPS فروشگاه‌های کارت، هدایا، اجناس نو و سوغاتی
EATING_PLACES رستوران‌ها و غذاخوری‌ها
MISC_GENERAL_MERCHANDISE کالاهای عمومی متفرقه
HOME_SUPPLY فروشگاه‌های لوازم خانگی
COMPUTER_NETWORK_SERVICES خدمات شبکه کامپیوتری
DIGITAL_GOODS_MEDIA کالاهای دیجیتال: کتاب، فیلم، موسیقی
DIGITAL_GOODS_GAMES کالاهای دیجیتال: بازی‌ها
DIGITAL_GOODS_APPLICATIONS کالاهای دیجیتال: برنامه‌ها (به جز بازی‌ها)
POLITICAL_ORGANIZATIONS سازمان‌های سیاسی
CHARITABLE_ORGANIZATIONS سازمان‌های خیریه و خدمات اجتماعی
DRUG_STORES داروخانه‌ها و فروشگاه‌های مواد مخدر
REAL_ESTATE_RENTALS مشاوران املاک و مدیران - اجاره‌ها
MISC_PERSONAL_SERVICES خدمات شخصی متفرقه، که در جای دیگری طبقه‌بندی نشده‌اند
SPORTING_GOODS فروشگاه‌های لوازم ورزشی
STATIONERY_OFFICE_SUPPLIES لوازم التحریر، لوازم اداری، کاغذ چاپ و تحریر
THEATRICAL_TICKET_AGENCIES آژانس‌های فروش بلیط تئاتر
TIMESHARES مالکیت‌های زمانی
TOURIST_ATTRACTIONS جاذبه‌های گردشگری و نمایشگاه‌ها
HOBBY_TOY_GAME_SHOPS فروشگاه‌های سرگرمی، اسباب‌بازی و بازی
PET_SHOPS فروشگاه‌های حیوانات خانگی، فروشگاه‌های غذا و لوازم حیوانات خانگی
OTHER_LODGING سایر اقامتگاه‌ها - هتل‌ها، متل‌ها، استراحتگاه‌ها
TELECOMMUNICATION_SERVICES خدمات مخابراتی
TRANSPORTATION_SERVICES خدمات حمل و نقل
OTHER_AIRLINES سایر خطوط هوایی
TRAVEL_AGENCIES آژانس‌های مسافرتی و برگزارکنندگان تور
GOVERNMENT_OWNED_LOTTERIES_US لاتاری‌های دولتی (فقط منطقه ایالات متحده)
GOVERNMENT_LICENSED_CASINOS_US کازینوهای آنلاین دارای مجوز دولتی (قمار آنلاین) (فقط منطقه ایالات متحده)
BETTING شرط‌بندی (شامل بلیط بخت‌آزمایی، ژتون‌های بازی‌های کازینو، شرط‌بندی‌های خارج از مسیر و شرط‌بندی‌ها)
GOVERNMENT_OWNED_LOTTERIES_NON_US لاتاری‌های دولتی (منطقه غیر آمریکایی)

ایالت

وضعیت یک تاجر.

انوم‌ها
STATE_UNSPECIFIED ایالت تاجر مشخص نشده است.
VERIFIED فروشنده بررسی و تایید شده است.
IN_REVIEW ویرایش پروفایل فروشنده در دست بررسی است.
REJECTED ویرایش پروفایل فروشنده رد می‌شود.
INCOMPLETE_SIGNUP مشخصات فروشنده ناقص است.
SANCTIONS_HIT وضعیت تاجران با تحریم‌ها مواجه می‌شود.
READY_FOR_REVIEW مشخصات فروشنده تکمیل و آماده بررسی است.
DISABLED نمایه فروشنده غیرفعال/غیرفعال است.

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

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

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

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

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