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

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 }'

طلب 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)` اختياريّ. تحدّد هذه السمة مستوى التفاصيل التي سيتم عرضها لكل تاجر.

view

enum (MerchantView)

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

MerchantView

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

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

مخطط النتائج

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

ListMerchantsResponse

تمثيل JSON
{ "merchants": [ { object (`Merchant`) } ] }

الحقول

الحقول
`merchants[]`	`object (Merchant)` التجّار الذين يمكن للمستخدم الوصول إليهم

merchants[]

object (Merchant)

التجّار الذين يمكن للمستخدم الوصول إليهم

التاجر

تمثيل JSON

تمثيل 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,
  "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: ❌

MCP Tools Reference: paydeveloper.googleapis.com تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الأداة: list_merchants