Ferramenta: update_merchant
Atualiza campos específicos de um comerciante. Os campos aceitos incluem display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email e customer_support_phone.
O exemplo de código a seguir mostra como usar curl para chamar a ferramenta MCP update_merchant.
| Solicitação 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 }' |
Esquema de entrada
Mensagem de solicitação para UpdateMerchant.
UpdateMerchantFacadeRequest
| Representação JSON |
|---|
{ "merchantId": string, // Union field |
| Campos | |
|---|---|
merchantId |
Obrigatório. O ID do comerciante a ser atualizado. |
Campo de união
|
|
displayName |
O nome de exibição do comerciante. |
Campo de união
|
|
mcc |
O MCC (código de categoria do comerciante) do comerciante. |
Campo de união
|
|
corporateWebsiteUrl |
O site corporativo do comerciante. |
Campo de união
|
|
customerSupportWebsiteUrl |
O site de suporte ao cliente da loja. |
Campo de união
|
|
customerSupportEmail |
O e-mail de suporte ao cliente do comerciante. |
Campo de união
|
|
customerSupportPhone |
O telefone de suporte ao cliente do comerciante. |
Mcc
O código de categoria do comerciante (MCC) de um comerciante.
| Tipos enumerados | |
|---|---|
OTHERS |
Outros |
MISC_FOOD_STORES |
Outras lojas de alimentos: lojas de conveniência e mercados especializados |
MISC_APPAREL |
Lojas de vestuário e acessórios diversos |
ARTISTS_SUPPLY |
Lojas de artesanato e materiais artísticos |
AUTOMOTIVE_PARTS |
Lojas de peças e acessórios automotivos |
HEALTH_AND_BEAUTY |
Centro de saúde e beleza |
BOOKS_PERIODICALS |
Livros, periódicos e jornais |
CAMERA_STORES |
Lojas de câmeras e acessórios fotográficos |
COMPUTERS_EQUIPMENT |
Computadores, equipamentos periféricos de computador, software |
COMPUTER_SOFTWARE |
Lojas de software de computador |
ELECTRONICS_SALES |
Vendas de eletrônicos |
GIFT_SHOPS |
Lojas de cartões, presentes, novidades e souvenirs |
EATING_PLACES |
Estabelecimentos para refeições e restaurantes |
MISC_GENERAL_MERCHANDISE |
Produtos gerais diversos |
HOME_SUPPLY |
Atacadistas de materiais para casa |
COMPUTER_NETWORK_SERVICES |
Serviços de rede de computadores |
DIGITAL_GOODS_MEDIA |
Produtos digitais: livros, filmes e músicas |
DIGITAL_GOODS_GAMES |
Produtos digitais: jogos |
DIGITAL_GOODS_APPLICATIONS |
Produtos digitais: aplicativos (exceto jogos) |
POLITICAL_ORGANIZATIONS |
Organizações políticas |
CHARITABLE_ORGANIZATIONS |
Organizações de serviços sociais e beneficentes |
DRUG_STORES |
Drogarias e farmácias |
REAL_ESTATE_RENTALS |
Corretores e agentes imobiliários - Aluguéis |
MISC_PERSONAL_SERVICES |
Serviços pessoais diversos, sem classificação em outro lugar |
SPORTING_GOODS |
Lojas de materiais esportivos |
STATIONERY_OFFICE_SUPPLIES |
Papelaria, artigos para escritório, impressão e redação |
THEATRICAL_TICKET_AGENCIES |
Agências de venda de ingressos de teatro |
TIMESHARES |
Participação acionária |
TOURIST_ATTRACTIONS |
Atrações e exposições turísticas |
HOBBY_TOY_GAME_SHOPS |
Lojas de brinquedos, jogos e hobbies |
PET_SHOPS |
Pet shops, lojas de alimentos e produtos para animais de estimação |
OTHER_LODGING |
Outros alojamentos: hotéis, motéis e resorts |
TELECOMMUNICATION_SERVICES |
Serviços de telecomunicações |
TRANSPORTATION_SERVICES |
Serviços de transporte |
OTHER_AIRLINES |
Outras companhias aéreas |
TRAVEL_AGENCIES |
Agências de viagem e operadoras de turismo |
GOVERNMENT_OWNED_LOTTERIES_US |
Loterias estatais (somente na região dos EUA) |
GOVERNMENT_LICENSED_CASINOS_US |
Cassinos on-line licenciados pelo governo (jogos de azar on-line) (somente na região dos EUA) |
BETTING |
Apostas (incluindo bilhetes de loteria, fichas de jogos de cassino, apostas fora das pistas e apostas) |
GOVERNMENT_OWNED_LOTTERIES_NON_US |
Loterias estatais (regiões fora dos EUA) |
Esquema de saída
Mensagem de resposta para UpdateMerchant.
UpdateMerchantResponse
| Representação JSON |
|---|
{
"state": enum ( |
| Campos | |
|---|---|
state |
O estado do comerciante atualizado. |
Estado
O estado de um comerciante.
| Tipos enumerados | |
|---|---|
STATE_UNSPECIFIED |
O estado do comerciante não foi especificado. |
VERIFIED |
O comerciante foi verificado e aprovado. |
IN_REVIEW |
A edição do perfil do comerciante está em análise. |
REJECTED |
A edição do perfil do comerciante é rejeitada. |
INCOMPLETE_SIGNUP |
O perfil do comerciante está incompleto. |
SANCTIONS_HIT |
O perfil do comerciante viola as sanções. |
READY_FOR_REVIEW |
O perfil do comerciante está completo e pronto para revisão. |
DISABLED |
O perfil do comerciante está desativado/inativo. |
Anotações de ferramentas
As anotações de ferramentas são enviadas aos clientes do MCP para descrever o risco básico de uma determinada ferramenta. A maioria dos clientes trata essas dicas como não confiáveis, mas elas podem ser usadas para decidir quando um pedido de confirmação pode ser enviado a um usuário.
Além da string de título, as seguintes dicas booleanas são definidas da seguinte maneira:
readOnlyHint: se for "true", a ferramenta não vai modificar o ambiente. (Padrão: falso).destructiveHint: se for "true", a ferramenta poderá realizar ações destrutivas. Se for "false", a ferramenta só poderá realizar ações de adição. Padrão: verdadeiro.idempotentHint: se for "true", chamar a ferramenta repetidamente com os mesmos argumentos não terá efeito adicional no ambiente dela. (Padrão: falso).openWorldHint: se for "true", a ferramenta poderá interagir com um "mundo aberto" de entidades externas. Se for "false", a ferramenta só poderá interagir com entidades internas. Por exemplo, uma ferramenta de pesquisa na Web seria de mundo aberto, enquanto uma ferramenta de memória não seria.
Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ❌ | Dica de mundo aberto: ❌