MCP Tools Reference: paydeveloper.googleapis.com

ابزار: update_merchant

فیلدهای خاص یک فروشنده موجود را به‌روزرسانی می‌کند. فیلدهای پشتیبانی‌شده شامل نام نمایشی، mcc، آدرس وب‌سایت شرکتی، آدرس وب‌سایت مشتری، ایمیل پشتیبانی مشتری و شماره تلفن پشتیبانی مشتری هستند.

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

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

درخواست پیام برای UpdateMerchant.

درخواست به‌روزرسانینمای فروشنده

نمایش JSON 
{
  "merchantId": string,

  // Union field _display_name can be only one of the following:
  "displayName": string
  // End of list of possible types for union field _display_name.

  // Union field _mcc can be only one of the following:
  "mcc": enum (Mcc)
  // End of list of possible types for union field _mcc.

  // Union field _corporate_website_url can be only one of the following:
  "corporateWebsiteUrl": string
  // End of list of possible types for union field _corporate_website_url.

  // Union field _customer_support_website_url can be only one of the following:
  "customerSupportWebsiteUrl": string
  // End of list of possible types for union field _customer_support_website_url.

  // Union field _customer_support_email can be only one of the following:
  "customerSupportEmail": string
  // End of list of possible types for union field _customer_support_email.

  // Union field _customer_support_phone can be only one of the following:
  "customerSupportPhone": string
  // End of list of possible types for union field _customer_support_phone.
}
فیلدها
merchantId

string

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

فیلد متحد _display_name .

_display_name فقط می‌تواند یکی از موارد زیر باشد:

displayName

string

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

میدان یونیون _mcc .

_mcc فقط می‌تواند یکی از موارد زیر باشد:

mcc

enum ( Mcc )

کد دسته بندی فروشنده (MCC) مربوط به فروشنده.

فیلد اتحادیه _corporate_website_url .

_corporate_website_url فقط می‌تواند یکی از موارد زیر باشد:

corporateWebsiteUrl

string

وب‌سایت شرکتیِ تاجر.

فیلد اتحادیه _customer_support_website_url .

_customer_support_website_url فقط می‌تواند یکی از موارد زیر باشد:

customerSupportWebsiteUrl

string

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

فیلد اتحادیه _customer_support_email .

_customer_support_email فقط می‌تواند یکی از موارد زیر باشد:

customerSupportEmail

string

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

فیلد اتحادیه _customer_support_phone .

_customer_support_phone فقط می‌تواند یکی از موارد زیر باشد:

customerSupportPhone

string

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

مک سی سی

کد دسته‌بندی تاجر (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 لاتاری‌های دولتی (منطقه غیر آمریکایی)

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

پیام پاسخ برای UpdateMerchant.

پاسخ UpdateMerchant

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

enum ( State )

وضعیت تاجر به‌روز شده.

ایالت

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

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

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

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

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

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

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