MCP Tools Reference: paydeveloper.googleapis.com

Herramienta: query_merchant_error_metrics

Recupera métricas de error detalladas de un perfil de empresa de un comerciante 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 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

Mensaje de solicitud para consultar métricas de error de un comerciante.

QueryMerchantErrorMetricsRequest

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

string

Obligatoria. Identificador único del comerciante del que se solicitan las métricas de error.
timeRange

enum (TimeRange)

Opcional. Intervalo de tiempo de los datos de las métricas de error.

TimeRange

Intervalo de tiempo de los datos. ID siguiente: 4

enumeraciones,
TIME_RANGE_UNSPECIFIED Intervalo de tiempo no especificado.
TIME_RANGE_PAST_DAY El día anterior, ayer.
TIME_RANGE_PAST_THREE_DAYS Los tres días anteriores, sin incluir el día actual.
TIME_RANGE_PAST_WEEK La semana anterior, sin incluir el día actual.

Esquema de salida

Mensaje de respuesta para consultar métricas de error de un comerciante.

QueryMerchantErrorMetricsResponse

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

object (MerchantErrorMetric)

Datos de las métricas de error del comerciante.

MerchantErrorMetric

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

object (ErrorDetail)

Solo de salida. Detalles del error.
hourlyErrorCounts[]

object (HourlyErrorCount)

Solo de salida. Lista del recuento de errores y su marca de tiempo, redondeada al inicio de la hora más próxima.

ErrorDetail

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

string

Código de error, por ejemplo, "OR_BIBED_07".
errorMessage

string

Mensaje descriptivo únicamente, sin datos de usuario ni seguimientos de pila internos.

HourlyErrorCount

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

string (Timestamp format)

Marca de tiempo que representa el inicio de la hora.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
count

integer

Número de errores en esta hora.

Timestamp

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

string (int64 format)

Representa segundos de tiempo UTC desde el registro de tiempo de Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799, ambos incluidos (lo que corresponde a 0001-01-01T00:00:00Z y 9999-12-31T23:59:59Z).
nanos

integer

Fracciones no negativas de un segundo con una resolución de nanosegundos. Este campo es la parte de nanosegundos de la duración, no una alternativa a los segundos. Los valores de segundos negativos con fracciones aún deben tener valores de nanosegundos no negativos que cuenten hacia adelante en el tiempo. Debe estar entre 0 y 999.999.999, ambos incluidos.

Anotaciones de herramientas

Indicación de acción destructiva: ❌ | Indicación de acción idempotente: ✅ | Indicación de acción de solo lectura: ✅ | Indicación de acción de mundo abierto: ❌