MCP Tools Reference: paydeveloper.googleapis.com

Instrument: query_merchant_error_metrics

Obține valori detaliate ale erorilor pentru un anumit profil comercial. Acest instrument oferă o defalcare granulară a erorilor, permițând dezvoltatorilor să identifice și să rezolve problemele.

Următorul exemplu demonstrează cum se utilizează curl pentru a invoca instrumentul MCP query_merchant_error_metrics .

Cerere de bucle 
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
}'

Schema de intrare

Mesaj de solicitare pentru interogarea metricilor de eroare ale comerciantului.

Cerere de metrică de eroare a comerciantului pentru interogare

Reprezentare JSON 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
Câmpuri
merchantId

string

Obligatoriu. Identificatorul unic al comerciantului pentru care se solicită valorile de eroare.

timeRange

enum ( TimeRange )

Opțional. Intervalul de timp al datelor metricelor de eroare.

Interval de timp

Intervalul de timp al datelor. Următorul ID: 4

Enumări
TIME_RANGE_UNSPECIFIED Interval de timp nespecificat.
TIME_RANGE_PAST_DAY Ziua trecută, ieri.
TIME_RANGE_PAST_THREE_DAYS Ultimele trei zile, excluzând ziua curentă.
TIME_RANGE_PAST_WEEK Săptămâna trecută, excluzând ziua curentă.

Schema de ieșire

Mesaj de răspuns pentru interogarea valorilor de eroare ale comerciantului.

Răspuns la valorile de eroare ale comerciantului la interogare

Reprezentare JSON 
{
  "errorMetrics": [
    {
      object (MerchantErrorMetric)
    }
  ]
}
Câmpuri
errorMetrics[]

object ( MerchantErrorMetric )

Datele privind valorile de eroare ale comerciantului.

MerchantErrorMetric

Reprezentare JSON 
{
  "errorDetail": {
    object (ErrorDetail)
  },
  "hourlyErrorCounts": [
    {
      object (HourlyErrorCount)
    }
  ]
}
Câmpuri
errorDetail

object ( ErrorDetail )

Doar ieșire. Detalii despre eroare.

hourlyErrorCounts[]

object ( HourlyErrorCount )

Numai ieșire. O listă cu numărul de erori și marcajul temporal al acestora, rotunjită la cea mai apropiată oră maximă.

Detalii eroare

Reprezentare JSON 
{
  "errorCode": string,
  "errorMessage": string
}
Câmpuri
errorCode

string

Cod de eroare, de exemplu „OR_BIBED_07”.

errorMessage

string

Doar mesaj descriptiv, fără date despre utilizator și fără urme interne ale stivei.

NumărOrarErori

Reprezentare JSON 
{
  "hourlyTimestamp": string,
  "count": integer
}
Câmpuri
hourlyTimestamp

string ( Timestamp format)

Marcaj temporal care reprezintă începutul orei.

Utilizează RFC 3339, unde ieșirea generată va fi întotdeauna normalizată Z și va utiliza 0, 3, 6 sau 9 cifre fracționare. Sunt acceptate și alte offset-uri decât „Z”. Exemple: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" sau "2014-10-02T15:01:23+05:30" .

count

integer

Numărul de erori din această oră.

Marcaj temporal

Reprezentare JSON 
{
  "seconds": string,
  "nanos": integer
}
Câmpuri
seconds

string ( int64 format)

Reprezintă secundele de timp UTC de la epoca Unix 1970-01-01T00:00:00Z. Trebuie să fie între -62135596800 și 253402300799 inclusiv (ceea ce corespunde între 0001-01-01T00:00:00Z și 9999-12-31T23:59:59Z).

nanos

integer

Fracțiuni non-negative de secundă la rezoluție nanosecundă. Acest câmp reprezintă porțiunea de nanosecundă a duratei, nu o alternativă la secunde. Valorile negative ale secundelor cu fracții trebuie să aibă în continuare valori non-negative de nanosecundă care se numără înainte în timp. Trebuie să fie între 0 și 999.999.999 inclusiv.

Adnotări ale instrumentelor

Indiciu distructiv: ❌ | Indiciu idempotent: ✅ | Indiciu doar pentru citire: ✅ | Indiciu pentru lumea deschisă: ❌