MCP Tools Reference: paydeveloper.googleapis.com

ابزار: query_merchant_performance

داده‌های عملکرد تجمیع‌شده سطح بالا و معیارهای پس از ادغام را برای یک نمایه تجاری خاص بازیابی می‌کند.

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار query_merchant_performance MCP را نشان می‌دهد.

درخواست کرل 
                  
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
}'

طرحواره ورودی

درخواست پیام برای جستجوی داده‌های عملکرد فروشنده.

درخواست عملکرد فروشنده

نمایش JSON 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
فیلدها
merchantId

string

الزامی. شناسه منحصر به فرد فروشنده‌ای که داده‌های عملکرد برای او درخواست شده است.

timeRange

enum ( TimeRange )

اختیاری. محدوده زمانی داده‌های عملکرد.

طرحواره خروجی

پیام پاسخ برای استعلام عملکرد فروشنده.

پاسخ عملکرد فروشنده پرس و جو

نمایش JSON 
{
  "merchantPerformanceMetrics": [
    {
      object (MerchantPerformanceMetric)
    }
  ]
}
فیلدها
merchantPerformanceMetrics[]

object ( MerchantPerformanceMetric )

داده‌های عملکرد تاجر.

معیار عملکرد فروشنده

نمایش JSON 
{
  "metricDetail": {
    object (MetricDetail)
  },
  "hourlyMetricValues": [
    {
      object (HourlyMetricValue)
    }
  ]
}
فیلدها
metricDetail

object ( MetricDetail )

فقط خروجی. جزئیات معیار.

hourlyMetricValues[]

object ( HourlyMetricValue )

فقط خروجی. فهرستی از مقدار متریک و مهر زمانی آن، که به نزدیکترین رأس ساعت گرد شده است.

جزئیات متریک

نمایش 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" } .

جزئیات بیشترورودی

نمایش JSON 
{
  "key": string,
  "value": string
}
فیلدها
key

string

value

string

مقدار ساعتی

نمایش JSON 
{
  "hourlyTimestamp": string,
  "value": number
}
فیلدها
hourlyTimestamp

string ( Timestamp format)

مهر زمانی مقدار متریک که به نزدیکترین رأس ساعت گرد شده است.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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)

ثانیه‌های زمان UTC را از زمان یونیکس ۱۹۷۰-۰۱-۰۱T۰۰:۰۰:۰۰Z نشان می‌دهد. باید بین -۶۲۱۳۵۵۹۶۸۰۰ و ۲۵۳۴۰۲۳۰۰۷۹۹ باشد (که معادل ۰۰۰۱-۰۱-۰۱T۰۰:۰۰:۰۰Z تا ۹۹۹۹-۱۲-۳۱T۲۳:۵۹:۵۹Z است).

nanos

integer

کسرهای غیرمنفی ثانیه با وضوح نانوثانیه. این فیلد بخش نانوثانیه از مدت زمان است، نه جایگزینی برای ثانیه. مقادیر منفی ثانیه با کسرها باید همچنان دارای مقادیر نانوثانیه غیرمنفی باشند که در زمان به جلو شمارش می‌شوند. باید بین ۰ تا ۹۹۹۹۹۹۹۹۹۹ باشد.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌