MCP Tools Reference: paydeveloper.googleapis.com

Инструмент: query_merchant_error_metrics

Получает подробные метрики ошибок для конкретного профиля бизнеса продавца. Этот инструмент предоставляет детальную разбивку ошибок, позволяя разработчикам точно выявлять и устранять проблемы.

В следующем примере показано, как использовать curl для вызова инструмента MCP query_merchant_error_metrics .

Запрос 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_error_metrics",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

Сообщение запроса для получения метрик ошибок продавца.

QueryMerchantErrorMetricsRequest

JSON-представление 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
Поля
merchantId

string

Required. The unique identifier of the merchant for which error metrics are being requested.

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

Сообщение носит исключительно описательный характер, без данных пользователя и внутренних трассировок стека.

HourlyErrorCount

JSON-представление 
{
  "hourlyTimestamp": string,
  "count": integer
}
Поля
hourlyTimestamp

string ( Timestamp format)

Отметка времени, обозначающая начало часа.

Используется RFC 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" .

count

integer

Количество ошибок за этот час.

Отметка времени

JSON-представление 
{
  "seconds": string,
  "nanos": integer
}
Поля
seconds

string ( int64 format)

Обозначает количество секунд UTC-времени с начала эпохи Unix 1970-01-01T00:00:00Z. Должно находиться в диапазоне от -62135596800 до 253402300799 включительно (что соответствует периоду с 0001-01-01T00:00:00Z по 9999-12-31T23:59:59Z).

nanos

integer

Неотрицательные доли секунды с разрешением в наносекунды. Это поле представляет собой наносекундную часть длительности, а не альтернативу секундам. Отрицательные значения секунд с дробными долями должны по-прежнему иметь неотрицательные значения в наносекундах, отсчитываемые вперед во времени. Должны быть в диапазоне от 0 до 999 999 999 включительно.

Аннотации инструментов

Подсказка о разрушительном эффекте: ❌ | Подсказка об идемпотентности: ✅ | Подсказка только для чтения: ✅ | Подсказка об открытом мире: ❌