MCP Tools Reference: paydeveloper.googleapis.com

الأداة: query_merchant_performance

تستردّ هذه الطريقة بيانات الأداء المجمّعة العالية المستوى ومقاييس ما بعد التكامل لملف نشاط تجاري محدّد خاص بتاجر.

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

مخطط الإدخال

رسالة الطلب للاستعلام عن بيانات أداء التاجر

QueryMerchantPerformanceRequest

تمثيل JSON 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
الحقول
merchantId

string

الحقل مطلوب. المعرّف الفريد للتاجر الذي يتم طلب بيانات الأداء له.
timeRange

enum (TimeRange)

اختياريّ. النطاق الزمني لبيانات الأداء

TimeRange

النطاق الزمني للبيانات رقم التعريف التالي: 4

عمليات التعداد
TIME_RANGE_UNSPECIFIED نطاق زمني غير محدّد
TIME_RANGE_PAST_DAY اليوم السابق، أي أمس
TIME_RANGE_PAST_THREE_DAYS الأيام الثلاثة الماضية، باستثناء اليوم الحالي
TIME_RANGE_PAST_WEEK الأسبوع الماضي، باستثناء اليوم الحالي

مخطط النتائج

رسالة الردّ على طلب البحث عن أداء التاجر

QueryMerchantPerformanceResponse

تمثيل JSON 
{
  "merchantPerformanceMetrics": [
    {
      object (MerchantPerformanceMetric)
    }
  ]
}
الحقول
merchantPerformanceMetrics[]

object (MerchantPerformanceMetric)

بيانات أداء التاجر

MerchantPerformanceMetric

تمثيل JSON 
{
  "metricDetail": {
    object (MetricDetail)
  },
  "hourlyMetricValues": [
    {
      object (HourlyMetricValue)
    }
  ]
}
الحقول
metricDetail

object (MetricDetail)

النتائج فقط. تفاصيل المقياس
hourlyMetricValues[]

object (HourlyMetricValue)

النتائج فقط. قائمة بقيمة المقياس وطابعه الزمني، ويتم تقريبه إلى أقرب ساعة.

MetricDetail

تمثيل JSON 
{
  "metricType": enum (MetricType),
  "additionalDetails": {
    string: string,
    ...
  }
}
الحقول
metricType

enum (MetricType)

نوع المقياس.
additionalDetails

map (key: string, value: string)

أزواج المفتاح/القيمة لأي تفاصيل إضافية حول المقياس، مثل "البوابة": "stripe". للحصول على التفاصيل، يُرجى الاطّلاع على

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

AdditionalDetailsEntry

تمثيل JSON 
{
  "key": string,
  "value": string
}
الحقول
key

string
value

string

HourlyMetricValue

تمثيل JSON 
{
  "hourlyTimestamp": string,
  "value": number
}
الحقول
hourlyTimestamp

string (Timestamp format)

الطابع الزمني لقيمة المقياس، ويتم تقريبه إلى أقرب ساعة.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
value

number

قيمة المقياس الفعلية. بالنسبة إلى معدّل الإحالات الناجحة، تكون القيمة في النطاق [0, 1]. بالنسبة إلى المقاييس الأخرى، يجب أن تكون القيمة عددًا صحيحًا غير سالب.

الطابع الزمني

تمثيل JSON 
{
  "seconds": string,
  "nanos": integer
}
الحقول
seconds

string (int64 format)

تمثّل هذه السمة عدد ثواني التوقيت العالمي المنسق (UTC) المنقضية منذ بداية حقبة يونكس 1970-01-01T00:00:00Z. يجب أن تتراوح القيمة بين ‎-62135596800 و253402300799، بما في ذلك طرفي النطاق (وهو ما يتوافق مع النطاق من 0001-01-01T00:00:00Z إلى 9999-12-31T23:59:59Z).
nanos

integer

تشير هذه السمة إلى أجزاء الثانية غير السالبة بدقة النانو ثانية هذا الحقل هو جزء من المدة بوحدة النانو ثانية، وليس بديلاً عن الثواني. يجب أن تتضمّن قيم الثواني السالبة مع الكسور قيمًا غير سالبة للنانو ثانية يتم احتسابها للأمام في الوقت. يجب أن تتراوح القيمة بين 0 و999,999,999، بما في ذلك طرفي النطاق.

MetricType

تمثّل هذه السمة نوع المقياس الذي يتم قياسه.

عمليات التعداد
METRIC_TYPE_UNSPECIFIED نوع مقياس غير محدَّد
FACILITATION_COUNT عدد عمليات التسهيل الناجحة التي تمت من خلال واجهة برمجة تطبيقات GPay
VISIT_COUNT عدد النقرات على زر GPay API
CONVERSION_RATE معدّل الإحالات الناجحة لزر الدفع، ويتم تعريفه على أنّه نسبة عدد عمليات التسهيل الناجحة التي توفّرها واجهة برمجة تطبيقات GPay إلى عدد النقرات على زر واجهة برمجة تطبيقات GPay

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

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

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

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

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