MCP Tools Reference: paydeveloper.googleapis.com

الأداة: list_merchants

تعرض هذه الطريقة قائمة شاملة بجميع التجّار على Google Pay المرتبطين بالحساب الذي تمّت المصادقة عليه. استنادًا إلى دور المستخدم في حساب التاجر، يمكن للمشرفين الاطّلاع على معلومات التاجر التفصيلية الكاملة، بينما يمكن للمطوّرين الاطّلاع على معلومات التاجر الأساسية فقط.

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

مخطط الإدخال

رسالة طلب بيانات التجّار

ListMerchantsRequest

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

enum (MerchantView)

اختياريّ. تحدّد هذه السمة مستوى التفاصيل التي سيتم عرضها لكل تاجر.

MerchantView

مستوى التفاصيل التي سيتم عرضها لكل تاجر.

عمليات التعداد
MERCHANT_VIEW_UNSPECIFIED القيمة التلقائية أو غير المضبوطة ستستخدِم واجهة برمجة التطبيقات تلقائيًا طريقة العرض BASIC.
MERCHANT_VIEW_BASIC تضمين المعلومات الأساسية عن التاجر
MERCHANT_VIEW_FULL يجب تضمين جميع التفاصيل المتعلّقة بالتاجر.

مخطط النتائج

رسالة الردّ على بيانات التجّار

ListMerchantsResponse

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

الحقل مطلوب. تمثّل هذه السمة رمز المنطقة للموقع الجغرافي الذي يقع فيه النشاط التجاري للتاجر. التنسيق هو رموز Unicode CLDR للمناطق، مثل "US". لا تتوفّر هذه الخدمة في الهند ("IN").
mcc

enum (Mcc)

الحقل مطلوب. رمز فئة التجار (MCC) الخاص بالتاجر
corporateWebsiteUrl

string

الحقل مطلوب. الموقع الإلكتروني للشركة التابعة للتاجر
customerSupportWebsiteUrl

string

الحقل مطلوب. الموقع الإلكتروني المخصّص لدعم العملاء الخاص بالتاجر
customerSupportEmail

string

الحقل مطلوب. البريد الإلكتروني الخاص بفريق دعم العملاء لدى التاجر
customerSupportPhone

string

الحقل مطلوب. رقم هاتف فريق دعم العملاء الخاص بالتاجر
state

enum (State)

النتائج فقط. حالة التاجر

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 مسابقات اليانصيب المملوكة للحكومة (خارج منطقة الولايات المتحدة)

ولاية

حالة التاجر

عمليات التعداد
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: ❌