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)

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

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
CONVERSION_RATE معدّل الإحالات الناجحة لزر الدفع، ويتم تعريفه على أنّه نسبة عدد عمليات التسهيل الناجحة التي توفّرها واجهة برمجة تطبيقات GPay إلى عدد النقرات على زر واجهة برمجة تطبيقات GPay

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

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