MCP Tools Reference: paydeveloper.googleapis.com

Narzędzie: set_principal_role

Ustawia rolę podmiotu zabezpieczeń (użytkownika) w przypadku sprzedawcy lub dodaje nowego podmiotu zabezpieczeń z określoną rolą. Do podmiotu zabezpieczeń jest wysyłane zaproszenie e-mailem, które musi on zaakceptować, zanim uzyska dostęp. Ta operacja wymaga dostępu administratora do konta sprzedawcy.

Poniższy przykładowy kod pokazuje, jak użyć narzędzia curl do wywołania narzędzia MCP set_principal_role.

Żądanie 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
}'

Schemat wejściowy

Wiadomość z prośbą o dodanie lub zaktualizowanie podmiotu zabezpieczeń w przypadku sprzedawcy.

SetPrincipalRoleRequest

Zapis JSON 
{
  "merchantId": string,
  "email": string,
  "role": enum (PrincipalRole)
}
Pola
merchantId

string

Wymagane. Identyfikator sprzedawcy, w przypadku którego chcesz dodać lub zaktualizować podmiot zabezpieczeń.
email

string

Wymagane. Adres e-mail podmiotu zabezpieczeń, który chcesz dodać lub zaktualizować.
role

enum (PrincipalRole)

Wymagane. Rola, którą chcesz przyznać podmiotowi zabezpieczeń.

PrincipalRole

Rola, którą można przyznać podmiotowi zabezpieczeń (użytkownikowi) w przypadku sprzedawcy.

Wartości w polu enum
PRINCIPAL_ROLE_UNSPECIFIED Rola jest nieokreślona.
ADMIN Pełny dostęp do konta sprzedawcy, w tym zarządzanie użytkownikami.
DEVELOPER Dostęp przeznaczony dla programistów integrujących się z kontem sprzedawcy.

Schemat wyjściowy

Wiadomość z odpowiedzią na dodanie lub zaktualizowanie podmiotu zabezpieczeń w przypadku sprzedawcy.

SetPrincipalRoleResponse

Zapis JSON 
{
  "state": enum (State)
}
Pola
state

enum (State)

Stan podmiotu zabezpieczeń po dodaniu lub zaktualizowaniu.

Stan

Stan dostępu podmiotu zabezpieczeń do konta sprzedawcy.

Wartości w polu enum
STATE_UNSPECIFIED Stan dostępu jest nieokreślony.
ACTIVE Podmiot zabezpieczeń ma aktywny, zaakceptowany dostęp.
PENDING Podmiot zabezpieczeń został zaproszony, ale jeszcze nie zaakceptował zaproszenia.
EXPIRED Zaproszenie podmiotu zabezpieczeń wygasło.

Adnotacje narzędzia

Adnotacje narzędzia są wysyłane do klientów MCP, aby opisać podstawowe ryzyko związane z danym narzędziem. Większość klientów traktuje te wskazówki jako niezaufane, ale można ich użyć do określenia, kiedy należy wysłać użytkownikowi prośbę o potwierdzenie.

Oprócz ciągu tytułu zdefiniowano te wskazówki logiczne:

  • readOnlyHint: jeśli ma wartość true, narzędzie nie modyfikuje swojego środowiska. Domyślnie: false.
  • destructiveHint: jeśli ma wartość true, narzędzie może wykonywać działania destrukcyjne. Jeśli ma wartość false, narzędzie może wykonywać tylko działania dodające. Domyślnie: true.
  • idempotentHint: jeśli ma wartość true, wielokrotne wywoływanie narzędzia z tymi samymi argumentami nie będzie miało dodatkowego wpływu na jego środowisko. Domyślnie: false.
  • openWorldHint: jeśli ma wartość true, narzędzie może wchodzić w interakcje z „otwartym światem” podmiotów zewnętrznych. Jeśli ma wartość false, narzędzie może wchodzić w interakcje tylko z podmiotami wewnętrznymi. Na przykład narzędzie do wyszukiwania w internecie byłoby narzędziem typu „otwarty świat”, a narzędzie do zarządzania pamięcią – nie.

Wskazówka destrukcyjna: ✅ | Wskazówka idempotentna: ❌ | Wskazówka tylko do odczytu: ❌ | Wskazówka „otwarty świat”: ❌