MCP Tools Reference: paydeveloper.googleapis.com

เครื่องมือ: query_merchant_performance

ดึงข้อมูลประสิทธิภาพระดับสูงที่รวบรวมไว้และเมตริกหลังการผสานรวมสำหรับโปรไฟล์ธุรกิจของผู้ขายที่เฉพาะเจาะจง

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ query_merchant_performance ของ MCP

คำขอ 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
}'

สคีมาอินพุต

ข้อความคำขอสำหรับการค้นหาข้อมูลประสิทธิภาพของผู้ขาย

QueryMerchantPerformanceRequest

การแสดง JSON 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
ช่อง
merchantId

string

ต้องระบุ ตัวระบุที่ไม่ซ้ำกันของผู้ขายที่ขอข้อมูลประสิทธิภาพ
timeRange

enum (TimeRange)

ไม่บังคับ ช่วงเวลาของข้อมูลประสิทธิภาพ

TimeRange

ช่วงเวลาของข้อมูล รหัสถัดไป: 4

Enum
TIME_RANGE_UNSPECIFIED ช่วงเวลาที่ไม่ได้ระบุ
TIME_RANGE_PAST_DAY วันก่อนหน้า หรือเมื่อวาน
TIME_RANGE_PAST_THREE_DAYS 3 วันก่อนหน้า ไม่รวมวันปัจจุบัน
TIME_RANGE_PAST_WEEK สัปดาห์ก่อนหน้า ไม่รวมวันปัจจุบัน

สคีมาเอาต์พุต

ข้อความตอบกลับสำหรับการค้นหาประสิทธิภาพของผู้ขาย

QueryMerchantPerformanceResponse

การแสดง JSON 
{
  "merchantPerformanceMetrics": [
    {
      object (MerchantPerformanceMetric)
    }
  ]
}
ช่อง
merchantPerformanceMetrics[]

object (MerchantPerformanceMetric)

ข้อมูลประสิทธิภาพของผู้ขาย

MerchantPerformanceMetric

การแสดง JSON 
{
  "metricDetail": {
    object (MetricDetail)
  },
  "hourlyMetricValues": [
    {
      object (HourlyMetricValue)
    }
  ]
}
ช่อง
metricDetail

object (MetricDetail)

เอาต์พุตเท่านั้น รายละเอียดของเมตริก
hourlyMetricValues[]

object (HourlyMetricValue)

เอาต์พุตเท่านั้น รายการค่าเมตริกและการประทับเวลาที่ปัดเศษเป็นต้นชั่วโมงที่ใกล้ที่สุด

MetricDetail

การแสดง JSON 
{
  "metricType": enum (MetricType),
  "additionalDetails": {
    string: string,
    ...
  }
}
ช่อง
metricType

enum (MetricType)

ประเภทของเมตริก
additionalDetails

map (key: string, value: string)

คู่คีย์-ค่าสำหรับรายละเอียดเพิ่มเติมเกี่ยวกับเมตริก เช่น "gateway": "stripe" ดูรายละเอียดได้ที่

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่าง: { "name": "wrench", "mass": "1.3kg", "count": "3" }

AdditionalDetailsEntry

การแสดง JSON 
{
  "key": string,
  "value": string
}
ช่อง
key

string
value

string

HourlyMetricValue

การแสดง JSON 
{
  "hourlyTimestamp": string,
  "value": number
}
ช่อง
hourlyTimestamp

string (Timestamp format)

การประทับเวลาของค่าเมตริกที่ปัดเศษเป็นต้นชั่วโมงที่ใกล้ที่สุด

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
value

number

ค่าเมตริกจริง สำหรับอัตรา Conversion ค่าจะอยู่ในช่วง [0, 1] สำหรับเมตริกอื่นๆ ค่าจะเป็นจำนวนเต็มที่ไม่ติดลบ

การประทับเวลา

การแสดง JSON 
{
  "seconds": string,
  "nanos": integer
}
ช่อง
seconds

string (int64 format)

แสดงถึงวินาทีของเวลา UTC ตั้งแต่ Epoch ของ Unix 1970-01-01T00:00:00Z ต้องอยู่ระหว่าง -62135596800 ถึง 253402300799 (รวม) ซึ่งสอดคล้องกับ 0001-01-01T00:00:00Z ถึง 9999-12-31T23:59:59Z
nanos

integer

เศษส่วนที่ไม่ติดลบของวินาทีที่ความละเอียดระดับนาโนวินาที ช่องนี้เป็นส่วนนาโนวินาทีของระยะเวลา ไม่ใช่ทางเลือกแทนวินาที ค่าวินาทีที่เป็นค่าลบที่มีเศษส่วนยังคงต้องมีค่านาโนวินาทีที่ไม่ติดลบซึ่งนับไปข้างหน้าตามเวลา ต้องอยู่ระหว่าง 0 ถึง 999,999,999 (รวม)

MetricType

ประเภทของเมตริกที่วัด

Enum
METRIC_TYPE_UNSPECIFIED ประเภทเมตริกที่ไม่ได้ระบุ
FACILITATION_COUNT จำนวนการอำนวยความสะดวกของ GPay API ที่สำเร็จ
VISIT_COUNT จำนวนการคลิกปุ่ม GPay API
CONVERSION_RATE อัตรา Conversion ของปุ่มชำระเงิน ซึ่งกำหนดเป็นอัตราส่วนของจำนวนการอำนวยความสะดวกของ GPay API ที่สำเร็จต่อจำนวนการคลิกปุ่ม GPay API

คำอธิบายประกอบของเครื่องมือ

คำแนะนำที่อาจทำให้เกิดการเปลี่ยนแปลง: ❌ | คำแนะนำที่อาจทำให้เกิดการเปลี่ยนแปลงซ้ำได้: ✅ | คำแนะนำแบบอ่านอย่างเดียว: ✅ | คำแนะนำแบบเปิด: ❌