MCP Tools Reference: paydeveloper.googleapis.com

Công cụ: query_merchant_error_metrics

Truy xuất các chỉ số lỗi chi tiết cho một trang doanh nghiệp cụ thể của người bán. Công cụ này cung cấp thông tin chi tiết về các lỗi, cho phép nhà phát triển xác định và giải quyết vấn đề.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ query_merchant_error_metrics MCP.

Yêu cầu 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
}'

Giản đồ đầu vào

Thông báo yêu cầu để truy vấn các chỉ số lỗi của người bán.

QueryMerchantErrorMetricsRequest

Biểu diễn dưới dạng JSON 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
Trường
merchantId

string

Bắt buộc. Giá trị nhận dạng riêng biệt của người bán mà bạn đang yêu cầu chỉ số lỗi.
timeRange

enum (TimeRange)

Không bắt buộc. Phạm vi thời gian của dữ liệu chỉ số lỗi.

TimeRange

Phạm vi thời gian của dữ liệu. Mã tiếp theo: 4

Enum
TIME_RANGE_UNSPECIFIED Phạm vi thời gian không xác định.
TIME_RANGE_PAST_DAY Ngày qua, tức là hôm qua.
TIME_RANGE_PAST_THREE_DAYS Ba ngày qua, không bao gồm ngày hiện tại.
TIME_RANGE_PAST_WEEK Tuần qua, không bao gồm ngày hiện tại.

Giản đồ đầu ra

Thông báo phản hồi để truy vấn các chỉ số lỗi của người bán.

QueryMerchantErrorMetricsResponse

Biểu diễn dưới dạng JSON 
{
  "errorMetrics": [
    {
      object (MerchantErrorMetric)
    }
  ]
}
Trường
errorMetrics[]

object (MerchantErrorMetric)

Dữ liệu chỉ số lỗi của người bán.

MerchantErrorMetric

Biểu diễn dưới dạng JSON 
{
  "errorDetail": {
    object (ErrorDetail)
  },
  "hourlyErrorCounts": [
    {
      object (HourlyErrorCount)
    }
  ]
}
Trường
errorDetail

object (ErrorDetail)

Chỉ có đầu ra. Thông tin chi tiết về lỗi.
hourlyErrorCounts[]

object (HourlyErrorCount)

Chỉ có đầu ra. Danh sách số lượng lỗi và dấu thời gian tương ứng, được làm tròn đến đầu giờ gần nhất.

ErrorDetail

Biểu diễn dưới dạng JSON 
{
  "errorCode": string,
  "errorMessage": string
}
Trường
errorCode

string

Mã lỗi, ví dụ: "OR_BIBED_07".
errorMessage

string

Chỉ có thông báo mô tả, không có dữ liệu người dùng cũng như dấu vết ngăn xếp nội bộ.

HourlyErrorCount

Biểu diễn dưới dạng JSON 
{
  "hourlyTimestamp": string,
  "count": integer
}
Trường
hourlyTimestamp

string (Timestamp format)

Dấu thời gian biểu thị thời điểm bắt đầu giờ.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
count

integer

Số lượng lỗi trong giờ này.

Dấu thời gian

Biểu diễn dưới dạng JSON 
{
  "seconds": string,
  "nanos": integer
}
Trường
seconds

string (int64 format)

Biểu thị số giây theo giờ UTC kể từ thời điểm bắt đầu của hệ thống Unix là 00:00:00 giờ UTC ngày 01/01/1970. Phải nằm trong khoảng từ -62135596800 đến 253402300799 (tương ứng với khoảng thời gian từ 00:00:00 giờ UTC ngày 01/01/0001 đến 23:59:59 giờ UTC ngày 31/12/9999).
nanos

integer

Phân số không âm của một giây ở độ phân giải nano giây. Trường này là phần nano giây của khoảng thời gian, không phải là một lựa chọn thay thế cho giây. Các giá trị giây âm có phân số vẫn phải có giá trị nano giây không âm để đếm tiến theo thời gian. Phải nằm trong khoảng từ 0 đến 999.999.999.

Chú thích về công cụ

Gợi ý về tính chất phá huỷ: ❌ | Gợi ý về tính chất luỹ đẳng: ✅ | Gợi ý về tính chất chỉ đọc: ✅ | Gợi ý về tính chất thế giới mở: ❌