MCP Tools Reference: chatmcp.googleapis.com

Outil : list_messages

Récupère les messages d'une conversation Google Chat spécifiée (espace, message privé ou message privé de groupe). Permet de filtrer les résultats par fil de discussion, plage horaire et nombre de messages. De plus, la page suivante des messages peut être récupérée pour fournir plus de contexte. Les messages privés (messages visibles par un seul utilisateur) sont filtrés.

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP list_messages.

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

Schéma d'entrée

Message de requête pour le RPC ListMessages.

ListChatMessagesRequest

Représentation JSON 
{
  "conversationId": string,
  "threadId": string,
  "pageSize": integer,
  "pageToken": string,
  "startTime": string,
  "endTime": string
}
Champs
conversationId

string

Obligatoire. ID de la conversation. Une conversation peut être un espace, un message privé (MP) ou un message privé/Chat de groupe. Format : spaces/{space}
threadId

string

Facultatif. ID d'un fil de discussion spécifique dans la conversation. Si cette valeur est fournie, seuls les messages de ce fil de discussion seront renvoyés. Si ce paramètre est omis, les messages de tous les fils de discussion de la conversation sont pris en compte. Format : spaces/{space}/threads/{thread}
pageSize

integer

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

string

Facultatif. Jeton de page reçu d'un appel list_messages précédent. Fournissez-le pour récupérer la page suivante.
startTime

string

Facultatif. Code temporel ISO 8601 permettant de filtrer les messages. Seuls les messages créés après cette heure seront renvoyés.
endTime

string

Facultatif. Code temporel ISO 8601 permettant de filtrer les messages. Seuls les messages créés avant cette heure seront renvoyés.

Schéma de sortie

Message de réponse pour le RPC ListMessages.

ListChatMessagesResponse

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

object (ChatMessage)

Liste des messages récupérés, dans l'ordre chronologique inverse (du plus récent au plus ancien).
nextPageToken

string

Jeton pouvant être envoyé en tant que page_token dans un ListMessagesRequest ultérieur pour récupérer la page de messages suivante. Si ce champ est vide, il n'y a plus de pages.

ChatMessage

Représentation JSON 
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}
Champs
messageId

string

Nom de ressource du message. Format : spaces/{space}/messages/{message}
threadId

string

Fil de discussion auquel appartient ce message. Il sera vide si le message n'est pas associé à un fil de discussion. Format : spaces/{space}/threads/{thread}
plaintextBody

string

Corps du message en texte brut.
sender

object (User)

Expéditeur du message.
createTime

string

Uniquement en sortie. Code temporel de création du message.
threadedReply

boolean

Indique si le message est une réponse dans un fil de discussion.
attachments[]

object (ChatAttachmentMetadata)

Pièces jointes incluses dans le message.
reactionSummaries[]

object (ReactionSummary)

Récapitulatif des réactions emoji inclus dans le message.

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 "HUMAIN".
userType

enum (UserType)

Type d'utilisateur.

ChatAttachmentMetadata

Représentation JSON 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
Champs
attachmentId

string

Nom de ressource de la pièce jointe. Format : spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

Nom de la pièce jointe.
mimeType

string

Type de contenu (type MIME).
source

enum (Source)

Source de la pièce jointe.

ReactionSummary

Représentation JSON 
{
  "emoji": string,
  "count": integer
}
Champs
emoji

string

Chaîne Unicode de l'emoji ou nom de l'emoji personnalisé.
count

integer

Nombre total de réactions utilisant l'emoji associé.

Annotations d'outils

Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ✅ | Indication Open World : ❌