MCP Tools Reference: paydeveloper.googleapis.com

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

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

В приведенном ниже фрагменте кода показано, как использовать curl для вызова инструмента set_principal_role 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": "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, инструмент может взаимодействовать только с внутренними объектами. Например, инструмент веб-поиска будет открытым миром, а инструмент памяти – нет.

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