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.

TimeRange

Der Zeitraum der Daten. Nächste ID: 4

Enums
TIME_RANGE_UNSPECIFIED Nicht angegebener Zeitraum.
TIME_RANGE_PAST_DAY 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 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).

MetricType

Der Typ des gemessenen Messwerts.

Enums
METRIC_TYPE_UNSPECIFIED Nicht angegebener Messwerttyp.
FACILITATION_COUNT Die Anzahl der erfolgreichen GPay API-Vorgänge.
VISIT_COUNT Die Anzahl der Klicks auf die Schaltfläche für die GPay API.
CONVERSION_RATE Die Conversion-Rate der Schaltfläche „Zur Kasse“, definiert als das Verhältnis der Anzahl der erfolgreichen GPay API-Vorgänge zur Anzahl der Klicks auf die GPay API-Schaltfläche.

Tool-Annotationen

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