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ụ thể của người bán.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ query_merchant_performance 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_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. Khoảng thời gian của dữ liệu hiệu suất.

TimeRange

Khoảng thời gian của dữ liệu. Mã tiếp theo: 4

Enum
TIME_RANGE_UNSPECIFIED Khoảng thời gian không xác định.
TIME_RANGE_PAST_DAY Ngày trước, tức là hôm qua.
TIME_RANGE_PAST_THREE_DAYS Ba ngày trước, không bao gồm 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 để 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ặ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 khoảng [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 đ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 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.

MetricType

Loại chỉ số đang được đo lường.

Enum
METRIC_TYPE_UNSPECIFIED Loại chỉ số không xác định.
FACILITATION_COUNT Số lần hỗ trợ thành công bằng API GPay.
VISIT_COUNT Số lượt nhấp vào nút API GPay.
CONVERSION_RATE Tỷ lệ chuyển đổi của nút thanh toán, được xác định là tỷ lệ giữa số lần hỗ trợ thành công bằng API GPay và số lượt nhấp vào nút API GPay.

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ở: ❌