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 các 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.

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 của lỗi đó, đượ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ỗ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 của thời gian UTC kể từ thời gian bắt đầu của hệ thống Unix 1970-01-01T00:00:00Z. Phải nằm trong khoảng từ -62135596800 đến 253402300799 (tương ứng với 0001-01-01T00:00:00Z đến 9999-12-31T23:59:59Z).
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. 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 công cụ

Gợi ý gây hại: ❌ | Gợi ý về tính chất luỹ đẳng: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý về thế giới mở: ❌