MCP Tools Reference: paydeveloper.googleapis.com

Công cụ: query_merchant_performance

Truy xuất dữ liệu hiệu suất tổng hợp cấp cao và các chỉ số sau khi tích hợp cho một hồ sơ doanh nghiệp của người bán cụ thể.

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

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_performance",
    "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 dữ liệu hiệu suất của người bán.

QueryMerchantPerformanceRequest

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

string

Bắt buộc. Mã nhận dạng duy nhất của người bán mà dữ liệu hiệu suất đang được yêu cầu.
timeRange

enum (TimeRange)

Không bắt buộc. Phạm vi thời gian của dữ liệu hiệu suất.

Giản đồ đầu ra

Thông báo phản hồi để truy vấn hiệu suất của người bán.

QueryMerchantPerformanceResponse

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

object (MerchantPerformanceMetric)

Dữ liệu hiệu suất của người bán.

MerchantPerformanceMetric

Biểu diễn dưới dạng JSON 
{
  "metricDetail": {
    object (MetricDetail)
  },
  "hourlyMetricValues": [
    {
      object (HourlyMetricValue)
    }
  ]
}
Trường
metricDetail

object (MetricDetail)

Chỉ có đầu ra. Thông tin chi tiết về chỉ số.
hourlyMetricValues[]

object (HourlyMetricValue)

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

MetricDetail

Biểu diễn dưới dạng JSON 
{
  "metricType": enum (MetricType),
  "additionalDetails": {
    string: string,
    ...
  }
}
Trường
metricType

enum (MetricType)

Loại chỉ số.
additionalDetails

map (key: string, value: string)

Các cặp khoá-giá trị cho mọi thông tin chi tiết bổ sung về chỉ số, ví dụ: "gateway": "stripe". Để biết thông tin chi tiết, hãy xem

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

AdditionalDetailsEntry

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

string
value

string

HourlyMetricValue

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

string (Timestamp format)

Dấu thời gian của giá trị chỉ số được làm tròn đến đầu giờ gần nhất.

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".
value

number

Giá trị chỉ số thực tế. Đối với tỷ lệ chuyển đổi, giá trị nằm trong phạm vi [0, 1]. Đối với các chỉ số khác, giá trị là số nguyên không âm.

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 ý mang tính phá hoại: ❌ | Gợi ý về tính lũy đẳng: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý về thế giới mở: ❌