MCP Tools Reference: paydeveloper.googleapis.com

Narzędzie: query_merchant_performance

Pobiera ogólne zbiorcze dane o skuteczności i dane po integracji dotyczące konkretnego profilu firmy sprzedawcy.

Poniższy przykład pokazuje, jak za pomocą curl wywołać narzędzie query_merchant_performance MCP.

Żą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 danych wejściowych

Wiadomość z prośbą o zapytanie o dane o skuteczności sprzedawcy.

QueryMerchantPerformanceRequest

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

string

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

enum (TimeRange)

Opcjonalnie. Zakres czasowy danych o skuteczności.

TimeRange

Zakres czasowy danych. Następny identyfikator: 4

Wartości w polu enum
TIME_RANGE_UNSPECIFIED Nieokreślony zakres czasu.
TIME_RANGE_PAST_DAY Wczoraj.
TIME_RANGE_PAST_THREE_DAYS Ostatnie 3 dni (bez bieżącego dnia).
TIME_RANGE_PAST_WEEK Ostatni tydzień z wyłączeniem bieżącego dnia.

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 danych.
hourlyMetricValues[]

object (HourlyMetricValue)

Tylko dane wyjściowe. Lista wartości danych i ich sygnatur czasowych zaokrąglonych do najbliższej pełnej godziny.

MetricDetail

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

enum (MetricType)

Typ danych.
additionalDetails

map (key: string, value: string)

Pary klucz-wartość zawierające dodatkowe szczegóły dotyczące danych, np. „gateway”: „stripe”. Więcej informacji znajdziesz w sekcji

Obiekt zawierający listę par "key": value. 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 rodzajów danych wartość musi być nieujemną liczbą całkowitą.

Sygnatura czasowa

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

string (int64 format)

Reprezentuje sekundy czasu UTC od epoki uniksowej 1970-01-01T00:00:00Z. Musi mieścić się w przedziale od -62135596800 do 253402300799 (włącznie), co odpowiada zakresowi od 0001-01-01T00:00:00Z do 9999-12-31T23:59:59Z.
nanos

integer

Nieujemne ułamki sekundy z dokładnością do nanosekund. To pole zawiera część czasu trwania w nanosekundach, a nie alternatywę dla sekund. Ujemne wartości sekund z ułamkami nadal muszą 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.

MetricType

Rodzaj mierzonych danych.

Wartości w polu enum
METRIC_TYPE_UNSPECIFIED Nieokreślony typ wskaźnika.
FACILITATION_COUNT Liczba udanych ułatwień interfejsu GPay API.
VISIT_COUNT Liczba kliknięć przycisku interfejsu GPay API.
CONVERSION_RATE Współczynnik konwersji przycisku finalizacji zakupu, zdefiniowany jako stosunek liczby udanych transakcji zrealizowanych za pomocą interfejsu GPay API do liczby kliknięć przycisku interfejsu GPay API.

Adnotacje do narzędzi

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌