MCP Tools Reference: paydeveloper.googleapis.com

Tool: query_merchant_error_metrics

Ruft detaillierte Fehlermesswerte für ein bestimmtes Unternehmensprofil eines Händlers ab. Dieses Tool bietet eine detaillierte Aufschlüsselung der Fehler, sodass Entwickler Probleme genau lokalisieren und beheben können.

Das folgende Beispiel zeigt, wie Sie curl verwenden, um das MCP-Tool query_merchant_error_metrics aufzurufen.

Curl-Anfrage 
                  
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
}'

Eingabeschema

Anfragenachricht zum Abfragen von Fehlermesswerten für Händler.

QueryMerchantErrorMetricsRequest

JSON-Darstellung 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
Felder
merchantId

string

Erforderlich. Die eindeutige Kennung des Händlers, für den Fehlermesswerte angefordert werden.
timeRange

enum (TimeRange)

Optional. Der Zeitraum der Fehlermesswertdaten.

Ausgabeschema

Antwortnachricht zum Abfragen von Fehlermesswerten für Händler.

QueryMerchantErrorMetricsResponse

JSON-Darstellung 
{
  "errorMetrics": [
    {
      object (MerchantErrorMetric)
    }
  ]
}
Felder
errorMetrics[]

object (MerchantErrorMetric)

Die Fehlermesswertdaten des Händlers.

MerchantErrorMetric

JSON-Darstellung 
{
  "errorDetail": {
    object (ErrorDetail)
  },
  "hourlyErrorCounts": [
    {
      object (HourlyErrorCount)
    }
  ]
}
Felder
errorDetail

object (ErrorDetail)

Nur Ausgabe. Details zum Fehler.
hourlyErrorCounts[]

object (HourlyErrorCount)

Nur Ausgabe. Eine Liste der Fehleranzahl und des zugehörigen Zeitstempels, gerundet auf die nächste volle Stunde.

ErrorDetail

JSON-Darstellung 
{
  "errorCode": string,
  "errorMessage": string
}
Felder
errorCode

string

Fehlercode, z.B. „OR_BIBED_07“.
errorMessage

string

Nur beschreibende Nachricht, keine Nutzerdaten oder internen Stacktraces.

HourlyErrorCount

JSON-Darstellung 
{
  "hourlyTimestamp": string,
  "count": integer
}
Felder
hourlyTimestamp

string (Timestamp format)

Zeitstempel, der den Beginn der Stunde darstellt.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
count

integer

Die Anzahl der Fehler innerhalb dieser Stunde.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss zwischen -62135596800 und 253402300799 liegen (einschließlich), was 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z entspricht.
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld ist der Nanosekundenanteil der Dauer und keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

Toolanmerkungen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Hinweis „Nur lesen“: ✅ | Hinweis „Offene Welt“: ❌