MCP Tools Reference: paydeveloper.googleapis.com

टूल: query_merchant_error_metrics

यह टूल, किसी खास कारोबारी की प्रोफ़ाइल के लिए, गड़बड़ी से जुड़ी मेट्रिक की पूरी जानकारी देता है. इस टूल से, गड़बड़ियों को अलग-अलग हिस्सों में बांटा जा सकता है. इससे डेवलपर, समस्याओं की सटीक जानकारी पा सकते हैं और उन्हें ठीक कर सकते हैं.

यहां दिए गए उदाहरण में, query_merchant_error_metrics MCP टूल को शुरू करने के लिए, curl का इस्तेमाल करने का तरीका बताया गया है.

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

ज़रूरी है. यह कारोबारी का यूनीक आइडेंटिफ़ायर है. इसके लिए, गड़बड़ी से जुड़ी मेट्रिक का अनुरोध किया जा रहा है.
timeRange

enum (TimeRange)

ज़रूरी नहीं. गड़बड़ी से जुड़ी मेट्रिक के डेटा की समयावधि.

आउटपुट स्कीमा

कारोबारी की गड़बड़ी से जुड़ी मेट्रिक के बारे में क्वेरी करने के लिए, जवाब का मैसेज.

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)

यह टाइमस्टैंप, घंटे की शुरुआत को दिखाता है.

यह आरएफ़सी 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 epoch 1970-01-01T00:00:00Z से होती है. इसकी वैल्यू -62135596800 और 253402300799 के बीच होनी चाहिए. इसमें ये वैल्यू भी शामिल हैं. यह 0001-01-01T00:00:00Z से 9999-12-31T23:59:59Z के बीच का समय है.
nanos

integer

यह एक सेकंड के नॉन-नेगेटिव फ़्रैक्शन को दिखाता है. इसकी रिज़ॉल्यूशन नैनोसेकंड में होती है. यह फ़ील्ड, अवधि का नैनोसेकंड वाला हिस्सा है. यह सेकंड का विकल्प नहीं है. फ़्रैक्शन वाली नेगेटिव सेकंड वैल्यू के लिए, नैनो वैल्यू नॉन-नेगेटिव होनी चाहिए. साथ ही, यह समय के हिसाब से आगे की ओर काउंट होनी चाहिए. इसकी वैल्यू 0 और 999,999,999 के बीच होनी चाहिए. इसमें ये वैल्यू भी शामिल हैं.

टूल के एनोटेशन

डिस्ट्रक्टिव हिंट: ❌ | आइडमपोटेंट हिंट: ✅ | रीड-ओनली हिंट: ✅ | ओपन वर्ल्ड हिंट: ❌