MCP Tools Reference: paydeveloper.googleapis.com

Strumento: query_merchant_performance

Recupera dati aggregati di alto livello sul rendimento e metriche post-integrazione per un profilo dell'attività del commerciante specifico.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP query_merchant_performance.

Curl Request 
                  
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
}'

Schema di input

Messaggio di richiesta per l'interrogazione dei dati sul rendimento del commerciante.

QueryMerchantPerformanceRequest

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

string

Obbligatorio. L'identificatore univoco del commerciante per il quale vengono richiesti i dati sul rendimento.
timeRange

enum (TimeRange)

Facoltativo. L'intervallo di tempo dei dati sul rendimento.

Schema di output

Messaggio di risposta per l'interrogazione del rendimento del commerciante.

QueryMerchantPerformanceResponse

Rappresentazione JSON 
{
  "merchantPerformanceMetrics": [
    {
      object (MerchantPerformanceMetric)
    }
  ]
}
Campi
merchantPerformanceMetrics[]

object (MerchantPerformanceMetric)

I dati sul rendimento del commerciante.

MerchantPerformanceMetric

Rappresentazione JSON 
{
  "metricDetail": {
    object (MetricDetail)
  },
  "hourlyMetricValues": [
    {
      object (HourlyMetricValue)
    }
  ]
}
Campi
metricDetail

object (MetricDetail)

Solo output. Dettagli della metrica.
hourlyMetricValues[]

object (HourlyMetricValue)

Solo output. Un elenco del valore della metrica e del relativo timestamp, arrotondato all'ora più vicina.

MetricDetail

Rappresentazione JSON 
{
  "metricType": enum (MetricType),
  "additionalDetails": {
    string: string,
    ...
  }
}
Campi
metricType

enum (MetricType)

Il tipo di metrica.
additionalDetails

map (key: string, value: string)

Coppie chiave-valore per eventuali dettagli aggiuntivi sulla metrica, ad es. "gateway": "stripe". Per maggiori dettagli, vedi

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

AdditionalDetailsEntry

Rappresentazione JSON 
{
  "key": string,
  "value": string
}
Campi
key

string
value

string

HourlyMetricValue

Rappresentazione JSON 
{
  "hourlyTimestamp": string,
  "value": number
}
Campi
hourlyTimestamp

string (Timestamp format)

Il timestamp del valore della metrica arrotondato all'ora più vicina.

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".
value

number

Il valore effettivo della metrica. Per il tasso di conversione, il valore è compreso nell'intervallo [0, 1]. Per le altre metriche, il valore è un numero intero non negativo.

Timestamp

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

string (int64 format)

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

integer

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

Annotazioni dello strumento

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