Strumento: update_merchant
Aggiorna campi specifici di un commerciante esistente. I campi supportati includono display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email e customer_support_phone.
Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP update_merchant.
| Richiesta 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 }' |
Schema di input
Messaggio di richiesta per UpdateMerchant.
UpdateMerchantFacadeRequest
| Rappresentazione JSON |
|---|
{ "merchantId": string, // Union field |
| Campi | |
|---|---|
merchantId |
Obbligatorio. L'ID del commerciante da aggiornare. |
Campo unione
|
|
displayName |
Il nome visualizzato del commerciante. |
Campo unione
|
|
mcc |
Il codice MCC (Merchant Category Code) del commerciante. |
Campo unione
|
|
corporateWebsiteUrl |
Il sito web aziendale del commerciante. |
Campo unione
|
|
customerSupportWebsiteUrl |
Il sito web dell'assistenza clienti del commerciante. |
Campo unione
|
|
customerSupportEmail |
L'email dell'assistenza clienti del commerciante. |
Campo unione
|
|
customerSupportPhone |
Il numero di telefono dell'assistenza clienti del commerciante. |
Mcc
Il codice di categoria commerciante (Merchant Category Code, MCC) di un commerciante.
| Enum | |
|---|---|
OTHERS |
Altri |
MISC_FOOD_STORES |
Negozi di alimentari vari: minimarket e mercati specializzati |
MISC_APPAREL |
Negozi di abbigliamento e accessori vari |
ARTISTS_SUPPLY |
Negozi di forniture per artisti e artigianato |
AUTOMOTIVE_PARTS |
Negozi di ricambi e accessori per auto |
HEALTH_AND_BEAUTY |
Negozio di prodotti di bellezza e per il benessere |
BOOKS_PERIODICALS |
Libri, periodici e quotidiani |
CAMERA_STORES |
Negozi di fotocamere e forniture fotografiche |
COMPUTERS_EQUIPMENT |
Computer, apparecchiature periferiche per computer, software |
COMPUTER_SOFTWARE |
Negozi di software per computer |
ELECTRONICS_SALES |
Vendite di elettronica |
GIFT_SHOPS |
Negozi di carte, regali, novità e souvenir |
EATING_PLACES |
Ristoranti e luoghi dove mangiare |
MISC_GENERAL_MERCHANDISE |
Prodotti generici vari |
HOME_SUPPLY |
Negozi magazzino di forniture per la casa |
COMPUTER_NETWORK_SERVICES |
Servizi di rete per computer |
DIGITAL_GOODS_MEDIA |
Prodotti digitali: libri, film, musica |
DIGITAL_GOODS_GAMES |
Prodotti digitali: giochi |
DIGITAL_GOODS_APPLICATIONS |
Prodotti digitali: applicazioni (esclusi i giochi) |
POLITICAL_ORGANIZATIONS |
Organizzazioni politiche |
CHARITABLE_ORGANIZATIONS |
Organizzazioni di beneficenza e di servizi sociali |
DRUG_STORES |
Farmacie e negozi di generi vari |
REAL_ESTATE_RENTALS |
Agenti immobiliari e gestori - Affitti |
MISC_PERSONAL_SERVICES |
Servizi personali vari, non classificati altrove |
SPORTING_GOODS |
Negozi di articoli sportivi |
STATIONERY_OFFICE_SUPPLIES |
Cancelleria, forniture per ufficio, carta per stampa e scrittura |
THEATRICAL_TICKET_AGENCIES |
Agenzie di biglietti teatrali |
TIMESHARES |
Multiproprietà |
TOURIST_ATTRACTIONS |
Attrazioni turistiche e mostre |
HOBBY_TOY_GAME_SHOPS |
Negozi di hobby, giocattoli e giochi |
PET_SHOPS |
Negozi di animali, alimenti e forniture per animali |
OTHER_LODGING |
Altri alloggi: hotel, motel, resort |
TELECOMMUNICATION_SERVICES |
Servizi di telecomunicazione |
TRANSPORTATION_SERVICES |
Servizi di trasporto |
OTHER_AIRLINES |
Altre compagnie aeree |
TRAVEL_AGENCIES |
Agenzie di viaggi e tour operator |
GOVERNMENT_OWNED_LOTTERIES_US |
Lotterie di proprietà statale (solo regione USA) |
GOVERNMENT_LICENSED_CASINOS_US |
Casinò online con licenza governativa (giochi e scommesse online) (solo regione Stati Uniti) |
BETTING |
Scommesse (inclusi biglietti della lotteria, chip per giochi da casinò, scommesse ippiche e puntate) |
GOVERNMENT_OWNED_LOTTERIES_NON_US |
Lotterie di proprietà statale (regione non statunitense) |
Schema di output
Messaggio di risposta per UpdateMerchant.
UpdateMerchantResponse
| Rappresentazione JSON |
|---|
{
"state": enum ( |
| Campi | |
|---|---|
state |
Lo stato del commerciante aggiornato. |
Stato
La condizione di un mercante.
| Enum | |
|---|---|
STATE_UNSPECIFIED |
Lo stato del commerciante non è specificato. |
VERIFIED |
Il commerciante è verificato e approvato. |
IN_REVIEW |
La modifica del profilo commerciante è in corso di revisione. |
REJECTED |
La modifica del profilo del commerciante viene rifiutata. |
INCOMPLETE_SIGNUP |
Il profilo commerciante non è completo. |
SANCTIONS_HIT |
Il profilo commerciante è soggetto a sanzioni. |
READY_FOR_REVIEW |
Il profilo del commerciante è completo e pronto per la revisione. |
DISABLED |
Il profilo commerciante è disattivato/inattivo. |
Annotazioni dello strumento
Le annotazioni dello strumento vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client considera questi suggerimenti non attendibili, ma possono essere utilizzati per decidere quando inviare a un utente una richiesta di conferma.
Oltre alla stringa del titolo, sono definiti i seguenti suggerimenti booleani:
readOnlyHint: se è true, lo strumento non modifica il suo ambiente. Valore predefinito: false.destructiveHint: se è true, lo strumento può eseguire azioni distruttive. Se il valore è false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.idempotentHint: se è true, chiamare ripetutamente lo strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.openWorldHint: se è true, lo strumento può interagire con un "open world" di entità esterne. Se è false, lo strumento può interagire solo con le entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria no.
Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ❌ | Suggerimento open world: ❌