MCP Tools Reference: paydeveloper.googleapis.com

Ferramenta: list_merchants

Recupera uma lista abrangente de todos os comerciantes do Google Pay associados à conta autenticada. Dependendo da função do usuário em um comerciante, os administradores podem acessar informações detalhadas completas, enquanto os desenvolvedores só podem acessar informações básicas.

O exemplo de código a seguir mostra como usar curl para chamar a ferramenta MCP list_merchants.

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": "list_merchants",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensagem de solicitação para listar comerciantes.

ListMerchantsRequest

Representação JSON 
{
  "view": enum (MerchantView)
}
Campos
view

enum (MerchantView)

Opcional. Especifica o nível de detalhe a ser retornado para cada comerciante.

MerchantView

O nível de detalhes a serem retornados para cada comerciante.

Tipos enumerados
MERCHANT_VIEW_UNSPECIFIED O valor padrão / não definido. O padrão da API será a visualização BASIC.
MERCHANT_VIEW_BASIC Inclua informações básicas sobre o comerciante.
MERCHANT_VIEW_FULL Inclua todos os detalhes sobre o comerciante.

Esquema de saída

Mensagem de resposta para os comerciantes cadastrados.

ListMerchantsResponse

Representação JSON 
{
  "merchants": [
    {
      object (Merchant)
    }
  ]
}
Campos
merchants[]

object (Merchant)

As lojas a que o usuário tem acesso.

Comerciante

Representação JSON 
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
Campos
merchantId

string

Apenas saída. O identificador exclusivo do comerciante.
displayName

string

Obrigatório. O nome de exibição do comerciante.
regionCode

string

Obrigatório. O código da região do local da empresa do comerciante. O formato são os códigos de região Unicode CLDR, por exemplo, "US". A Índia ("IN") não é aceita.
mcc

enum (Mcc)

Obrigatório. O código de categoria do comerciante (MCC).
corporateWebsiteUrl

string

Obrigatório. O site corporativo do comerciante.
customerSupportWebsiteUrl

string

Obrigatório. O site de suporte ao cliente da loja.
customerSupportEmail

string

Obrigatório. O e-mail de suporte ao cliente do comerciante.
customerSupportPhone

string

Obrigatório. O número de telefone do serviço de atendimento ao cliente do comerciante.
state

enum (State)

Apenas saída. O estado 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 Artigos de papelaria, material de escritório, papel para impressão e escrita
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 de propriedade do governo (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)

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: ❌