MCP Tools Reference: paydeveloper.googleapis.com

الأداة: update_merchant

تعديل حقول معيّنة لتاجر حالي تشمل الحقول المتوافقة display_name وmcc وcorporate_website_url وcustomer_support_website_url وcustomer_support_email وcustomer_support_phone.

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

مخطط الإدخال

رسالة الطلب الخاصة بـ UpdateMerchant

UpdateMerchantFacadeRequest

تمثيل 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

رمز فئة التجار (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

UpdateMerchantResponse

تمثيل JSON 
{
  "state": enum (State)
}
الحقول
state

enum (State)

حالة التاجر المعدَّلة

ولاية

حالة التاجر

عمليات التعداد
STATE_UNSPECIFIED لم يتم تحديد حالة التاجر.
VERIFIED تم التحقّق من التاجر والموافقة عليه.
IN_REVIEW تعديل ملف التاجر قيد المراجعة.
REJECTED تم رفض تعديل ملف التاجر.
INCOMPLETE_SIGNUP ملف التاجر غير مكتمل.
SANCTIONS_HIT ملف التاجر يخضع لعقوبات.
READY_FOR_REVIEW ملف التاجر مكتمل وجاهز للمراجعة.
DISABLED ملف التاجر غير مفعَّل أو تم إيقافه.

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

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

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

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

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