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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

판매자 실적 데이터를 쿼리하기 위한 요청 메시지입니다.

QueryMerchantPerformanceRequest

JSON 표현 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
필드
merchantId

string

필수 항목입니다. 실적 데이터가 요청되는 판매자의 고유 식별자입니다.
timeRange

enum (TimeRange)

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

TimeRange

데이터의 기간입니다. 다음 ID: 4

열거형
TIME_RANGE_UNSPECIFIED 지정되지 않은 기간입니다.
TIME_RANGE_PAST_DAY 지난날, 어제입니다.
TIME_RANGE_PAST_THREE_DAYS 지난 3일(오늘 제외)입니다.
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)

측정항목에 관한 추가 세부정보의 키-값 쌍입니다(예: '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(포함)이어야 합니다.

MetricType

측정되는 측정항목의 유형입니다.

열거형
METRIC_TYPE_UNSPECIFIED 지정되지 않은 측정항목 유형입니다.
FACILITATION_COUNT 성공한 GPay API 지원 수입니다.
VISIT_COUNT GPay API 버튼 클릭수입니다.
CONVERSION_RATE 결제 버튼의 전환율로, 성공한 GPay API 지원 수와 GPay API 버튼 클릭수의 비율로 정의됩니다.

도구 주석

도구 주석은 지정된 도구의 기본 위험을 설명하기 위해 MCP 클라이언트로 전송됩니다. 대부분의 클라이언트는 이러한 힌트를 신뢰할 수 없는 것으로 취급하지만, 확인 메시지가 사용자에게 전송될 시점을 결정하는 데 사용할 수 있습니다.

제목 문자열과 함께 다음 불리언 힌트가 다음과 같이 정의됩니다.

  • readOnlyHint: true이면 도구가 환경을 수정하지 않습니다. 기본값: false.
  • destructiveHint: true이면 도구가 파괴적인 작업을 실행할 수 있습니다. false이면 도구가 추가 작업만 실행할 수 있습니다. 기본값: true.
  • idempotentHint: true이면 동일한 인수로 도구를 반복적으로 호출해도 환경에 추가적인 영향을 미치지 않습니다. 기본값: false.
  • openWorldHint: true이면 도구가 외부 엔티티의 '오픈 월드'와 상호작용할 수 있습니다. false이면 도구가 내부 엔티티와만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

파괴적 힌트: ❌ | 멱등 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌