MCP Tools Reference: paydeveloper.googleapis.com

Instrument: list_principals

Listează utilizatorii principali care au acces la un anumit comerciant. Această operațiune necesită acces de administrator pentru comerciant.

Următorul exemplu de cod arată cum se utilizează curl pentru a apela instrumentul MCP list_principals .

Cerere de bucle 
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
}'

Schema de intrare

Solicitați un mesaj pentru listarea directorilor unui comerciant.

Cerere Listă Principali

Reprezentare JSON 
{
  "merchantId": string
}
Câmpuri
merchantId

string

Obligatoriu. ID-ul comerciantului pentru care se vor lista principalii.

Schema de ieșire

Mesaj de răspuns pentru listarea directorilor unui comerciant.

ListPrincipalsResponse

Reprezentare JSON 
{
  "principals": [
    {
      object (Principal)
    }
  ]
}
Câmpuri
principals[]

object ( Principal )

Principalii care au acces la comerciant.

Principal

Reprezentare JSON 
{
  "email": string,
  "displayName": string,
  "role": enum (PrincipalRole),
  "state": enum (State)
}
Câmpuri
email

string

Obligatoriu. Adresa de e-mail a principalului.

displayName

string

Numai ieșire. Numele afișat al principalului.

role

enum ( PrincipalRole )

Rolul principalului asupra comerciantului.

state

enum ( State )

Numai ieșire. Starea de acces a principalului la comerciant.

Rol principal

Un rol care poate fi acordat unui utilizator principal la un comerciant.

Enumări
PRINCIPAL_ROLE_UNSPECIFIED Rolul este nespecificat.
ADMIN Acces complet la comerciant, inclusiv gestionarea utilizatorilor.
DEVELOPER Acces destinat dezvoltatorilor care se integrează cu comerciantul.

Stat

Starea accesului unui principal la un comerciant.

Enumări
STATE_UNSPECIFIED Starea de acces este nespecificată.
ACTIVE Principalul are un acces activ, acceptat.
PENDING Directorul a fost invitat, dar nu a acceptat încă invitația.
EXPIRED Invitația directorului a expirat.

Adnotări ale instrumentelor

Adnotările instrumentelor sunt trimise clienților MCP pentru a descrie riscul de bază al unui anumit instrument. Majoritatea clienților tratează aceste indicii ca fiind neîncrezătoare, dar pot fi folosite pentru a decide când ar putea fi trimisă o solicitare de confirmare unui utilizator.

Împreună cu șirul de titlu, următoarele indicii booleene sunt definite după cum urmează:

  • readOnlyHint : Dacă este adevărat, instrumentul nu își modifică mediul. Implicit: fals.
  • destructiveHint : Dacă este adevărat, atunci instrumentul poate efectua acțiuni distructive. Dacă este fals, atunci instrumentul poate efectua doar acțiuni aditive. Implicit: adevărat.
  • idempotentHint : Dacă este adevărat, apelarea repetată a instrumentului cu aceleași argumente nu va avea niciun efect suplimentar asupra mediului său. Implicit: fals.
  • openWorldHint : Dacă este adevărat, atunci instrumentul poate interacționa cu o „lume deschisă” de entități externe. Dacă este fals, atunci instrumentul poate interacționa doar cu entități interne. De exemplu, un instrument de căutare web ar fi o lume deschisă, în timp ce un instrument de memorie nu ar fi o lume deschisă.

Indiciu distructiv: ❌ | Indiciu idempotent: ✅ | Indiciu doar pentru citire: ✅ | Indiciu pentru lumea deschisă: ❌