MCP Tools Reference: paydeveloper.googleapis.com

Instrument: set_principal_role

Setează rolul unui utilizator principal la un comerciant sau adaugă un nou utilizator principal cu rolul specificat. Utilizatorului principal i se trimite o invitație prin e-mail și trebuie să o accepte înainte ca accesul său să devină activ. Această operațiune necesită acces de administrator pentru comerciant.

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

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

Schema de intrare

Mesaj de solicitare pentru adăugarea sau actualizarea unui principal la un comerciant.

Cerere SetPrincipalRoleRequest

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

string

Obligatoriu. ID-ul comerciantului pentru care se adaugă sau se actualizează principalul.

email

string

Obligatoriu. Adresa de e-mail a principalului care va fi adăugată sau actualizată.

role

enum ( PrincipalRole )

Obligatoriu. Rolul de acordat principalului.

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.

Schema de ieșire

Mesaj de răspuns pentru adăugarea sau actualizarea unui principal la un comerciant.

SetPrincipalRoleResponse

Reprezentare JSON 
{
  "state": enum (State)
}
Câmpuri
state

enum ( State )

Starea principalului după adăugare sau actualizare.

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 lume deschisă: ❌