MCP Tools Reference: paydeveloper.googleapis.com

Narzędzie: list_merchants

Pobiera pełną listę wszystkich sprzedawców akceptujących Google Pay powiązanych z uwierzytelnionym kontem. W zależności od roli użytkownika w przypadku sprzedawcy administratorzy mogą wyświetlać pełne szczegółowe informacje o sprzedawcy, a deweloperzy tylko podstawowe informacje o sprzedawcy.

Poniższy przykładowy kod pokazuje, jak używać curl do wywoływania narzędzia list_merchants MCP.

Żądanie 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
}'

Schemat danych wejściowych

Prośba o wiadomość do sprzedawców, którzy mają informacje o produktach.

ListMerchantsRequest

Zapis JSON 
{
  "view": enum (MerchantView)
}
Pola
view

enum (MerchantView)

Opcjonalnie. Określa poziom szczegółowości informacji zwracanych dla każdego sprzedawcy.

MerchantView

Poziom szczegółowości informacji zwracanych w przypadku każdego sprzedawcy.

Wartości w polu enum
MERCHANT_VIEW_UNSPECIFIED Wartość domyślna lub nieokreślona. Interfejs API domyślnie wybierze widok PODSTAWOWY.
MERCHANT_VIEW_BASIC Podaj podstawowe informacje o sprzedawcy.
MERCHANT_VIEW_FULL Podaj wszystkie szczegóły dotyczące sprzedawcy.

Schemat wyjściowy

Wiadomość z odpowiedzią dla sprzedawców, którzy wystawiają produkty.

ListMerchantsResponse

Zapis JSON 
{
  "merchants": [
    {
      object (Merchant)
    }
  ]
}
Pola
merchants[]

object (Merchant)

Sprzedawcy, do których użytkownik ma dostęp.

Sprzedawca

Zapis JSON 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
Pola
merchantId

string

Tylko dane wyjściowe. Unikalny identyfikator sprzedawcy.
displayName

string

Wymagane. Wyświetlana nazwa sprzedawcy.
regionCode

string

Wymagane. Kod regionu adresu sklepu sprzedawcy. Format to kody regionów Unicode CLDR, np. „US”. Indie („IN”) nie są obsługiwane.
mcc

enum (Mcc)

Wymagane. Kod kategorii sprzedawcy (MCC).
corporateWebsiteUrl

string

Wymagane. Witryna firmowa sprzedawcy.
customerSupportWebsiteUrl

string

Wymagane. strona obsługi klienta sprzedawcy;
customerSupportEmail

string

Wymagane. Adres e-mail obsługi klienta sprzedawcy.
customerSupportPhone

string

Wymagane. Numer telefonu obsługi klienta sprzedawcy.
state

enum (State)

Tylko dane wyjściowe. Stan sprzedawcy.

MCC

Kod kategorii sprzedawcy (MCC).

Wartości w polu enum
OTHERS Inne
MISC_FOOD_STORES Różne sklepy spożywcze – sklepy osiedlowe i sklepy specjalistyczne
MISC_APPAREL Różne sklepy z odzieżą i akcesoriami
ARTISTS_SUPPLY Sklepy z artykułami dla artystów i rzemieślników
AUTOMOTIVE_PARTS Sklepy z częściami i akcesoriami samochodowymi
HEALTH_AND_BEAUTY Sklep z produktami dla zdrowia i urody
BOOKS_PERIODICALS Książki, czasopisma i gazety
CAMERA_STORES Sklepy z aparatami fotograficznymi i powiązanymi materiałami eksploatacyjnymi
COMPUTERS_EQUIPMENT Komputery, komputerowe urządzenia peryferyjne, oprogramowanie
COMPUTER_SOFTWARE Sklepy z oprogramowaniem komputerowym
ELECTRONICS_SALES Sprzedaż elektroniki
GIFT_SHOPS Sklepy z kartkami, upominkami, nowościami i pamiątkami
EATING_PLACES Lokale gastronomiczne i restauracje
MISC_GENERAL_MERCHANDISE Różne towary
HOME_SUPPLY Sklepy z wyposażeniem domu
COMPUTER_NETWORK_SERVICES Usługi sieci komputerowych
DIGITAL_GOODS_MEDIA Produkty cyfrowe: książki, filmy, muzyka
DIGITAL_GOODS_GAMES Produkty cyfrowe: gry
DIGITAL_GOODS_APPLICATIONS Produkty cyfrowe: aplikacje (z wyjątkiem gier)
POLITICAL_ORGANIZATIONS Organizacje polityczne
CHARITABLE_ORGANIZATIONS Organizacje charytatywne i organizacje pomocy społecznej
DRUG_STORES Drogerie i apteki
REAL_ESTATE_RENTALS Agencje i zarządcy nieruchomości – wynajem
MISC_PERSONAL_SERVICES Różne usługi osobiste niesklasyfikowane w innych miejscach
SPORTING_GOODS Sklepy sportowe
STATIONERY_OFFICE_SUPPLIES Materiały papiernicze i biurowe, papier do drukowania i pisania
THEATRICAL_TICKET_AGENCIES Agencje sprzedaży biletów do teatrów
TIMESHARES Własność współużytkowana
TOURIST_ATTRACTIONS Atrakcje turystyczne i wystawy
HOBBY_TOY_GAME_SHOPS Sklepy z artykułami hobbystycznymi, zabawkami i grami
PET_SHOPS Sklepy zoologiczne, sklepy z karmą i akcesoriami dla zwierząt
OTHER_LODGING Inne miejsca zakwaterowania – hotele, motele, ośrodki wypoczynkowe
TELECOMMUNICATION_SERVICES Usługi telekomunikacyjne
TRANSPORTATION_SERVICES Usługi transportowe
OTHER_AIRLINES Inne linie lotnicze
TRAVEL_AGENCIES Biura podróży i operatorzy wycieczek
GOVERNMENT_OWNED_LOTTERIES_US Loterie państwowe (tylko w Stanach Zjednoczonych)
GOVERNMENT_LICENSED_CASINOS_US Licencjonowane przez rząd kasyna online (hazard online) (tylko w Stanach Zjednoczonych)
BETTING Zakłady (w tym kupony loteryjne, żetony do gier kasynowych, zakłady poza torem wyścigowym i zakłady pieniężne)
GOVERNMENT_OWNED_LOTTERIES_NON_US Loterie państwowe (region spoza Stanów Zjednoczonych)

Stan

Stan sprzedawcy.

Wartości w polu enum
STATE_UNSPECIFIED Stan sprzedawcy jest nieokreślony.
VERIFIED Sprzedawca został zweryfikowany i zatwierdzony.
IN_REVIEW Zmiana w profilu sprzedawcy jest w trakcie sprawdzania.
REJECTED Zmiana w profilu sprzedawcy została odrzucona.
INCOMPLETE_SIGNUP Profil sprzedawcy jest niekompletny.
SANCTIONS_HIT Profil sprzedawcy narusza sankcje.
READY_FOR_REVIEW Profil sprzedawcy jest kompletny i gotowy do sprawdzenia.
DISABLED Profil sprzedawcy jest wyłączony lub nieaktywny.

Adnotacje narzędzi

Adnotacje narzędzia są wysyłane do klientów MCP, aby opisać podstawowe ryzyko związane z danym narzędziem. Większość klientów traktuje te wskazówki jako niezaufane, ale można ich używać do decydowania, kiedy wysłać użytkownikowi prośbę o potwierdzenie.

Oprócz ciągu znaków tytułu zdefiniowano te wskazówki logiczne:

  • readOnlyHint: jeśli wartość jest prawdziwa, narzędzie nie modyfikuje swojego środowiska. Wartość domyślna: fałsz.
  • destructiveHint: jeśli ma wartość Prawda, narzędzie może wykonywać działania destrukcyjne. Jeśli ma wartość „false”, narzędzie może wykonywać tylko działania addytywne. Wartość domyślna: true.
  • idempotentHint: jeśli wartość to „true”, wielokrotne wywoływanie narzędzia z tymi samymi argumentami nie będzie miało dodatkowego wpływu na jego środowisko. Wartość domyślna: fałsz.
  • openWorldHint: jeśli wartość to „true”, narzędzie może wchodzić w interakcje z „otwartym światem” podmiotów zewnętrznych. Jeśli wartość jest fałszywa, narzędzie może wchodzić w interakcje tylko z podmiotami wewnętrznymi. Na przykład narzędzie do wyszukiwania w internecie byłoby narzędziem typu otwarty świat, a narzędzie do zapamiętywania nie.

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌