MCP Tools Reference: paydeveloper.googleapis.com

Outil : list_merchants

Récupère une liste complète de tous les marchands Google Pay associés au compte authentifié. Selon le rôle de l'utilisateur dans un compte marchand, les administrateurs peuvent afficher des informations détaillées complètes sur le marchand, tandis que les développeurs ne peuvent afficher que des informations de base.

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP list_merchants.

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": "list_merchants",
    "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 lister les marchands.

ListMerchantsRequest

Représentation JSON 
{
  "view": enum (MerchantView)
}
Champs
view

enum (MerchantView)

Facultatif. Spécifie le niveau de détail à renvoyer pour chaque marchand.

MerchantView

Niveau de détail à renvoyer pour chaque marchand.

Enums
MERCHANT_VIEW_UNSPECIFIED Valeur par défaut / non définie. L'API affichera par défaut la vue BASIC.
MERCHANT_VIEW_BASIC Incluez des informations de base sur le marchand.
MERCHANT_VIEW_FULL Incluez tous les détails concernant le marchand.

Schéma de sortie

Message de réponse pour la liste des marchands.

ListMerchantsResponse

Représentation JSON 
{
  "merchants": [
    {
      object (Merchant)
    }
  ]
}
Champs
merchants[]

object (Merchant)

Marchands auxquels l'utilisateur a accès.

Marchand

Représentation JSON 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
Champs
merchantId

string

Uniquement en sortie. Identifiant unique du marchand.
displayName

string

Obligatoire. Nom à afficher du marchand.
regionCode

string

Obligatoire. Code de région de l'établissement du marchand. Le format correspond aux codes de région CLDR Unicode (par exemple, "US"). L'Inde ("IN") n'est pas acceptée.
mcc

enum (Mcc)

Obligatoire. Code de catégorie du marchand (MCC).
corporateWebsiteUrl

string

Obligatoire. Site Web de l'entreprise du marchand.
customerSupportWebsiteUrl

string

Obligatoire. Site Web du service client du marchand.
customerSupportEmail

string

Obligatoire. Adresse e-mail du service client du marchand.
customerSupportPhone

string

Obligatoire. Numéro de téléphone du service client du marchand.
state

enum (State)

Uniquement en sortie. État du marchand.

Mcc

Code de catégorie du marchand (CCM).

Enums
OTHERS Autres
MISC_FOOD_STORES Magasins d'alimentation divers : supérettes et marchés spécialisés
MISC_APPAREL Boutiques de vêtements et d'accessoires divers
ARTISTS_SUPPLY Magasins de fournitures artistiques et de loisirs créatifs
AUTOMOTIVE_PARTS Magasins de pièces et accessoires automobiles
HEALTH_AND_BEAUTY Boutique de santé et beauté
BOOKS_PERIODICALS Livres, périodiques et journaux
CAMERA_STORES Magasins d'appareils photo et de matériel photographique
COMPUTERS_EQUIPMENT Ordinateurs, périphériques informatiques, logiciels
COMPUTER_SOFTWARE Magasins de logiciels informatiques
ELECTRONICS_SALES Ventes d'appareils électroniques
GIFT_SHOPS Magasins de cartes, de cadeaux, de gadgets et de souvenirs
EATING_PLACES Restaurants et lieux de restauration
MISC_GENERAL_MERCHANDISE Divers articles généraux
HOME_SUPPLY Magasins d'aménagement de la maison
COMPUTER_NETWORK_SERVICES Services de réseau informatique
DIGITAL_GOODS_MEDIA Biens numériques : livres, films, musique
DIGITAL_GOODS_GAMES Produits numériques : jeux
DIGITAL_GOODS_APPLICATIONS Biens numériques : applications (hors jeux)
POLITICAL_ORGANIZATIONS Organisations politiques
CHARITABLE_ORGANIZATIONS Organisations caritatives et de services sociaux
DRUG_STORES Pharmacies et parapharmacies
REAL_ESTATE_RENTALS Agents et gestionnaires immobiliers : locations
MISC_PERSONAL_SERVICES Services personnels divers, non classés ailleurs
SPORTING_GOODS Magasins d'articles de sports
STATIONERY_OFFICE_SUPPLIES Papeterie, fournitures de bureau, papier pour l'impression et l'écriture
THEATRICAL_TICKET_AGENCIES Agences de billetterie pour les salles de cinéma
TIMESHARES Immobilier en multipropriété
TOURIST_ATTRACTIONS Attractions et expositions touristiques
HOBBY_TOY_GAME_SHOPS Magasins de loisirs, de jouets et de jeux
PET_SHOPS Animaleries, magasins d'aliments et d'accessoires pour animaux
OTHER_LODGING Autres hébergements : hôtels, motels, complexes touristiques
TELECOMMUNICATION_SERVICES Services de télécommunication
TRANSPORTATION_SERVICES Services de transport
OTHER_AIRLINES Autres compagnies aériennes
TRAVEL_AGENCIES Agences de voyages et voyagistes
GOVERNMENT_OWNED_LOTTERIES_US Loteries appartenant à l'État (région des États-Unis uniquement)
GOVERNMENT_LICENSED_CASINOS_US Casinos en ligne agréés par le gouvernement (jeux d'argent et de hasard en ligne) (région des États-Unis uniquement)
BETTING Paris (y compris les billets de loterie, les jetons de jeux de casino, les paris hors course et les mises)
GOVERNMENT_OWNED_LOTTERIES_NON_US Loteries appartenant à l'État (hors États-Unis)

État

État d'un marchand.

Enums
STATE_UNSPECIFIED L'état du marchand n'est pas spécifié.
VERIFIED Le marchand est validé et approuvé.
IN_REVIEW La modification du profil de marchand est en cours d'examen.
REJECTED La modification de la fiche du marchand est refusée.
INCOMPLETE_SIGNUP Le profil du marchand est incomplet.
SANCTIONS_HIT Le profil de marchand est soumis à des sanctions.
READY_FOR_REVIEW Le profil du marchand est complet et prêt à être examiné.
DISABLED Le profil du marchand est désactivé/inactif.

Annotations d'outils

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 indices comme non fiables, mais ils peuvent être utilisés pour déterminer quand un message de confirmation peut être envoyé à un utilisateur.

En plus de 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 d'ajout. Valeur par défaut : "true".
  • idempotentHint : si la valeur est "true", appeler l'outil à plusieurs reprises 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 Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.

Indication destructive : ❌ | Indication d'idempotence : ✅ | Indication de lecture seule : ✅ | Indication de monde ouvert : ❌