MCP Tools Reference: paydeveloper.googleapis.com

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

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

Приведённый ниже пример кода демонстрирует, как использовать curl для вызова инструмента MCP list_principals .

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

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