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 de code 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 MCP tool 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, jour actuel non compris.
TIME_RANGE_PAST_WEEK Semaine précédente, jour actuel non compris.

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 code temporel, arrondi à l'heure supérieure 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)

Code temporel de la valeur de la métrique, arrondi à l'heure supérieure 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.

Code temporel

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

Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients traitent ces indications comme non fiables, mais elles peuvent être utilisées pour déterminer quand une invite de confirmation peut être envoyée à un utilisateur.

Outre la chaîne de titre, les indications booléennes suivantes sont définies comme suit :

  • readOnlyHint : si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".
  • destructiveHint : si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions additives. Valeur par défaut : "true".
  • idempotentHint : si la valeur est "true", l'appel répété de l'outil avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".
  • openWorldHint : si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche sur le Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.

Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ✅ | Indication de monde ouvert : ❌