MCP Tools Reference: paydeveloper.googleapis.com

ابزار: query_merchant_error_metrics

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

نمونه کد زیر نحوه استفاده از curl برای فراخوانی ابزار query_merchant_error_metrics 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_error_metrics",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

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

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

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

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

string

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

timeRange

enum ( TimeRange )

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

محدوده زمانی

محدوده زمانی داده‌ها. شناسه بعدی: ۴

انوم‌ها
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 )

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

جزئیات خطا

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

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

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

حاشیه‌نویسی‌های ابزار برای توصیف ریسک اولیه‌ی یک ابزار مشخص به کلاینت‌های MCP ارسال می‌شوند. اکثر کلاینت‌ها این نکات را غیرقابل اعتماد می‌دانند، اما می‌توان از آنها برای تصمیم‌گیری در مورد زمان ارسال پیام تأیید به کاربر استفاده کرد.

همراه با رشته عنوان، نکات بولی زیر به صورت زیر تعریف می‌شوند:

  • readOnlyHint : اگر درست باشد، ابزار محیط خود را تغییر نمی‌دهد. پیش‌فرض: نادرست.
  • destructiveHint : اگر درست باشد، ابزار می‌تواند اقدامات مخرب انجام دهد. اگر نادرست باشد، ابزار فقط می‌تواند اقدامات افزایشی انجام دهد. پیش‌فرض: درست.
  • idempotentHint : اگر مقدار آن درست باشد، فراخوانی مکرر ابزار با آرگومان‌های یکسان، هیچ تأثیر اضافی بر محیط آن نخواهد داشت. پیش‌فرض: false.
  • openWorldHint : اگر درست باشد، ابزار می‌تواند با «دنیای باز» از موجودیت‌های خارجی تعامل داشته باشد. اگر نادرست باشد، ابزار فقط می‌تواند با موجودیت‌های داخلی تعامل داشته باشد. برای مثال، یک ابزار جستجوی وب جهان‌باز خواهد بود، در حالی که یک ابزار حافظه جهان‌باز نخواهد بود.

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