MCP Tools Reference: paydeveloper.googleapis.com

الأداة: query_merchant_error_metrics

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

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة query_merchant_error_metrics 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_error_metrics",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

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

QueryMerchantErrorMetricsRequest

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

string

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

enum (TimeRange)

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

مخطط النتائج

رسالة الردّ لطلب مقاييس أخطاء التاجر

QueryMerchantErrorMetricsResponse

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

object (MerchantErrorMetric)

بيانات مقاييس الأخطاء الخاصة بالتاجر

MerchantErrorMetric

تمثيل JSON 
{
  "errorDetail": {
    object (ErrorDetail)
  },
  "hourlyErrorCounts": [
    {
      object (HourlyErrorCount)
    }
  ]
}
الحقول
errorDetail

object (ErrorDetail)

النتائج فقط. تفاصيل الخطأ
hourlyErrorCounts[]

object (HourlyErrorCount)

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

ErrorDetail

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

string

رمز الخطأ، مثل "OR_BIBED_07"
errorMessage

string

رسالة وصفية فقط، بدون بيانات المستخدم أو عمليات تتبُّع تسلسل استدعاء الدوال البرمجية الداخلية

HourlyErrorCount

تمثيل JSON 
{
  "hourlyTimestamp": string,
  "count": integer
}
الحقول
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".
count

integer

عدد الأخطاء خلال هذه الساعة

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

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