MCP Tools Reference: paydeveloper.googleapis.com

Ferramenta: query_merchant_error_metrics

Recupera métricas de erros detalhadas para um perfil comercial específico do comerciante. Essa ferramenta oferece um detalhamento granular dos erros, permitindo que os desenvolvedores identifiquem e resolvam problemas.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta MCP query_merchant_error_metrics.

Solicitação 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

Mensagem de solicitação para consultar métricas de erros do comerciante.

QueryMerchantErrorMetricsRequest

Representação JSON 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
Campos
merchantId

string

Obrigatório. O identificador exclusivo do comerciante para o qual as métricas de erros estão sendo solicitadas.
timeRange

enum (TimeRange)

Opcional. O período dos dados de métricas de erros.

TimeRange

O período dos dados. Próximo código: 4

Tipos enumerados
TIME_RANGE_UNSPECIFIED Período não especificado.
TIME_RANGE_PAST_DAY O dia anterior, ontem.
TIME_RANGE_PAST_THREE_DAYS Os três dias anteriores, excluindo o dia atual.
TIME_RANGE_PAST_WEEK A semana anterior, excluindo o dia atual.

Esquema de saída

Mensagem de resposta para consultar métricas de erros do comerciante.

QueryMerchantErrorMetricsResponse

Representação JSON 
{
  "errorMetrics": [
    {
      object (MerchantErrorMetric)
    }
  ]
}
Campos
errorMetrics[]

object (MerchantErrorMetric)

Os dados de métricas de erros do comerciante.

MerchantErrorMetric

Representação JSON 
{
  "errorDetail": {
    object (ErrorDetail)
  },
  "hourlyErrorCounts": [
    {
      object (HourlyErrorCount)
    }
  ]
}
Campos
errorDetail

object (ErrorDetail)

Apenas saída. Detalhes do erro.
hourlyErrorCounts[]

object (HourlyErrorCount)

Apenas saída. Uma lista da contagem de erros e do carimbo de data/hora, arredondada para a hora mais próxima.

ErrorDetail

Representação JSON 
{
  "errorCode": string,
  "errorMessage": string
}
Campos
errorCode

string

Código de erro, por exemplo, "OR_BIBED_07".
errorMessage

string

Mensagem descritiva apenas, sem dados do usuário nem rastreamentos de pilha internos.

HourlyErrorCount

Representação JSON 
{
  "hourlyTimestamp": string,
  "count": integer
}
Campos
hourlyTimestamp

string (Timestamp format)

Carimbo de data/hora que representa o início da hora.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
count

integer

O número de erros dentro dessa hora.

Carimbo de data/hora

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa os segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z. Precisa estar entre -62135596800 e 253402300799 (inclusive), o que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z.
nanos

integer

Frações não negativas de um segundo com resolução de nanossegundos. Esse campo é a parte de nanossegundos da duração, não uma alternativa aos segundos. Os valores de segundos negativos com frações ainda precisam ter valores em nanossegundos não negativos que representam períodos posteriores. O valor precisa ser de 0 a 999.999.999 (inclusive).

Anotações da ferramenta

Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ✅ | Dica de mundo aberto: ❌