MCP Tools Reference: paydeveloper.googleapis.com

Herramienta: query_merchant_error_metrics

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

En la siguiente muestra de código, se explica cómo usar curl para llamar a la herramienta del MCP query_merchant_error_metrics.

Solicitud 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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensaje de solicitud para consultar las métricas de errores del comerciante.

QueryMerchantErrorMetricsRequest

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

string

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

enum (TimeRange)

Es opcional. Es el período de las métricas de errores.

TimeRange

Es el período de los datos. Próximo ID: 4

Enums
TIME_RANGE_UNSPECIFIED Período no especificado.
TIME_RANGE_PAST_DAY El día anterior, ayer.
TIME_RANGE_PAST_THREE_DAYS Los últimos tres días, 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 las métricas de errores del comerciante.

QueryMerchantErrorMetricsResponse

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

object (MerchantErrorMetric)

Son los datos de las métricas de errores del comerciante.

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 solo un mensaje descriptivo, 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

Las anotaciones de herramientas se envían a los clientes del MCP para describir el riesgo básico de una herramienta determinada. La mayoría de los clientes tratan estas sugerencias como no confiables, pero se pueden usar para decidir cuándo se puede enviar un mensaje de confirmación a un usuario.

Junto con la cadena de título, las siguientes sugerencias booleanas se definen de la siguiente manera:

  • readOnlyHint: Si es verdadero, la herramienta no modifica su entorno. Valor predeterminado: false.
  • destructiveHint: Si es verdadero, la herramienta puede realizar acciones destructivas. Si es falso, la herramienta solo puede realizar acciones aditivas. Valor predeterminado: true.
  • idempotentHint: Si es verdadero, llamar a la herramienta de forma repetida con los mismos argumentos no tendrá ningún efecto adicional en su entorno. Valor predeterminado: false.
  • openWorldHint: Si es verdadero, la herramienta puede interactuar con un "mundo abierto" de entidades externas. Si es falso, la herramienta solo puede interactuar con entidades internas. Por ejemplo, una herramienta de búsqueda web sería de mundo abierto, mientras que una herramienta de memoria no lo sería.

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