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

입력 스키마

판매자 오류 측정항목을 쿼리하기 위한 요청 메시지입니다.

QueryMerchantErrorMetricsRequest

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 지난주(오늘 제외)입니다.

출력 스키마

판매자 오류 측정항목을 쿼리하기 위한 응답 메시지입니다.

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(포함)이어야 합니다.

도구 주석

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

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

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

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