MCP Tools Reference: paydeveloper.googleapis.com

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

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

В следующем примере показано, как использовать curl для вызова инструмента MCP 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 )

Необязательно. Временной диапазон данных о производительности.

Схема вывода

Ответное сообщение на запрос о показателях работы продавца.

QueryMerchantPerformanceResponse

JSON-представление 
{
  "merchantPerformanceMetrics": [
    {
      object (MerchantPerformanceMetric)
    }
  ]
}
Поля
merchantPerformanceMetrics[]

object ( MerchantPerformanceMetric )

The performance data of the merchant.

Показатель эффективности продавца

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" } .

Дополнительные сведения

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

string

value

string

Почасовое значение метрики

JSON-представление 
{
  "hourlyTimestamp": string,
  "value": number
}
Поля
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" .

value

number

Фактическое значение метрики. Для коэффициента конверсии значение находится в диапазоне [0, 1]. Для других метрик значение является неотрицательным целым числом.

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

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 включительно.

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

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