MCP Tools Reference: paydeveloper.googleapis.com

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

Обновляет определенные поля существующего продавца. Поддерживаемые поля: display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email и customer_support_phone.

Приведённый ниже пример кода демонстрирует, как использовать curl для вызова инструмента update_merchant 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": "update_merchant",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

Сообщение запроса для функции UpdateMerchant.

UpdateMerchantFacadeRequest

JSON-представление
{
  "merchantId": string,

  // Union field _display_name can be only one of the following:
  "displayName": string
  // End of list of possible types for union field _display_name.

  // Union field _mcc can be only one of the following:
  "mcc": enum (Mcc)
  // End of list of possible types for union field _mcc.

  // Union field _corporate_website_url can be only one of the following:
  "corporateWebsiteUrl": string
  // End of list of possible types for union field _corporate_website_url.

  // Union field _customer_support_website_url can be only one of the following:
  "customerSupportWebsiteUrl": string
  // End of list of possible types for union field _customer_support_website_url.

  // Union field _customer_support_email can be only one of the following:
  "customerSupportEmail": string
  // End of list of possible types for union field _customer_support_email.

  // Union field _customer_support_phone can be only one of the following:
  "customerSupportPhone": string
  // End of list of possible types for union field _customer_support_phone.
}
Поля
merchantId

string

Обязательно. Идентификатор продавца, данные которого необходимо обновить.

Объединенное поле _display_name .

_display_name может принимать только одно из следующих значений:

displayName

string

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

Объединенное поле _mcc .

_mcc может принимать только одно из следующих значений:

mcc

enum ( Mcc )

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

Объединенное поле _corporate_website_url .

_corporate_website_url может принимать только одно из следующих значений:

corporateWebsiteUrl

string

Корпоративный веб-сайт продавца.

Объединенное поле _customer_support_website_url .

_customer_support_website_url может принимать только одно из следующих значений:

customerSupportWebsiteUrl

string

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

Объединенное поле _customer_support_email .

_customer_support_email может принимать только одно из следующих значений:

customerSupportEmail

string

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

Объединенное поле _customer_support_phone .

_customer_support_phone может принимать только одно из следующих значений:

customerSupportPhone

string

Телефон службы поддержки клиентов продавца.

Макк

Код категории продавца (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 Государственные лотереи (за пределами США)

Схема вывода

Ответное сообщение для UpdateMerchant.

UpdateMerchantResponse

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

enum ( State )

Состояние обновленного продавца.

Состояние

Состояние торговца.

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

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