MCP Tools Reference: paydeveloper.googleapis.com

כלי: query_merchant_error_metrics

מאחזר מדדי שגיאות מפורטים של פרופיל עסק ספציפי של מוֹכר. הכלי הזה מספק פירוט מדויק של השגיאות, ומאפשר למפתחים לאתר ולפתור בעיות.

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ query_merchant_error_metrics.

בקשת 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 מאז ראשית זמן יוניקס (Unix epoch) ב-1970-01-01T00:00:00Z. הערך חייב להיות בין ‎-62135596800 ל-253402300799, כולל (שמתאים לטווח 0001-01-01T00:00:00Z עד 9999-12-31T23:59:59Z).
nanos

integer

שברים לא שליליים של שנייה ברזולוציית ננו-שנייה. השדה הזה מייצג את החלק של משך הזמן בננו-שניות, ולא מהווה חלופה לשניות. ערכי שניות שליליים עם שברים עדיין צריכים לכלול ערכי ננו-שניות לא שליליים שסופרים קדימה בזמן. הערך חייב להיות בין 0 ל-999,999,999, כולל.

הערות על כלי

רמז הרסני: ❌ | רמז אידמפוטנטי: ✅ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌