Tool: list_merchants
Ruft eine umfassende Liste aller Google Pay-Händler ab, die mit dem authentifizierten Konto verknüpft sind. Je nach Rolle des Nutzers bei einem Händler können Administratoren detaillierte Händlerinformationen einsehen, während Entwickler nur grundlegende Händlerinformationen sehen können.
Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool list_merchants aufrufen.
| Curl-Anfrage |
|---|
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 }' |
Eingabeschema
Anfragenachricht für die Auflistung von Händlern
ListMerchantsRequest
| JSON-Darstellung |
|---|
{
"view": enum ( |
| Felder | |
|---|---|
view |
Optional. Gibt die Detailtiefe an, die für jeden Händler zurückgegeben werden soll. |
MerchantView
Der Detaillierungsgrad, der für jeden Händler zurückgegeben werden soll.
| Enums | |
|---|---|
MERCHANT_VIEW_UNSPECIFIED |
Der Standardwert bzw. der nicht festgelegte Wert. Die API verwendet standardmäßig die BASIC-Ansicht. |
MERCHANT_VIEW_BASIC |
Geben Sie grundlegende Informationen zum Händler an. |
MERCHANT_VIEW_FULL |
Geben Sie alle Details zum Händler an. |
Ausgabeschema
Antwortnachricht für die Auflistung von Händlern.
ListMerchantsResponse
| JSON-Darstellung |
|---|
{
"merchants": [
{
object ( |
| Felder | |
|---|---|
merchants[] |
Die Händler, auf die der Nutzer Zugriff hat. |
Händler
| JSON-Darstellung |
|---|
{ "merchantId": string, "displayName": string, "regionCode": string, "mcc": enum ( |
| Felder | |
|---|---|
merchantId |
Nur Ausgabe. Die eindeutige Kennung des Händlers. |
displayName |
Erforderlich. Der Anzeigename des Händlers. |
regionCode |
Erforderlich. Der Ländercode des Standorts des Händlers. Das Format entspricht den Unicode-CLDR-Regionscodes, z.B. „US“. Indien („IN“) wird nicht unterstützt. |
mcc |
Erforderlich. Der Händlerkategoriecode (Merchant Category Code – MCC) des Händlers. |
corporateWebsiteUrl |
Erforderlich. Die Unternehmenswebsite des Händlers. |
customerSupportWebsiteUrl |
Erforderlich. Die Kundensupportwebsite des Händlers. |
customerSupportEmail |
Erforderlich. Die E‑Mail-Adresse des Kundensupports des Händlers. |
customerSupportPhone |
Erforderlich. Die Telefonnummer des Kundensupports des Händlers. |
state |
Nur Ausgabe. Der Status des Händlers. |
Mcc
Der Händlerkategoriecode (Merchant Category Code – MCC) eines Händlers.
| Enums | |
|---|---|
OTHERS |
Sonstiges |
MISC_FOOD_STORES |
Sonstige Lebensmittelgeschäfte – Minimärkte und Fachmärkte |
MISC_APPAREL |
Sonstige Geschäfte für Bekleidung und Accessoires |
ARTISTS_SUPPLY |
Geschäfte für Künstlerbedarf und Bastelbedarf |
AUTOMOTIVE_PARTS |
Geschäfte für Kfz-Teile und -Zubehör |
HEALTH_AND_BEAUTY |
Laden für Gesundheits- und Schönheitsprodukte |
BOOKS_PERIODICALS |
Bücher, Zeitschriften und Zeitungen |
CAMERA_STORES |
Kamera- und Fotogeschäfte |
COMPUTERS_EQUIPMENT |
Computer, Computer-Peripheriegeräte, Software |
COMPUTER_SOFTWARE |
Geschäfte für Computersoftware |
ELECTRONICS_SALES |
Verkauf von Elektronikartikeln |
GIFT_SHOPS |
Kartenläden, Geschenkartikel-, Neuheiten- und Souvenirläden |
EATING_PLACES |
Gastronomie und Restaurants |
MISC_GENERAL_MERCHANDISE |
Sonstige Handelsartikel |
HOME_SUPPLY |
Großmärkte für Haushaltswaren |
COMPUTER_NETWORK_SERVICES |
Computernetzwerkdienste |
DIGITAL_GOODS_MEDIA |
Digitale Waren: Bücher, Filme, Musik |
DIGITAL_GOODS_GAMES |
Digitale Waren: Spiele |
DIGITAL_GOODS_APPLICATIONS |
Digitale Waren: Apps (ohne Spiele) |
POLITICAL_ORGANIZATIONS |
Politische Organisationen |
CHARITABLE_ORGANIZATIONS |
Wohltätigkeits- und Sozialorganisationen |
DRUG_STORES |
Drogerien und Apotheken |
REAL_ESTATE_RENTALS |
Immobilienmakler und ‑verwalter – Vermietungen |
MISC_PERSONAL_SERVICES |
Sonstige persönliche Dienstleistungen, anderweitig nicht klassifiziert |
SPORTING_GOODS |
Sportartikelgeschäfte |
STATIONERY_OFFICE_SUPPLIES |
Schreibwaren, Bürobedarf, Druck- und Schreibpapier |
THEATRICAL_TICKET_AGENCIES |
Verkaufsstellen für Kinotickets |
TIMESHARES |
Timeshare-Anteile |
TOURIST_ATTRACTIONS |
Sehenswürdigkeiten und Ausstellungen |
HOBBY_TOY_GAME_SHOPS |
Hobby-, Spielzeug- und Spieleläden |
PET_SHOPS |
Tierhandlungen, Geschäfte für Haustiernahrung und ‑zubehör |
OTHER_LODGING |
Andere Unterkünfte – Hotels, Motels, Resorts |
TELECOMMUNICATION_SERVICES |
Telekommunikationsdienste |
TRANSPORTATION_SERVICES |
Transportdienste |
OTHER_AIRLINES |
Andere Fluggesellschaften |
TRAVEL_AGENCIES |
Reisebüros und Reiseveranstalter |
GOVERNMENT_OWNED_LOTTERIES_US |
Staatliche Lotterien (nur USA) |
GOVERNMENT_LICENSED_CASINOS_US |
Von der Regierung lizenzierte Onlinecasinos (Online-Glücksspiel) (nur USA) |
BETTING |
Wetten (einschließlich Lotterielose, Casinospielchips, Pferdewetten und Wetteinsätze) |
GOVERNMENT_OWNED_LOTTERIES_NON_US |
Staatliche Lotterien (außerhalb der USA) |
Bundesland
Der Status eines Händlers.
| Enums | |
|---|---|
STATE_UNSPECIFIED |
Der Händlerstatus ist nicht angegeben. |
VERIFIED |
Der Händler ist verifiziert und genehmigt. |
IN_REVIEW |
Die Änderung des Händlerprofils wird überprüft. |
REJECTED |
Die Änderung des Händlerprofils wird abgelehnt. |
INCOMPLETE_SIGNUP |
Das Händlerprofil ist unvollständig. |
SANCTIONS_HIT |
Das Händlerprofil verstößt gegen Sanktionen. |
READY_FOR_REVIEW |
Das Händlerprofil ist vollständig und kann überprüft werden. |
DISABLED |
Das Händlerprofil ist deaktiviert oder inaktiv. |
Tool-Annotationen
Tool-Anmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet wird.
Zusammen mit dem Titelstring sind die folgenden booleschen Hinweise definiert:
readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: false.destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: true.idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: false.openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Einheiten interagieren. Wenn „false“, kann das Tool nur mit internen Einheiten interagieren. Ein Web-Suchtool wäre beispielsweise frei verfügbar, ein Memory-Tool jedoch nicht.
Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌