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

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

mcc

enum ( Mcc )

Обязательно. Код категории продавца (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, то инструмент может взаимодействовать только с внутренними объектами. Например, инструмент веб-поиска будет представлять собой открытый мир, а инструмент для работы с памятью — нет.

Подсказка о разрушительном эффекте: ❌ | Подсказка об идемпотентности: ✅ | Подсказка только для чтения: ✅ | Подсказка об открытом мире: ❌