MCP Tools Reference: paydeveloper.googleapis.com

टूल: query_merchant_error_metrics

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

यहां दिए गए कोड सैंपल में, curl का इस्तेमाल करके, query_merchant_error_metrics एमसीपी टूल को कॉल करने का तरीका दिखाया गया है.

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

Enums
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)

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

यह आरएफ़सी 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 के बीच होनी चाहिए. इसमें ये दोनों वैल्यू भी शामिल हैं.

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

टूल के एनोटेशन, एमसीपी क्लाइंट को भेजे जाते हैं. इनसे किसी टूल के बुनियादी जोखिम के बारे में पता चलता है. ज़्यादातर क्लाइंट, इन संकेतों को भरोसेमंद नहीं मानते. हालांकि, इनका इस्तेमाल यह तय करने के लिए किया जा सकता है कि किसी उपयोगकर्ता को पुष्टि करने का प्रॉम्प्ट कब भेजा जाए.

टाइटल स्ट्रिंग के साथ-साथ, यहां दिए गए बूलियन हिंट इस तरह से तय किए जाते हैं:

  • readOnlyHint: अगर इसकी वैल्यू 'सही' है, तो टूल अपने एनवायरमेंट में कोई बदलाव नहीं करता. डिफ़ॉल्ट: 'गलत'.
  • destructiveHint: अगर इसकी वैल्यू 'सही' है, तो टूल, डेटा को मिटाने वाली कार्रवाइयां कर सकता है. अगर इसकी वैल्यू 'गलत' है, तो टूल सिर्फ़ डेटा जोड़ने वाली कार्रवाइयां कर सकता है. डिफ़ॉल्ट: 'सही'.
  • idempotentHint: अगर इसकी वैल्यू 'सही' है, तो एक ही आर्ग्युमेंट के साथ टूल को बार-बार कॉल करने पर, उसके एनवायरमेंट पर कोई अतिरिक्त असर नहीं पड़ेगा. डिफ़ॉल्ट: 'गलत'.
  • openWorldHint: अगर इसकी वैल्यू 'सही' है, तो टूल, बाहरी इकाइयों की 'विशाल दुनिया' के साथ इंटरैक्ट कर सकता है. अगर इसकी वैल्यू 'गलत' है, तो टूल सिर्फ़ इंटरनल इकाइयों के साथ इंटरैक्ट कर सकता है. उदाहरण के लिए, वेब सर्च टूल, ओपन वर्ल्ड वाला टूल होगा. वहीं, मेमोरी टूल, ओपन वर्ल्ड वाला टूल नहीं होगा.

डेटा मिटाने वाला हिंट: ❌ | एक ही आर्ग्युमेंट के साथ बार-बार कॉल करने पर कोई अतिरिक्त असर नहीं पड़ने वाला हिंट: ✅ | सिर्फ़ डेटा पढ़ने वाला हिंट: ✅ | ओपन वर्ल्ड वाला हिंट: ❌