MCP Tools Reference: paydeveloper.googleapis.com

Narzędzie: query_merchant_performance

Pobiera zagregowane dane o skuteczności na wysokim poziomie oraz dane po integracji dotyczące konkretnego profilu firmy sprzedawcy.

Poniższy przykładowy kod pokazuje, jak użyć narzędzia MCP query_merchant_performance za pomocą curl.

Żą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 MCP tool 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.

TimeRange

Zakres czasu danych. Następny identyfikator: 4

Wartości w polu enum
TIME_RANGE_UNSPECIFIED Nieokreślony zakres czasu.
TIME_RANGE_PAST_DAY Poprzedni dzień, czyli wczoraj.
TIME_RANGE_PAST_THREE_DAYS Ostatnie 3 dni, z wyłączeniem 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 informacje o danych, np. „gateway”: „stripe”. Więcej informacji znajdziesz

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 danych 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ść danych. W przypadku współczynnika konwersji wartość mieści się w zakresie [0, 1]. W przypadku innych danych wartość musi być nieujemną liczbą całkowitą.

Timestamp

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 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 z dokładnością do nanosekundy. To pole jest częścią 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ą się do przodu w czasie. Musi mieścić się w zakresie od 0 do 999 999 999 włącznie.

MetricType

Typ mierzonych danych.

Wartości w polu enum
METRIC_TYPE_UNSPECIFIED Nieokreślony typ danych.
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 ułatwień interfejsu GPay API do liczby kliknięć przycisku interfejsu GPay API.

Adnotacje narzędzia

Adnotacje narzędzia są wysyłane do klientów MCP, aby opisać podstawowe ryzyko związane z danym narzędziem. Większość klientów traktuje te wskazówki jako niezaufane, ale można ich użyć do określenia, kiedy należy wysłać do użytkownika prośbę o potwierdzenie.

Oprócz ciągu tytułu zdefiniowano te wskazówki logiczne:

  • readOnlyHint: jeśli ma wartość true, narzędzie nie modyfikuje swojego środowiska. Wartość domyślna: false.
  • destructiveHint: jeśli ma wartość true, narzędzie może wykonywać działania destrukcyjne. Jeśli ma wartość false, narzędzie może wykonywać tylko działania dodające. Wartość domyślna: true.
  • idempotentHint: jeśli ma wartość true, wielokrotne wywoływanie narzędzia z tymi samymi argumentami nie będzie miało dodatkowego wpływu na jego środowisko. Wartość domyślna: false.
  • openWorldHint: jeśli ma wartość true, narzędzie może wchodzić w interakcje z „otwartym światem” podmiotów zewnętrznych. Jeśli ma wartość false, narzędzie może wchodzić w interakcje tylko z podmiotami wewnętrznymi. Na przykład narzędzie do wyszukiwania w internecie byłoby narzędziem typu „otwarty świat”, a narzędzie do zarządzania pamięcią – nie.

Wskazówka destrukcyjna: ❌ | Wskazówka idempotentna: ✅ | Wskazówka tylko do odczytu: ✅ | Wskazówka „otwarty świat”: ❌