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)

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

TimeRange

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

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

مخطط الناتج

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

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: ❌