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ã mẫu sau đây cho biết 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 MCP tool 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. Mã định danh duy nhất của nhà cung cấp mà bạn đang yêu cầu số liệu lỗi.
timeRange

enum (TimeRange)

Không bắt buộc. Khoảng thời gian của dữ liệu số liệu lỗi.

TimeRange

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

Enum
TIME_RANGE_UNSPECIFIED Khoảng thời gian chưa được chỉ định.
TIME_RANGE_PAST_DAY Ngày hôm qua.
TIME_RANGE_PAST_THREE_DAYS Ba ngày qua, không tính ngày hiện tại.
TIME_RANGE_PAST_WEEK Tuần trước, không bao gồm ngày hiện tại.

Giản đồ đầu ra

Thông báo phản hồi khi truy vấn số liệu 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 của 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 theo giờ UTC kể từ thời gian 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 thời lượng, chứ 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 thời gian. Phải nằm trong khoảng từ 0 đến 999.999.999.

Chú giải công cụ

Chú thích công cụ được gửi đến các ứng dụng MCP để mô tả rủi ro cơ bản của một công cụ nhất định. Hầu hết các ứng dụng đều coi những gợi ý này là không đáng tin cậy, nhưng bạn có thể dùng chúng để quyết định thời điểm gửi lời nhắc xác nhận cho người dùng.

Cùng với chuỗi tiêu đề, các gợi ý boolean sau đây được xác định như sau:

  • readOnlyHint: Nếu đúng, công cụ sẽ không sửa đổi môi trường của công cụ. Mặc định: false.
  • destructiveHint: Nếu đúng, công cụ có thể thực hiện các hành động phá huỷ. Nếu là false, thì công cụ chỉ có thể thực hiện các thao tác bổ sung. Mặc định: true.
  • idempotentHint: Nếu đúng, thì việc gọi công cụ nhiều lần với cùng một đối số sẽ không có thêm tác động nào đến môi trường của công cụ. Mặc định: false.
  • openWorldHint: Nếu đúng, công cụ này có thể tương tác với "thế giới mở" của các thực thể bên ngoài. Nếu là false, thì công cụ chỉ có thể tương tác với các thực thể nội bộ. Ví dụ: một công cụ tìm kiếm trên web sẽ là thế giới mở, trong khi một công cụ bộ nhớ sẽ không phải là thế giới mở.

Gợi ý phá huỷ: ❌ | Gợi ý bất biến: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý thế giới mở: ❌