MCP Tools Reference: paydeveloper.googleapis.com

Tool: query_merchant_performance

Ruft zusammengefasste Leistungsdaten und Messwerte nach der Integration für ein bestimmtes Unternehmensprofil eines Händlers ab.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool query_merchant_performance aufrufen.

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_performance",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfragenachricht zum Abfragen von Händlerleistungsdaten.

QueryMerchantPerformanceRequest

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

string

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

enum (TimeRange)

Optional. Der Zeitraum der Leistungsdaten.

Ausgabeschema

Antwortnachricht für die Abfrage der Händlerleistung.

QueryMerchantPerformanceResponse

JSON-Darstellung 
{
  "merchantPerformanceMetrics": [
    {
      object (MerchantPerformanceMetric)
    }
  ]
}
Felder
merchantPerformanceMetrics[]

object (MerchantPerformanceMetric)

Die Leistungsdaten des Händlers.

MerchantPerformanceMetric

JSON-Darstellung 
{
  "metricDetail": {
    object (MetricDetail)
  },
  "hourlyMetricValues": [
    {
      object (HourlyMetricValue)
    }
  ]
}
Felder
metricDetail

object (MetricDetail)

Nur Ausgabe. Details zum Messwert.
hourlyMetricValues[]

object (HourlyMetricValue)

Nur Ausgabe. Eine Liste mit dem Messwert und dem zugehörigen Zeitstempel, gerundet auf die nächste volle Stunde.

MetricDetail

JSON-Darstellung 
{
  "metricType": enum (MetricType),
  "additionalDetails": {
    string: string,
    ...
  }
}
Felder
metricType

enum (MetricType)

Typ des Messwerts.
additionalDetails

map (key: string, value: string)

Schlüssel/Wert-Paare für zusätzliche Details zum Messwert, z.B. „gateway“: „stripe“. Weitere Informationen finden Sie unter

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

AdditionalDetailsEntry

JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

string

HourlyMetricValue

JSON-Darstellung 
{
  "hourlyTimestamp": string,
  "value": number
}
Felder
hourlyTimestamp

string (Timestamp format)

Der Zeitstempel des Messwerts, gerundet auf die nächste volle Stunde.

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".
value

number

Der tatsächliche Messwert. Für die Conversion-Rate liegt der Wert im Bereich [0, 1]. Bei anderen Messwerten ist der Wert eine positive Ganzzahl.

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 einschließlich 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 enthält den Nanosekundenanteil der Dauer und ist 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).

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Nur-Lese-Hinweis: ✅ | Open-World-Hinweis: ❌