MCP Tools Reference: paydeveloper.googleapis.com

工具：query_merchant_error_metrics

擷取特定商家商家檔案的詳細錯誤指標。這項工具會詳細列出錯誤，方便開發人員找出並解決問題。

下列範例示範如何使用 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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

輸入內容的結構定義

用於查詢商家錯誤指標的要求訊息。

QueryMerchantErrorMetricsRequest

JSON 表示法 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
欄位
merchantId

string

必填。要求錯誤指標的商家專屬 ID。
timeRange

enum (TimeRange)

(選用步驟) 錯誤指標資料的時間範圍。

TimeRange

資料的時間範圍。下一個 ID：4

列舉
TIME_RANGE_UNSPECIFIED 未指定時間範圍。
TIME_RANGE_PAST_DAY 過去一天，也就是昨天。
TIME_RANGE_PAST_THREE_DAYS 過去三天 (不含當天)。
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

只有說明訊息，沒有使用者資料或內部堆疊追蹤記錄。

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)

代表自 Unix 紀元 1970-01-01T00:00:00Z 起算的世界標準時間秒數。必須介於 -62135596800 和 253402300799 之間 (含)，對應至 0001-01-01T00:00:00Z 至 9999-12-31T23:59:59Z。
nanos

integer

以奈秒為單位的非負秒數小數。這個欄位是時間長度的奈秒部分，並非秒數的替代值。如果第二個值為負數，且包含分數，奈秒值仍須為非負數，且時間會往前計算。必須介於 0 至 999,999,999 之間 (含)。

工具註解

破壞性提示：❌ | 等冪提示：✅ | 唯讀提示：✅ | 開放世界提示：❌