Инструмент: 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 ( |
| Поля | |
|---|---|
view |
Необязательный параметр. Указывает уровень детализации, который нужно вернуть для каждого продавца. |
MerchantView
Уровень детализации, который нужно вернуть для каждого продавца.
| Перечисления | |
|---|---|
MERCHANT_VIEW_UNSPECIFIED |
Значение по умолчанию или значение, которое не задано. По умолчанию API будет использовать представление BASIC. |
MERCHANT_VIEW_BASIC |
Укажите основную информацию о продавце. |
MERCHANT_VIEW_FULL |
Укажите все сведения о продавце. |
Схема вывода
Сообщение ответа для продавцов, размещающих информацию о товаре.
ListMerchantsResponse
| JSON-представление |
|---|
{
"merchants": [
{
object ( |
| Поля | |
|---|---|
merchants[] |
Продавцы, к которым у пользователя есть доступ. |
Продавец
| JSON-представление |
|---|
{ "merchantId": string, "displayName": string, "regionCode": string, "mcc": enum ( |
| Поля | |
|---|---|
merchantId |
Используется только для вывода. Уникальный идентификатор продавца. |
displayName |
Это обязательное поле. Отображаемое название продавца. |
regionCode |
Это обязательное поле. Код региона, в котором находится компания продавца. Формат – коды регионов CLDR Unicode, например "US". Индия (IN) не поддерживается. |
mcc |
Это обязательное поле. Код категории продавца. |
corporateWebsiteUrl |
Это обязательное поле. Корпоративный сайт продавца. |
customerSupportWebsiteUrl |
Это обязательное поле. Сайт службы поддержки продавца. |
customerSupportEmail |
Это обязательное поле. Адрес электронной почты службы поддержки продавца. |
customerSupportPhone |
Это обязательное поле. Номер телефона службы поддержки продавца. |
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, инструмент может взаимодействовать только с внутренними объектами. Например, инструмент веб-поиска будет открытым миром, а инструмент памяти – нет.
Деструктивный подсказка: ❌ | Идемпотентный подсказка: ✅ | Только для чтения подсказка: ✅ | Открытый мир подсказка: ❌