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 de código a seguir mostra como usar curl para chamar 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 MCP tool 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 de contagem de erros e o carimbo de data/hora, arredondado 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. Precisa estar entre 0 e 999.999.999 (inclusive).

Anotações da ferramenta

As anotações da ferramenta são enviadas aos clientes do MCP para descrever o risco básico de uma determinada ferramenta. A maioria dos clientes trata essas dicas como não confiáveis, mas elas podem ser usadas para decidir quando um aviso de confirmação pode ser enviado a um usuário.

Além da string de título, as seguintes dicas booleanas são definidas da seguinte maneira:

  • readOnlyHint: se for verdadeiro, a ferramenta não modifica o ambiente. Padrão: falso.
  • destructiveHint: se for verdadeiro, a ferramenta poderá realizar ações destrutivas. Se for falso, a ferramenta só poderá realizar ações aditivas. Padrão: verdadeiro.
  • idempotentHint: se for verdadeiro, chamar a ferramenta repetidamente com os mesmos argumentos não terá efeito adicional no ambiente. Padrão: falso.
  • openWorldHint: se for verdadeiro, a ferramenta poderá interagir com um "mundo aberto" de entidades externas. Se for falso, a ferramenta só poderá interagir com entidades internas. Por exemplo, uma ferramenta de pesquisa na Web seria de mundo aberto, enquanto uma ferramenta de memória não seria.

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