MCP Tools Reference: paydeveloper.googleapis.com

Narzędzie: update_merchant

Aktualizuje określone pola istniejącego sprzedawcy. Obsługiwane pola to display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email i customer_support_phone.

Poniższy przykładowy kod pokazuje, jak używać curl do wywoływania narzędzia update_merchant 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": "update_merchant",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schemat danych wejściowych

Komunikat żądania dla UpdateMerchant.

UpdateMerchantFacadeRequest

Zapis JSON
{
  "merchantId": string,

  // Union field _display_name can be only one of the following:
  "displayName": string
  // End of list of possible types for union field _display_name.

  // Union field _mcc can be only one of the following:
  "mcc": enum (Mcc)
  // End of list of possible types for union field _mcc.

  // Union field _corporate_website_url can be only one of the following:
  "corporateWebsiteUrl": string
  // End of list of possible types for union field _corporate_website_url.

  // Union field _customer_support_website_url can be only one of the following:
  "customerSupportWebsiteUrl": string
  // End of list of possible types for union field _customer_support_website_url.

  // Union field _customer_support_email can be only one of the following:
  "customerSupportEmail": string
  // End of list of possible types for union field _customer_support_email.

  // Union field _customer_support_phone can be only one of the following:
  "customerSupportPhone": string
  // End of list of possible types for union field _customer_support_phone.
}
Pola
merchantId

string

Wymagane. Identyfikator sprzedawcy, którego chcesz zaktualizować.

Pole zbiorcze _display_name.

Pole _display_name może mieć tylko jedną z tych wartości:

displayName

string

Wyświetlana nazwa sprzedawcy.

Pole zbiorcze _mcc.

Pole _mcc może mieć tylko jedną z tych wartości:

mcc

enum (Mcc)

Kod kategorii sprzedawcy (MCC).

Pole zbiorcze _corporate_website_url.

Pole _corporate_website_url może mieć tylko jedną z tych wartości:

corporateWebsiteUrl

string

Witryna firmowa sprzedawcy.

Pole zbiorcze _customer_support_website_url.

Pole _customer_support_website_url może mieć tylko jedną z tych wartości:

customerSupportWebsiteUrl

string

strona obsługi klienta sprzedawcy;

Pole zbiorcze _customer_support_email.

Pole _customer_support_email może mieć tylko jedną z tych wartości:

customerSupportEmail

string

Adres e-mail obsługi klienta sprzedawcy.

Pole zbiorcze _customer_support_phone.

Pole _customer_support_phone może mieć tylko jedną z tych wartości:

customerSupportPhone

string

Telefoniczna obsługa klienta 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 Home Supply Warehouse
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 Artykuły papiernicze, artykuły 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)

Schemat wyjściowy

Wiadomość odpowiedzi dla UpdateMerchant.

UpdateMerchantResponse

Zapis JSON
{
  "state": enum (State)
}
Pola
state

enum (State)

Stan zaktualizowanego sprzedawcy.

Stan

Stan kupca.

Wartości w polu enum
STATE_UNSPECIFIED Stan handlowy 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: ❌