MCP Tools Reference: paydeveloper.googleapis.com

Outil : query_merchant_performance

Récupère des données agrégées de haut niveau sur les performances et des métriques post-intégration pour un profil d'établissement marchand spécifique.

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP query_merchant_performance.

Requête 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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schéma d'entrée

Message de requête pour interroger les données sur les performances du marchand.

QueryMerchantPerformanceRequest

Représentation JSON 
{
  "merchantId": string,
  "timeRange": enum (TimeRange)
}
Champs
merchantId

string

Obligatoire. Identifiant unique du marchand pour lequel des données sur les performances sont demandées.
timeRange

enum (TimeRange)

Facultatif. Période des données sur les performances.

TimeRange

Période des données. ID suivant : 4.

Enums
TIME_RANGE_UNSPECIFIED Période non spécifiée.
TIME_RANGE_PAST_DAY Jour précédent, hier.
TIME_RANGE_PAST_THREE_DAYS Trois jours précédents, à l'exclusion du jour actuel.
TIME_RANGE_PAST_WEEK Semaine précédente, à l'exclusion du jour actuel.

Schéma de sortie

Message de réponse pour interroger les performances du marchand.

QueryMerchantPerformanceResponse

Représentation JSON 
{
  "merchantPerformanceMetrics": [
    {
      object (MerchantPerformanceMetric)
    }
  ]
}
Champs
merchantPerformanceMetrics[]

object (MerchantPerformanceMetric)

Données sur les performances du marchand.

MerchantPerformanceMetric

Représentation JSON 
{
  "metricDetail": {
    object (MetricDetail)
  },
  "hourlyMetricValues": [
    {
      object (HourlyMetricValue)
    }
  ]
}
Champs
metricDetail

object (MetricDetail)

Uniquement en sortie. Détails de la métrique.
hourlyMetricValues[]

object (HourlyMetricValue)

Uniquement en sortie. Liste de la valeur de la métrique et de son horodatage, arrondi à l'heure la plus proche.

MetricDetail

Représentation JSON 
{
  "metricType": enum (MetricType),
  "additionalDetails": {
    string: string,
    ...
  }
}
Champs
metricType

enum (MetricType)

Type de métrique.
additionalDetails

map (key: string, value: string)

Paires clé/valeur pour tous les détails supplémentaires sur la métrique, par exemple "gateway": "stripe". Pour en savoir plus, consultez

Objet contenant une liste de "key": value paires. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

AdditionalDetailsEntry

Représentation JSON 
{
  "key": string,
  "value": string
}
Champs
key

string
value

string

HourlyMetricValue

Représentation JSON 
{
  "hourlyTimestamp": string,
  "value": number
}
Champs
hourlyTimestamp

string (Timestamp format)

Horodatage de la valeur de la métrique, arrondi à l'heure la plus proche.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
value

number

Valeur réelle de la métrique. Pour le taux de conversion, la valeur est comprise entre 0 et 1. Pour les autres métriques, la valeur est un entier non négatif.

Horodatage

Représentation JSON 
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. Doit être compris entre -62135596800 et 253402300799 inclus (ce qui correspond à 0001-01-01T00:00:00Z et 9999-12-31T23:59:59Z).
nanos

integer

Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie de la durée en nanosecondes, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. Doit être compris entre 0 et 999 999 999 inclus.

MetricType

Type de métrique mesurée.

Enums
METRIC_TYPE_UNSPECIFIED Type de métrique non spécifié.
FACILITATION_COUNT Nombre de facilitations réussies de l'API GPay.
VISIT_COUNT Nombre de clics sur le bouton de l'API GPay.
CONVERSION_RATE Taux de conversion du bouton de paiement, défini comme le rapport entre le nombre de facilitations réussies de l'API GPay et le nombre de clics sur le bouton de l'API GPay.

Annotations d'outil

Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ✅ | Indication Open World : ❌