MCP Tools Reference: paydeveloper.googleapis.com

ابزار: query_merchant_error_metrics

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

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

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

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

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

خطای فروشنده درخواست معیارها

نمایش 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 )

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

جزئیات خطا

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

string

کد خطا، مثلاً "OR_BIBED_07".

errorMessage

string

فقط پیام توصیفی، بدون داده‌های کاربر یا ردپای پشته داخلی.

تعداد خطاهای ساعتی

نمایش JSON 
{
  "hourlyTimestamp": string,
  "count": integer
}
فیلدها
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" .

count

integer

تعداد خطاها در این ساعت.

مهر زمانی

نمایش JSON 
{
  "seconds": string,
  "nanos": integer
}
فیلدها
seconds

string ( int64 format)

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

nanos

integer

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

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

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