MCP Tools Reference: paydeveloper.googleapis.com

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

Содержит список субъектов (пользователей), у которых есть доступ к определенному продавцу. Для этого действия требуется доступ с правами администратора.

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

Схема ввода

Запрос на сообщение для перечисления принципалов продавца.

ListPrincipalsRequest

JSON-представление 
{
  "merchantId": string
}
Поля
merchantId

string

Это обязательное поле. Идентификатор продавца, для которого нужно получить список субъектов.

Схема вывода

Сообщение с ответом на запрос списка принципалов продавца.

ListPrincipalsResponse

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

object (Principal)

Субъекты, у которых есть доступ к продавцу.

Субъект

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

string

Это обязательное поле. Адрес электронной почты субъекта.
displayName

string

Используется только для вывода. Отображаемое имя субъекта.
role

enum (PrincipalRole)

Роль субъекта в отношении продавца.
state

enum (State)

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

PrincipalRole

Роль, которую можно назначить субъекту (пользователю) в аккаунте продавца.

Перечисления
PRINCIPAL_ROLE_UNSPECIFIED Роль не указана.
ADMIN Полный доступ к аккаунту продавца, включая управление пользователями.
DEVELOPER Доступ, предназначенный для разработчиков, которые интегрируются с продавцом.

Штат

Состояние доступа субъекта к продавцу.

Перечисления
STATE_UNSPECIFIED Статус доступа не указан.
ACTIVE У субъекта есть активный принятый доступ.
PENDING Субъект приглашен, но ещё не принял приглашение.
EXPIRED Срок действия приглашения принципала истек.

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

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

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

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

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