MCP Tools Reference: paydeveloper.googleapis.com

Strumento: query_merchant_performance

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

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

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_performance",
    "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 sui 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.

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 sul 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'inizio dell'ora più vicina.

MetricDetail

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

enum (MetricType)

Tipo di metrica.
additionalDetails

map (key: string, value: string)

Coppie chiave-valore per eventuali dettagli aggiuntivi sulla metrica, ad es. "gateway": "stripe". Per i 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'inizio dell'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 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.

MetricType

Il tipo di metrica misurata.

Enum
METRIC_TYPE_UNSPECIFIED Tipo di metrica non specificato.
FACILITATION_COUNT Il numero di facilitazioni dell'API GPay riuscite.
VISIT_COUNT Il numero di clic sul pulsante dell'API GPay.
CONVERSION_RATE Il tasso di conversione del pulsante di checkout, definito come il rapporto tra il numero di facilitazioni dell'API GPay riuscite e il numero di clic sul pulsante dell'API GPay.

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, sono definiti i seguenti suggerimenti booleani:

  • 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: ❌