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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

رسالة الطلب لعرض قائمة بالتجار

مخطط الرد

رسالة الرد لعرض قائمة بالتجار

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 الملف التجاري للتاجر غير مفعّل أو غير نشط.

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

تلميح بشأن الإجراءات المدمّرة: ❌ | تلميح بشأن الإجراءات التي لا تؤثر في البيانات: ✅ | تلميح بشأن الإجراءات التي لا يمكنها تعديل البيانات: ✅ | تلميح بشأن الإجراءات التي يمكنها تعديل البيانات: ❌