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)

אופציונלי. טווח הזמן של נתוני מדדי השגיאות.

TimeRange

טווח הזמן של הנתונים. המזהה הבא: 4

טיפוסים בני מנייה (enum)
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 מאז ראשית זמן יוניקס (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, כולל.

הערות על כלים

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