MCP Tools Reference: paydeveloper.googleapis.com

Herramienta: query_merchant_error_metrics

Recupera métricas de errores 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 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 errores 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 errores.
timeRange

enum (TimeRange)

Es opcional. Es el intervalo de tiempo de los datos de las métricas de errores.

TimeRange

Es el intervalo de tiempo de los datos. ID siguiente: 4

Enums
TIME_RANGE_UNSPECIFIED Indica un intervalo de tiempo no especificado.
TIME_RANGE_PAST_DAY Indica el día anterior, ayer.
TIME_RANGE_PAST_THREE_DAYS Indica los últimos tres días, sin incluir el día actual.
TIME_RANGE_PAST_WEEK Indica la semana anterior, sin incluir el día actual.

Esquema de salida

Mensaje de respuesta para consultar métricas de errores del comercio.

QueryMerchantErrorMetricsResponse

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

object (MerchantErrorMetric)

Son los datos de las métricas de errores 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 hora más cercana.

ErrorDetail

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

string

Es el código de error, p.ej., "OR_BIBED_07".
errorMessage

string

Es un mensaje descriptivo únicamente, sin 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 dentro de 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 nanosegundos de la duración, 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 estar entre 0 y 999,999,999 inclusive.

Anotaciones de herramientas

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