MCP Tools Reference: paydeveloper.googleapis.com

Herramienta: query_merchant_performance

Recupera datos de rendimiento agregados de alto nivel y métricas posteriores a la integración para un perfil de la empresa de un comercio específico.

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP query_merchant_performance.

Solicitud de 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
}'

Esquema de entrada

Es el mensaje de solicitud para consultar los datos de rendimiento del comercio.

QueryMerchantPerformanceRequest

Representación JSON 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
Campos
merchantId

string

Obligatorio. Es el identificador único del comercio para el que se solicitan los datos de rendimiento.
timeRange

enum (TimeRange)

Opcional. Es el período de los datos de rendimiento.

Esquema de salida

Es el mensaje de respuesta para consultar el rendimiento del comercio.

QueryMerchantPerformanceResponse

Representación JSON 
{
  "merchantPerformanceMetrics": [
    {
      object (MerchantPerformanceMetric)
    }
  ]
}
Campos
merchantPerformanceMetrics[]

object (MerchantPerformanceMetric)

Son los datos de rendimiento del comercio.

MerchantPerformanceMetric

Representación JSON 
{
  "metricDetail": {
    object (MetricDetail)
  },
  "hourlyMetricValues": [
    {
      object (HourlyMetricValue)
    }
  ]
}
Campos
metricDetail

object (MetricDetail)

Solo salida. Son los detalles de la métrica.
hourlyMetricValues[]

object (HourlyMetricValue)

Solo salida. Es una lista del valor de la métrica y su marca de tiempo, redondeada a la parte superior de la hora más cercana.

MetricDetail

Representación JSON 
{
  "metricType": enum (MetricType),
  "additionalDetails": {
    string: string,
    ...
  }
}
Campos
metricType

enum (MetricType)

Es el tipo de métrica.
additionalDetails

map (key: string, value: string)

Son pares clave-valor para cualquier detalle adicional sobre la métrica, p.ej., "gateway": "stripe". Para obtener más información, consulta

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

AdditionalDetailsEntry

Representación JSON 
{
  "key": string,
  "value": string
}
Campos
key

string
value

string

HourlyMetricValue

Representación JSON 
{
  "hourlyTimestamp": string,
  "value": number
}
Campos
hourlyTimestamp

string (Timestamp format)

Es la marca de tiempo del valor de la métrica redondeada a la parte superior de la hora más cercana.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
value

number

Es el valor real de la métrica. En el caso del porcentaje de conversiones, el valor se encuentra en el rango [0, 1]. Para otras métricas, el valor es un número entero no negativo.

Marca de tiempo

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa los segundos de la hora UTC desde la época de Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799 inclusive (lo que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Fracciones no negativas de un segundo a una resolución de nanosegundos. Este campo es la parte de la duración en nanosegundos, no una alternativa a los segundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Debe ser un valor entre 0 y 999,999,999, inclusive.

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌