MCP Tools Reference: paydeveloper.googleapis.com

Narzędzie: query_merchant_error_metrics

Pobiera szczegółowe dane o błędach dotyczące konkretnego profilu firmy sprzedawcy. To narzędzie zapewnia szczegółowy podział błędów, co pozwala deweloperom precyzyjnie określać i rozwiązywać problemy.

Poniższy przykładowy kod pokazuje, jak użyć curl, aby wywołać narzędzie MCP query_merchant_error_metrics.

Żą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_error_metrics",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schemat wejściowy

Komunikat z żądaniem dotyczącym danych o błędach sprzedawcy.

QueryMerchantErrorMetricsRequest

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

string

Wymagane. Unikalny identyfikator sprzedawcy, dla którego żądane są dane o błędach.
timeRange

enum (TimeRange)

Opcjonalnie. Zakres czasu danych o błędach.

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 Poprzednie 3 dni, z wyłączeniem bieżącego dnia.
TIME_RANGE_PAST_WEEK Poprzedni tydzień, z wyłączeniem bieżącego dnia.

Schemat wyjściowy

Komunikat z odpowiedzią na żądanie dotyczące danych o błędach sprzedawcy.

QueryMerchantErrorMetricsResponse

Zapis JSON 
{
  "errorMetrics": [
    {
      object (MerchantErrorMetric)
    }
  ]
}
Pola
errorMetrics[]

object (MerchantErrorMetric)

Dane o błędach sprzedawcy.

MerchantErrorMetric

Zapis JSON 
{
  "errorDetail": {
    object (ErrorDetail)
  },
  "hourlyErrorCounts": [
    {
      object (HourlyErrorCount)
    }
  ]
}
Pola
errorDetail

object (ErrorDetail)

Tylko dane wyjściowe. Szczegóły błędu.
hourlyErrorCounts[]

object (HourlyErrorCount)

Tylko dane wyjściowe. Lista liczby błędów i ich sygnatur czasowych zaokrąglonych do najbliższej pełnej godziny.

ErrorDetail

Zapis JSON 
{
  "errorCode": string,
  "errorMessage": string
}
Pola
errorCode

string

Kod błędu, np. „OR_BIBED_07”.
errorMessage

string

Tylko komunikat opisowy, bez danych użytkownika ani wewnętrznych śladów stosu.

HourlyErrorCount

Zapis JSON 
{
  "hourlyTimestamp": string,
  "count": integer
}
Pola
hourlyTimestamp

string (Timestamp format)

Sygnatura czasowa reprezentująca początek 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".
count

integer

Liczba błędów w tej godzinie.

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 zakresowi 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 wyrażoną 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

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 zdefiniowane są 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 dotycząca działań destrukcyjnych: ❌ | Wskazówka dotycząca idempotentności: ✅ | Wskazówka dotycząca tylko odczytu: ✅ | Wskazówka dotycząca otwartego świata: ❌