MCP Tools Reference: paydeveloper.googleapis.com

כלי: query_merchant_performance

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

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

בקשת 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)

אופציונלי. טווח הזמן של נתוני הביצועים.

סכימת פלט

הודעת תגובה לשאילתות לגבי ביצועי מוֹכרים.

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)

צמדי מפתח/ערך לפרטים נוספים על המדד, למשל: gateway: 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 מאז ראשית זמן יוניקס (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, כולל.

הערות על כלי

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