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

مخطط الإدخال

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

QueryMerchantPerformanceRequest

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

string

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

enum (TimeRange)

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

مخطط النتائج

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

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، بما في ذلك طرفي النطاق.

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

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