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

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

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

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

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

تلميح مدمّر: ❌ | تلميح متكرّر: ✅ | تلميح للقراءة فقط: ✅ | تلميح لعالم مفتوح: ❌