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

Mã mẫu sau đây cho biết 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 MCP tool 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. Giá trị nhận dạng riêng biệt của người bán mà bạn đang yêu cầu dữ liệu hiệu suất.
timeRange

enum (TimeRange)

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

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 cho việc 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 khác 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ị thực tế của chỉ số. Đố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 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.

MetricType

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

Enum
METRIC_TYPE_UNSPECIFIED Loại chỉ số chưa được chỉ định.
FACILITATION_COUNT Số lần hỗ trợ thành công qua API GPay.
VISIT_COUNT Số lượt nhấp vào nút GPay API.
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ượt hỗ trợ thành công của GPay API và số lượt nhấp vào nút GPay API.

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