MCP Tools Reference: paydeveloper.googleapis.com

Инструмент: list_merchants

Получает полный список всех продавцов, использующих Google Pay и связанных с аутентифицированным аккаунтом. В зависимости от роли пользователя в аккаунте продавца администраторы могут просматривать подробную информацию о продавце, а разработчики – только основную.

В приведенном ниже фрагменте кода показано, как использовать curl для вызова инструмента list_merchants MCP.

Запрос 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
}'

Схема ввода

Запрос сообщения для продавцов, размещающих товары.

ListMerchantsRequest

JSON-представление
{
  "view": enum (MerchantView)
}
Поля
view

enum (MerchantView)

Необязательный параметр. Указывает уровень детализации, который нужно вернуть для каждого продавца.

MerchantView

Уровень детализации, который нужно вернуть для каждого продавца.

Перечисления
MERCHANT_VIEW_UNSPECIFIED Значение по умолчанию или значение, которое не задано. По умолчанию API будет использовать представление BASIC.
MERCHANT_VIEW_BASIC Укажите основную информацию о продавце.
MERCHANT_VIEW_FULL Укажите все сведения о продавце.

Схема вывода

Сообщение ответа для продавцов, размещающих информацию о товаре.

ListMerchantsResponse

JSON-представление
{
  "merchants": [
    {
      object (Merchant)
    }
  ]
}
Поля
merchants[]

object (Merchant)

Продавцы, к которым у пользователя есть доступ.

Продавец

JSON-представление
{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}
Поля
merchantId

string

Используется только для вывода. Уникальный идентификатор продавца.

displayName

string

Это обязательное поле. Отображаемое название продавца.

regionCode

string

Это обязательное поле. Код региона, в котором находится компания продавца. Формат – коды регионов CLDR Unicode, например "US". Индия (IN) не поддерживается.

mcc

enum (Mcc)

Это обязательное поле. Код категории продавца.

corporateWebsiteUrl

string

Это обязательное поле. Корпоративный сайт продавца.

customerSupportWebsiteUrl

string

Это обязательное поле. Сайт службы поддержки продавца.

customerSupportEmail

string

Это обязательное поле. Адрес электронной почты службы поддержки продавца.

customerSupportPhone

string

Это обязательное поле. Номер телефона службы поддержки продавца.

state

enum (State)

Используется только для вывода. Статус продавца.

Mcc

Код категории продавца.

Перечисления
OTHERS Другое
MISC_FOOD_STORES Разные продуктовые магазины – универсальные магазины шаговой доступности и специализированные магазины
MISC_APPAREL Магазины одежды и аксессуаров
ARTISTS_SUPPLY Магазины товаров для творчества и рукоделия
AUTOMOTIVE_PARTS Магазины автозапчастей и аксессуаров
HEALTH_AND_BEAUTY Магазин товаров для здоровья и красоты
BOOKS_PERIODICALS Книги, периодические издания и газеты
CAMERA_STORES Магазины фотоаппаратов и фотопринадлежностей
COMPUTERS_EQUIPMENT Компьютеры, периферийное оборудование и программное обеспечение
COMPUTER_SOFTWARE Магазины программного обеспечения
ELECTRONICS_SALES Магазины электроники
GIFT_SHOPS Магазины открыток, подарков, сувениров и необычных товаров
EATING_PLACES Места общественного питания и рестораны
MISC_GENERAL_MERCHANDISE Прочие товары смешанного ассортимента
HOME_SUPPLY Магазины-склады товаров для дома
COMPUTER_NETWORK_SERVICES Сетевые компьютерные сервисы
DIGITAL_GOODS_MEDIA Цифровые товары: книги, фильмы, музыка
DIGITAL_GOODS_GAMES Цифровые товары: игры
DIGITAL_GOODS_APPLICATIONS Цифровые товары: приложения (кроме игр)
POLITICAL_ORGANIZATIONS Политические организации
CHARITABLE_ORGANIZATIONS Благотворительные и социальные организации
DRUG_STORES Аптеки
REAL_ESTATE_RENTALS Агенты по недвижимости (аренда)
MISC_PERSONAL_SERVICES Прочие персональные услуги, не входящие в другие категории
SPORTING_GOODS Магазины спорттоваров
STATIONERY_OFFICE_SUPPLIES Канцелярские товары, товары для офиса, писчая бумага и бумага для печати
THEATRICAL_TICKET_AGENCIES Театральные билетные агентства
TIMESHARES Таймшер
TOURIST_ATTRACTIONS Достопримечательности и выставки
HOBBY_TOY_GAME_SHOPS Магазины товаров для хобби, игрушек и игр
PET_SHOPS Зоомагазины, магазины кормов и товаров для животных
OTHER_LODGING Прочее жилье (гостиницы, мотели, курорты)
TELECOMMUNICATION_SERVICES Телекоммуникации
TRANSPORTATION_SERVICES Транспортные услуги
OTHER_AIRLINES Прочие авиакомпании
TRAVEL_AGENCIES Туристические агентства и туроператоры
GOVERNMENT_OWNED_LOTTERIES_US Государственные лотереи (только в США)
GOVERNMENT_LICENSED_CASINOS_US Онлайн-казино с государственной лицензией (только для США)
BETTING Ставки (включая лотерейные билеты, фишки казино, ставки вне ипподрома и пари)
GOVERNMENT_OWNED_LOTTERIES_NON_US Государственные лотереи (не в США)

Штат

Статус продавца.

Перечисления
STATE_UNSPECIFIED Статус продавца не указан.
VERIFIED Продавец проверен и одобрен.
IN_REVIEW Изменения в профиле продавца находятся на рассмотрении.
REJECTED Изменения в профиле продавца отклонены.
INCOMPLETE_SIGNUP Профиль продавца заполнен не полностью.
SANCTIONS_HIT Профиль продавца нарушает правила в отношении санкций.
READY_FOR_REVIEW Профиль продавца заполнен и готов к проверке.
DISABLED Профиль продавца отключен или неактивен.

Аннотации инструментов

Аннотации инструментов отправляются клиентам MCP, чтобы описать основной риск, связанный с определенным инструментом. Большинство клиентов считают эти подсказки ненадежными, но их можно использовать, чтобы определить, когда пользователю может быть отправлен запрос на подтверждение.

Вместе со строкой заголовка определены следующие логические подсказки:

  • readOnlyHint: если значение равно true, инструмент не изменяет среду. Значение по умолчанию – false.
  • destructiveHint: если задано значение True, инструмент может выполнять деструктивные действия. Если задано значение false, инструмент может выполнять только действия по добавлению. Значение по умолчанию: true.
  • idempotentHint: если задано значение True, повторный вызов инструмента с теми же аргументами не окажет дополнительного влияния на его среду. Значение по умолчанию – false.
  • openWorldHint – если значение равно true, инструмент может взаимодействовать с внешними объектами. Если значение равно false, инструмент может взаимодействовать только с внутренними объектами. Например, инструмент веб-поиска будет открытым миром, а инструмент памяти – нет.

Деструктивный подсказка: ❌ | Идемпотентный подсказка: ✅ | Только для чтения подсказка: ✅ | Открытый мир подсказка: ❌