MCP Tools Reference: chatmcp.googleapis.com

Outil : list_memberships

Liste les abonnements dans une conversation Google Chat.

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

Requête Curl 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_memberships",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schéma d'entrée

ListMembershipsRequest

Représentation JSON 
{
  "conversationId": string,
  "pageSize": integer,
  "pageToken": string,
  "membershipFilter": enum (MembershipFilter)
}
Champs
conversationId

string

Obligatoire. ID de la conversation pour laquelle lister les abonnements. Format: spaces/{space}
pageSize

integer

Facultatif. Nombre maximal d'abonnements à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée ou si la valeur est non positive, la valeur par défaut 20 est utilisée. La valeur maximale autorisée est 50.
pageToken

string

Facultatif. Jetons de page, reçu d'un appel list_memberships précédent. Fournissez-le pour récupérer la page suivante.
membershipFilter

enum (MembershipFilter)

Facultatif. Spécifie le sous-ensemble d'abonnements à renvoyer. Si aucune valeur n'est spécifiée, seuls les abonnements JOINED sont renvoyés.

MembershipFilter

Spécifie le sous-ensemble d'abonnements à renvoyer.

Enums
MEMBERSHIP_FILTER_UNSPECIFIED Valeur par défaut. Si aucune valeur n'est spécifiée, seuls les abonnements JOINED sont renvoyés.
JOINED_ONLY Ne renvoie que les abonnements JOINED.
JOINED_AND_INVITED Renvoie les abonnements JOINED et INVITED.

Schéma de sortie

Réponse contenant la liste des abonnements dans la conversation.

ListMembershipsResponse

Représentation JSON 
{
  "memberships": [
    {
      object (Membership)
    }
  ],
  "nextPageToken": string
}
Champs
memberships[]

object (Membership)

Liste des abonnements dans la conversation demandée.
nextPageToken

string

Jetons pouvant être envoyés en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

Abonnement

Représentation JSON 
{
  "member": {
    object (User)
  },
  "state": enum (State),
  "role": enum (Role)
}
Champs
member

object (User)

Utilisateur membre.
state

enum (State)

Uniquement en sortie. État de l'abonnement.
role

enum (Role)

Rôle du membre.

Utilisateur

Représentation JSON 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Champs
userId

string

Nom de ressource d'un utilisateur Chat. Format: users/{user}.
displayName

string

Nom à afficher d'un utilisateur Chat.
email

string

Adresse e-mail de l'utilisateur. Ce champ n'est renseigné que lorsque le type d'utilisateur est HUMAN.
userType

enum (UserType)

Type d'utilisateur.

UserType

Type d'utilisateur Google Chat.

Enums
USER_TYPE_UNSPECIFIED Non spécifié.
HUMAN Utilisateur humain.
APP Utilisateur d'application.

État

État de l'abonnement.

Enums
STATE_UNSPECIFIED Non spécifié.
JOINED L'utilisateur est membre de l'espace.
INVITED L'utilisateur est invité à rejoindre l'espace.

Rôle

Rôle du membre.

Enums
ROLE_UNSPECIFIED Non spécifié.
MEMBER L'utilisateur est membre de l'espace.
MANAGER L'utilisateur est gestionnaire de l'espace.
ASSISTANT_MANAGER L'utilisateur est gestionnaire adjoint de l'espace.

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 : ❌

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly