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 Codebeispiel 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 MCP tool 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 ID des Händlers, für den Fehlermesswerte angefordert werden.
timeRange

enum (TimeRange)

Optional. Der Zeitraum der Fehlermesswertdaten.

TimeRange

Der Zeitraum der Daten. Nächste ID: 4

Enums
TIME_RANGE_UNSPECIFIED Nicht angegebener Zeitraum.
TIME_RANGE_PAST_DAY Der letzte Tag, gestern.
TIME_RANGE_PAST_THREE_DAYS Die letzten drei Tage, ohne den aktuellen Tag.
TIME_RANGE_PAST_WEEK Die letzte Woche, ohne den aktuellen Tag.

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 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 (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
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.

Toolanmerkungen

Toolanmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet werden soll.

Neben dem Titelstring sind die folgenden booleschen Hinweise definiert:

  • readOnlyHint: Wenn „true“ (wahr), ändert das Tool seine Umgebung nicht. Standardeinstellung: „false“ (falsch).
  • destructiveHint: Wenn „true“ (wahr), kann das Tool destruktive Aktionen ausführen. Wenn „false“ (falsch), kann das Tool nur additive Aktionen ausführen. Standardeinstellung: „true“ (wahr).
  • idempotentHint: Wenn „true“ (wahr), hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf seine Umgebung. Standardeinstellung: „false“ (falsch).
  • openWorldHint: Wenn „true“ (wahr), kann das Tool mit einer „offenen Welt“ externer Entitäten interagieren. Wenn „false“ (falsch), kann das Tool nur mit internen Entitäten interagieren. Ein Web-Suchtool wäre beispielsweise eine offene Welt, ein Speichertool jedoch nicht.

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Nur-Lese-Hinweis: ✅ | Hinweis zur offenen Welt: ❌