MCP Tools Reference: paydeveloper.googleapis.com

Narzędzie: query_merchant_performance

Pobiera zagregowane dane o skuteczności i wskaźniki po integracji dotyczące konkretnego profilu firmy sprzedawcy.

Poniższy przykład pokazuje, jak użyć narzędzia curl do wywołania narzędzia MCP query_merchant_performance.

Żądanie Curl 
                  
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
}'

Schemat wejściowy

Wiadomość z żądaniem danych o skuteczności sprzedawcy.

QueryMerchantPerformanceRequest

Zapis JSON 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
Pola
merchantId

string

Wymagane. Unikalny identyfikator sprzedawcy, dla którego żądane są dane o skuteczności.
timeRange

enum (TimeRange)

Opcjonalnie. Zakres czasu danych o skuteczności.

Schemat wyjściowy

Wiadomość z odpowiedzią na zapytanie o skuteczność sprzedawcy.

QueryMerchantPerformanceResponse

Zapis JSON 
{
  "merchantPerformanceMetrics": [
    {
      object (MerchantPerformanceMetric)
    }
  ]
}
Pola
merchantPerformanceMetrics[]

object (MerchantPerformanceMetric)

Dane o skuteczności sprzedawcy.

MerchantPerformanceMetric

Zapis JSON 
{
  "metricDetail": {
    object (MetricDetail)
  },
  "hourlyMetricValues": [
    {
      object (HourlyMetricValue)
    }
  ]
}
Pola
metricDetail

object (MetricDetail)

Tylko dane wyjściowe. Szczegóły wskaźnika.
hourlyMetricValues[]

object (HourlyMetricValue)

Tylko dane wyjściowe. Lista wartości wskaźnika i jego sygnatury czasowej zaokrąglonej do najbliższej pełnej godziny.

MetricDetail

Zapis JSON 
{
  "metricType": enum (MetricType),
  "additionalDetails": {
    string: string,
    ...
  }
}
Pola
metricType

enum (MetricType)

Typ wskaźnika.
additionalDetails

map (key: string, value: string)

Pary klucz-wartość zawierające dodatkowe informacje o wskaźniku, np. „gateway”: „stripe”. Więcej informacji

Obiekt zawierający listę "key": value par. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

AdditionalDetailsEntry

Zapis JSON 
{
  "key": string,
  "value": string
}
Pola
key

string
value

string

HourlyMetricValue

Zapis JSON 
{
  "hourlyTimestamp": string,
  "value": number
}
Pola
hourlyTimestamp

string (Timestamp format)

Sygnatura czasowa wartości wskaźnika zaokrąglona do najbliższej pełnej godziny.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
value

number

Rzeczywista wartość wskaźnika. W przypadku współczynnika konwersji wartość mieści się w zakresie [0, 1]. W przypadku innych wskaźników wartość jest nieujemną liczbą całkowitą.

Sygnatura czasowa

Zapis JSON 
{
  "seconds": string,
  "nanos": integer
}
Pola
seconds

string (int64 format)

Liczba sekund czasu UTC od początku epoki uniksowej (1970-01-01T00:00:00Z). Musi mieścić się w zakresie od -62135596800 do 253402300799 włącznie (co odpowiada okresowi od 0001-01-01T00:00:00Z do 9999-12-31T23:59:59Z).
nanos

integer

Nieujemne ułamki sekundy w rozdzielczości nanosekundowej. To pole zawiera część czasu trwania w nanosekundach, a nie alternatywę dla sekund. Ujemne wartości sekund z ułamkami muszą nadal mieć nieujemne wartości nanosekund, które liczą czas do przodu. Musi mieścić się w zakresie od 0 do 999 999 999 włącznie.

Adnotacje narzędzia

Wskazówka dotycząca działania destrukcyjnego: ❌ | Wskazówka dotycząca działania idempotentnego: ✅ | Wskazówka dotycząca działania tylko do odczytu: ✅ | Wskazówka dotycząca działania w otwartym świecie: ❌