MCP Tools Reference: paydeveloper.googleapis.com

Outil : set_principal_role

Définit le rôle d'un compte principal (utilisateur) pour un marchand ou ajoute un compte principal avec le rôle spécifié. Le compte principal reçoit une invitation par e-mail qu'il doit accepter pour que son accès soit activé. Cette opération nécessite un accès administrateur pour le marchand.

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP set_principal_role.

Requête 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
}'

Schéma d'entrée

Message de requête pour ajouter ou mettre à jour un compte principal pour un marchand.

SetPrincipalRoleRequest

Représentation JSON 
{
  "merchantId": string,
  "email": string,
  "role": enum (PrincipalRole)
}
Champs
merchantId

string

Obligatoire. ID du marchand pour lequel ajouter ou mettre à jour le compte principal.
email

string

Obligatoire. Adresse e-mail du compte principal à ajouter ou à mettre à jour.
role

enum (PrincipalRole)

Obligatoire. Rôle à accorder au compte principal.

PrincipalRole

Rôle pouvant être accordé à un compte principal (utilisateur) pour un marchand.

Enums
PRINCIPAL_ROLE_UNSPECIFIED Le rôle n'est pas spécifié.
ADMIN Accès complet au marchand, y compris pour gérer les utilisateurs.
DEVELOPER Accès destiné aux développeurs qui s'intègrent au marchand.

Schéma de sortie

Message de réponse pour ajouter ou mettre à jour un compte principal pour un marchand.

SetPrincipalRoleResponse

Représentation JSON 
{
  "state": enum (State)
}
Champs
state

enum (State)

État du compte principal après l'ajout ou la mise à jour.

État

État de l'accès d'un compte principal pour un marchand.

Enums
STATE_UNSPECIFIED L'état d'accès n'est pas spécifié.
ACTIVE Le compte principal dispose d'un accès actif et accepté.
PENDING Le compte principal a été invité, mais n'a pas encore accepté l'invitation.
EXPIRED L'invitation du compte principal a expiré.

Annotations d'outil

Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients traitent ces indications comme non fiables, mais elles peuvent être utilisées pour déterminer quand une invite de confirmation peut être envoyée à un utilisateur.

Outre la chaîne de titre, les indications booléennes suivantes sont définies comme suit :

  • readOnlyHint : si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".
  • destructiveHint : si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions additives. Valeur par défaut : "true".
  • idempotentHint : si la valeur est "true", l'appel répété de l'outil avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".
  • openWorldHint : si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche sur le Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.

Indication destructive : ✅ | Indication idempotente : ❌ | Indication en lecture seule : ❌ | Indication de monde ouvert : ❌