MCP Tools Reference: paydeveloper.googleapis.com

Strumento: query_merchant_error_metrics

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

I seguenti esempi mostrano come utilizzare curl per richiamare 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 tool's MCP 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 L'ultima settimana, 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 una 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

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