MCP Tools Reference: paydeveloper.googleapis.com

도구: query_merchant_error_metrics

특정 판매자 비즈니스 프로필의 세부 오류 측정항목을 가져옵니다. 이 도구는 오류를 세부적으로 분류하여 개발자가 문제를 정확히 파악하고 해결할 수 있도록 지원합니다.

다음 샘플에서는 curl을 사용하여 query_merchant_error_metrics 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_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)

시간의 시작을 나타내는 타임스탬프입니다.

생성된 출력은 항상 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"입니다.
count

integer

이 시간 내의 오류 수입니다.

타임스탬프

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 사이의 값이어야 합니다.

도구 주석

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