MCP Tools Reference: paydeveloper.googleapis.com

Herramienta: query_merchant_error_metrics

Recupera métricas de error detalladas para un perfil de negocio de comercio específico. Esta herramienta proporciona un desglose detallado de los errores, lo que permite a los desarrolladores identificar y resolver problemas.

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

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_error_metrics",
    "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 las métricas de error del comercio.

QueryMerchantErrorMetricsRequest

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

string

Obligatorio. Es el identificador único del comercio para el que se solicitan las métricas de error.
timeRange

enum (TimeRange)

Opcional. Es el período de los datos de las métricas de error.

Esquema de salida

Es el mensaje de respuesta para consultar las métricas de error del comercio.

QueryMerchantErrorMetricsResponse

Representación JSON 
{
  "errorMetrics": [
    {
      object (MerchantErrorMetric)
    }
  ]
}
Campos
errorMetrics[]

object (MerchantErrorMetric)

Son los datos de las métricas de error del comercio.

MerchantErrorMetric

Representación JSON 
{
  "errorDetail": {
    object (ErrorDetail)
  },
  "hourlyErrorCounts": [
    {
      object (HourlyErrorCount)
    }
  ]
}
Campos
errorDetail

object (ErrorDetail)

Solo salida. Son los detalles del error.
hourlyErrorCounts[]

object (HourlyErrorCount)

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

ErrorDetail

Representación JSON 
{
  "errorCode": string,
  "errorMessage": string
}
Campos
errorCode

string

Código de error, p.ej., "OR_BIBED_07".
errorMessage

string

Solo es un mensaje descriptivo, no incluye datos del usuario ni seguimientos de pila internos.

HourlyErrorCount

Representación JSON 
{
  "hourlyTimestamp": string,
  "count": integer
}
Campos
hourlyTimestamp

string (Timestamp format)

Es la marca de tiempo que representa el inicio de la hora.

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

integer

Es la cantidad de errores que se produjeron en esta hora.

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: ❌