MCP Tools Reference: paydeveloper.googleapis.com

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

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

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

Запрос 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": "set_principal_role",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

Запрос на добавление или обновление данных об основном клиенте продавца.

SetPrincipalRoleRequest

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

string

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

email

string

Обязательно. Адрес электронной почты директора, которого нужно добавить или обновить.

role

enum ( PrincipalRole )

Обязательно. Роль, которую необходимо предоставить директору.

PrincipalRole

Роль, которая может быть предоставлена ​​субъекту (пользователю) на торговой площадке.

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

Схема вывода

Ответное сообщение при добавлении или обновлении данных об основном клиенте продавца.

SetPrincipalRoleResponse

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

enum ( State )

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

Состояние

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

Перечисления
STATE_UNSPECIFIED Состояние доступа не указано.
ACTIVE У руководителя имеется активный, подтвержденный доступ.
PENDING Директору прислали приглашение, но он его пока не принял.
EXPIRED Срок действия приглашения директора истек.

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

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

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

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

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