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)

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

TimeRange

डेटा की समयावधि. अगला आईडी: 4

Enums
TIME_RANGE_UNSPECIFIED समयसीमा तय नहीं की गई है.
TIME_RANGE_PAST_DAY बीता हुआ दिन, यानी कि कल.
TIME_RANGE_PAST_THREE_DAYS पिछले तीन दिन, जिसमें मौजूदा दिन शामिल नहीं है.
TIME_RANGE_PAST_WEEK पिछले हफ़्ते का डेटा, जिसमें आज का डेटा शामिल नहीं है.

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

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

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

MetricType

मेजर की जा रही मेट्रिक का टाइप.

Enums
METRIC_TYPE_UNSPECIFIED मेट्रिक के टाइप की जानकारी नहीं दी गई है.
FACILITATION_COUNT GPay API की मदद से किए गए लेन-देन की संख्या.
VISIT_COUNT GPay API बटन पर हुए क्लिक की संख्या.
CONVERSION_RATE चेकआउट बटन की कन्वर्ज़न दर. इसे GPay API की मदद से किए गए सफल लेन-देन की संख्या और GPay API बटन पर किए गए क्लिक की संख्या के अनुपात के तौर पर तय किया जाता है.

टूल एनोटेशन

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