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)

선택사항입니다. 실적 데이터의 기간입니다.

출력 스키마

판매자 실적을 쿼리하기 위한 응답 메시지입니다.

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)

가장 가까운 정시로 반올림된 측정항목 값의 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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)

Unix epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. -62135596800과 253402300799 (0001-01-01T00:00:00Z~9999-12-31T23:59:59Z에 해당) 사이여야 합니다.
nanos

integer

나노초 단위의 음수가 아닌 초수입니다. 이 필드는 초의 대안이 아니라 기간의 나노초 부분입니다. 음수의 초수 값에는 시간에 반영되는 음수가 아닌 나노초 값이 있어야 합니다. 0~999,999,999 사이여야 합니다.

도구 주석

파괴적 힌트: ❌ | 멱등성 힌트: ✅ | 읽기 전용 힌트: ✅ | 개방형 세계 힌트: ❌