MCP Tools Reference: paydeveloper.googleapis.com

टूल: query_merchant_performance

यह कुकी, किसी कारोबारी या कंपनी की Business Profile के लिए, परफ़ॉर्मेंस का एग्रीगेट किया गया डेटा और इंटिग्रेशन के बाद की मेट्रिक को वापस लाती है.

यहां दिए गए सैंपल में, curl का इस्तेमाल करके query_merchant_performance एमसीपी टूल को चालू करने का तरीका बताया गया है.

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)

ज़रूरी नहीं. परफ़ॉर्मेंस डेटा की समयावधि.

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

कारोबारी या कंपनी की परफ़ॉर्मेंस के बारे में क्वेरी करने के लिए जवाब का मैसेज.

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)

मेट्रिक वैल्यू का टाइमस्टैंप, जिसे घंटे के सबसे नज़दीकी समय के हिसाब से राउंड किया गया है.

यह आरएफ़सी 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

मेट्रिक की असल वैल्यू. कन्वर्ज़न रेट के लिए, वैल्यू [0, 1] की रेंज में होती है. अन्य मेट्रिक के लिए, वैल्यू एक धनात्मक पूर्णांक होती है.

टाइमस्टैम्प

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 और 99,99,99,999 के बीच होना चाहिए.

टूल एनोटेशन

बदलाव करने से जुड़ी जानकारी: ❌ | एक ही बार लागू होने से जुड़ी जानकारी: ✅ | सिर्फ़ पढ़ने से जुड़ी जानकारी: ✅ | ओपन वर्ल्ड से जुड़ी जानकारी: ❌