MCP Tools Reference: paydeveloper.googleapis.com

Narzędzie: list_principals

Wyświetla listę podmiotów zabezpieczeń (użytkowników), które mają dostęp do określonego sprzedawcy. Ta operacja wymaga dostępu administratora do konta sprzedawcy.

Poniższy przykładowy kod pokazuje, jak użyć narzędzia MCP list_principals za pomocą polecenia curl.

Żą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": "list_principals",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schemat wejściowy

Wiadomość z prośbą o wyświetlenie listy podmiotów zabezpieczeń sprzedawcy.

ListPrincipalsRequest

Zapis JSON 
{
  "merchantId": string
}
Pola
merchantId

string

Wymagane. Identyfikator sprzedawcy, dla którego chcesz wyświetlić listę podmiotów zabezpieczeń.

Schemat wyjściowy

Wiadomość z odpowiedzią na prośbę o wyświetlenie listy podmiotów zabezpieczeń sprzedawcy.

ListPrincipalsResponse

Zapis JSON 
{
  "principals": [
    {
      object (Principal)
    }
  ]
}
Pola
principals[]

object (Principal)

Podmioty zabezpieczeń, które mają dostęp do konta sprzedawcy.

Podmiot zabezpieczeń

Zapis JSON 
{
  "email": string,
  "displayName": string,
  "role": enum (PrincipalRole),
  "state": enum (State)
}
Pola
email

string

Wymagane. Adres e-mail podmiotu zabezpieczeń.
displayName

string

Tylko dane wyjściowe. Nazwa wyświetlana podmiotu zabezpieczeń.
role

enum (PrincipalRole)

Rola podmiotu zabezpieczeń na koncie sprzedawcy.
state

enum (State)

Tylko dane wyjściowe. Stan dostępu podmiotu zabezpieczeń do konta sprzedawcy.

PrincipalRole

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

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

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ć do użytkownika 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”: ❌