MCP Tools Reference: paydeveloper.googleapis.com

Tool: set_principal_role

Legt die Rolle eines Hauptkontos (Nutzer) für einen Händler fest oder fügt ein neues Hauptkonto mit der angegebenen Rolle hinzu. Das Hauptkonto erhält eine E-Mail-Einladung, die es annehmen muss, bevor der Zugriff aktiviert wird. Für diesen Vorgang ist Administratorzugriff für den Händler erforderlich.

Das folgende Codebeispiel zeigt, wie Sie curl verwenden, um das MCP-Tool set_principal_role aufzurufen.

Curl-Anfrage 
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
}'

Eingabeschema

Anfragenachricht zum Hinzufügen oder Aktualisieren eines Hauptkontos für einen Händler.

SetPrincipalRoleRequest

JSON-Darstellung 
{
  "merchantId": string,
  "email": string,
  "role": enum (PrincipalRole)
}
Felder
merchantId

string

Erforderlich. Die Händler-ID, für die das Hauptkonto hinzugefügt oder aktualisiert werden soll.
email

string

Erforderlich. Die E-Mail-Adresse des Hauptkontos, das hinzugefügt oder aktualisiert werden soll.
role

enum (PrincipalRole)

Erforderlich. Die Rolle, die dem Hauptkonto zugewiesen werden soll.

PrincipalRole

Eine Rolle, die einem Hauptkonto (Nutzer) für einen Händler zugewiesen werden kann.

Enums
PRINCIPAL_ROLE_UNSPECIFIED Die Rolle ist nicht angegeben.
ADMIN Vollständiger Zugriff auf den Händler, einschließlich der Verwaltung von Nutzern.
DEVELOPER Zugriff für Entwickler, die eine Integration mit dem Händler vornehmen.

Ausgabeschema

Antwortnachricht zum Hinzufügen oder Aktualisieren eines Hauptkontos für einen Händler.

SetPrincipalRoleResponse

JSON-Darstellung 
{
  "state": enum (State)
}
Felder
state

enum (State)

Der Status des Hauptkontos nach dem Hinzufügen oder Aktualisieren.

State

Der Status des Zugriffs eines Hauptkontos für einen Händler.

Enums
STATE_UNSPECIFIED Der Zugriffsstatus ist nicht angegeben.
ACTIVE Das Hauptkonto hat einen aktiven, akzeptierten Zugriff.
PENDING Das Hauptkonto wurde eingeladen, hat die Einladung aber noch nicht angenommen.
EXPIRED Die Einladung des Hauptkontos ist abgelaufen.

Toolanmerkungen

Toolanmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet werden soll.

Neben dem Titelstring werden die folgenden booleschen Hinweise wie folgt definiert:

  • readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: „false“.
  • destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: „true“.
  • idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: „false“.
  • openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Entitäten interagieren. Wenn „false“, kann das Tool nur mit internen Entitäten interagieren. Ein Websuchtool wäre beispielsweise „offene Welt“, ein Speichertool nicht.

Destruktiver Hinweis: ✅ | Idempotenter Hinweis: ❌ | Nur-Lese-Hinweis: ❌ | Hinweis zur offenen Welt: ❌