MCP Tools Reference: paydeveloper.googleapis.com

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

ดึงข้อมูลเมตริกข้อผิดพลาดโดยละเอียดสำหรับ Business Profile ของผู้ขายที่เฉพาะเจาะจง เครื่องมือนี้จะแสดงรายละเอียดข้อผิดพลาดแบบละเอียด เพื่อให้นักพัฒนาแอปสามารถระบุและแก้ไขปัญหาได้

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ query_merchant_error_metrics ของ 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_error_metrics",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

สคีมาอินพุต

ข้อความคำขอสำหรับการค้นหาเมตริกข้อผิดพลาดของผู้ขาย

QueryMerchantErrorMetricsRequest

การแสดง 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 สัปดาห์ก่อนหน้า ไม่รวมวันปัจจุบัน

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

ข้อความตอบกลับสำหรับการค้นหาเมตริกข้อผิดพลาดของผู้ขาย

QueryMerchantErrorMetricsResponse

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

object (MerchantErrorMetric)

ข้อมูลเมตริกข้อผิดพลาดของผู้ขาย

MerchantErrorMetric

การแสดง JSON 
{
  "errorDetail": {
    object (ErrorDetail)
  },
  "hourlyErrorCounts": [
    {
      object (HourlyErrorCount)
    }
  ]
}
ช่อง
errorDetail

object (ErrorDetail)

เอาต์พุตเท่านั้น รายละเอียดข้อผิดพลาด
hourlyErrorCounts[]

object (HourlyErrorCount)

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

ErrorDetail

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

string

รหัสข้อผิดพลาด เช่น "OR_BIBED_07"
errorMessage

string

ข้อความอธิบายเท่านั้น ไม่มีข้อมูลผู้ใช้หรือ Stack Trace ภายใน

HourlyErrorCount

การแสดง JSON 
{
  "hourlyTimestamp": string,
  "count": integer
}
ช่อง
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"
count

integer

จำนวนข้อผิดพลาดภายในชั่วโมงนี้

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

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

string (int64 format)

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

integer

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

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

ระบบจะส่งคำอธิบายประกอบของเครื่องมือไปยังไคลเอ็นต์ MCP เพื่ออธิบายความเสี่ยงพื้นฐานของเครื่องมือที่กำหนด ไคลเอ็นต์ส่วนใหญ่จะถือว่าคำแนะนำเหล่านี้ไม่น่าเชื่อถือ แต่สามารถใช้เพื่อตัดสินใจว่าจะส่งข้อความแจ้งการยืนยันไปยังผู้ใช้เมื่อใด

นอกเหนือจากสตริงชื่อแล้ว ระบบยังกำหนดคำแนะนำแบบบูลีนต่อไปนี้ด้วย

  • readOnlyHint: หากเป็น "จริง" เครื่องมือจะไม่แก้ไขสภาพแวดล้อม ค่าเริ่มต้น: "เท็จ"
  • destructiveHint: หากเป็น "จริง" เครื่องมือจะดำเนินการที่อาจทำให้เกิดความเสียหายได้ หากเป็น "เท็จ" เครื่องมือจะดำเนินการที่เพิ่มข้อมูลเท่านั้น ค่าเริ่มต้น: "จริง"
  • idempotentHint: หากเป็น "จริง" การเรียกใช้เครื่องมือซ้ำๆ ด้วยอาร์กิวเมนต์เดียวกันจะไม่มีผลเพิ่มเติมต่อสภาพแวดล้อม ค่าเริ่มต้น: "เท็จ"
  • openWorldHint: หากเป็น "จริง" เครื่องมือจะโต้ตอบกับ "โอเพนเวิลด์" ของเอนทิตีภายนอกได้ หากเป็น "เท็จ" เครื่องมือจะโต้ตอบกับเอนทิตีภายในเท่านั้น เช่น เครื่องมือค้นหาเว็บจะเป็นโอเพนเวิลด์ แต่เครื่องมือหน่วยความจำจะไม่เป็นโอเพนเวิลด์

คำแนะนำที่อาจทำให้เกิดความเสียหาย: ❌ | คำแนะนำที่อาจทำให้เกิดผลลัพธ์เหมือนเดิม: ✅ | คำแนะนำแบบอ่านอย่างเดียว: ✅ | คำแนะนำแบบโลกเปิด: ❌