MCP Tools Reference: paydeveloper.googleapis.com

Strumento: query_merchant_error_metrics

Recupera le metriche di errore dettagliate per un profilo dell'attività di un commerciante specifico. Questo strumento fornisce una suddivisione granulare degli errori, consentendo agli sviluppatori di individuare e risolvere i problemi.

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP query_merchant_error_metrics.

Richiesta 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
}'

Schema di input

Messaggio di richiesta per l'esecuzione di query sulle metriche di errore del commerciante.

QueryMerchantErrorMetricsRequest

Rappresentazione JSON 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
Campi
merchantId

string

Obbligatorio. L'identificatore univoco del commerciante per il quale vengono richieste le metriche di errore.
timeRange

enum (TimeRange)

Facoltativo. L'intervallo di tempo dei dati delle metriche di errore.

TimeRange

L'intervallo di tempo dei dati. ID successivo: 4

Enum
TIME_RANGE_UNSPECIFIED Intervallo di tempo non specificato.
TIME_RANGE_PAST_DAY Il giorno precedente, ieri.
TIME_RANGE_PAST_THREE_DAYS Gli ultimi tre giorni, escluso il giorno corrente.
TIME_RANGE_PAST_WEEK La settimana precedente, escluso il giorno corrente.

Schema di output

Messaggio di risposta per l'esecuzione di query sulle metriche di errore del commerciante.

QueryMerchantErrorMetricsResponse

Rappresentazione JSON 
{
  "errorMetrics": [
    {
      object (MerchantErrorMetric)
    }
  ]
}
Campi
errorMetrics[]

object (MerchantErrorMetric)

I dati delle metriche di errore del commerciante.

MerchantErrorMetric

Rappresentazione JSON 
{
  "errorDetail": {
    object (ErrorDetail)
  },
  "hourlyErrorCounts": [
    {
      object (HourlyErrorCount)
    }
  ]
}
Campi
errorDetail

object (ErrorDetail)

Solo output. Dettagli dell'errore.
hourlyErrorCounts[]

object (HourlyErrorCount)

Solo output. Un elenco del conteggio degli errori e del relativo timestamp, arrotondato all'inizio dell'ora più vicina.

ErrorDetail

Rappresentazione JSON 
{
  "errorCode": string,
  "errorMessage": string
}
Campi
errorCode

string

Codice di errore, ad es. "OR_BIBED_07".
errorMessage

string

Solo messaggio descrittivo, senza dati utente né stack trace interni.

HourlyErrorCount

Rappresentazione JSON 
{
  "hourlyTimestamp": string,
  "count": integer
}
Campi
hourlyTimestamp

string (Timestamp format)

Timestamp che rappresenta l'inizio dell'ora.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
count

integer

Il numero di errori in questa ora.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi dell'ora UTC dall'epoca Unix 1970-01-01T00:00:00Z. Il valore deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni non negative di un secondo con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori dei secondi negativi con frazioni devono comunque avere valori di nanosecondi non negativi che contano in avanti nel tempo. Il valore deve essere compreso tra 0 e 999.999.999 inclusi.

Annotazioni dello strumento

Le annotazioni dello strumento vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client tratta questi suggerimenti come non attendibili, ma possono essere utilizzati per decidere quando inviare un prompt di conferma a un utente.

Oltre alla stringa del titolo, i seguenti suggerimenti booleani sono definiti come segue:

  • readOnlyHint: se true, lo strumento non modifica il suo ambiente. Valore predefinito: false.
  • destructiveHint: se true, lo strumento può eseguire azioni distruttive. Se false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.
  • idempotentHint: se true, la chiamata ripetuta dello strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.
  • openWorldHint: se true, lo strumento può interagire con un "open world" di entità esterne. Se false, lo strumento può interagire solo con entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria non lo sarebbe.

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌