MCP Tools Reference: chatmcp.googleapis.com

Outil : search_messages

Recherche des messages Google Chat à l'aide de mots clés et de filtres. Fonctionne dans tous les espaces auxquels l'utilisateur a accès ou peut être limité à une conversation spécifique.

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

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

Schéma d'entrée

Demande de recherche de messages Google Chat à l'aide de mots clés et de filtres. Fonctionne dans tous les espaces auxquels l'utilisateur a accès ou peut être limité à une conversation spécifique.

SearchMessagesRequest

Représentation JSON 
{
  "searchParameters": {
    object (SearchParameters)
  },
  "orderBy": enum (OrderBy),
  "pageSize": integer,
  "pageToken": string
}
Champs
searchParameters

object (SearchParameters)

Obligatoire. Paramètres de recherche à utiliser pour la recherche.
orderBy

enum (OrderBy)

Facultatif. Spécifie l'ordre dans lequel les résultats doivent être renvoyés. Valeurs acceptées : CREATE_TIME_DESC, CREATE_TIME_ASC ou RELEVANCE_DESC. REMARQUE : RELEVANCE_DESC ne peut pas être utilisé avec le filtre "is_unread". Par défaut, RELEVANCE_DESC est utilisé si is_unread n'est pas défini sur "true". Sinon, CREATE_TIME_DESC est utilisé.
pageSize

integer

Facultatif. Nombre maximal de résultats à renvoyer (100 maximum). Si aucune valeur n'est spécifiée, 25 éléments au maximum sont renvoyés.
pageToken

string

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

SearchParameters

Représentation JSON 
{
  "keywords": [
    string
  ],
  "conversationId": string,
  "sender": string,
  "isUnread": boolean,
  "hasLink": boolean,
  "startTime": string,
  "endTime": string,
  "mentionsMe": boolean,
  "conversationIncludesUser": string,
  "spaceDisplayNames": [
    string
  ]
}
Champs
keywords[]

string

Facultatif. Ensemble de mots clés utilisés pour filtrer les résultats.
conversationId

string

Facultatif. Limite la recherche à un identifiant de conversation spécifique, tel que renvoyé par l'outil search_conversations. Format : spaces/{ID}.
sender

string

Facultatif. Filtrer les messages d'un utilisateur spécifique Vous pouvez utiliser l'adresse e-mail ou le nom de ressource de l'expéditeur. Les noms de ressources utilisateur sont au format users/{ID}, où {ID} peut être un ID de personne ou son adresse e-mail.
isUnread

boolean

Facultatif. Filtrez les messages qui n'ont pas été lus par l'utilisateur appelant.
hasLink

boolean

Facultatif. Filtrer les messages contenant au moins une URL.
startTime

string

Facultatif. Filtrer les messages créés après cette heure. Format : code temporel ISO 8601.
endTime

string

Facultatif. Filtrez les messages créés avant cette heure. Format : code temporel ISO 8601.
mentionsMe

boolean

Facultatif. Filtrez les messages qui mentionnent explicitement l'utilisateur appelant.
conversationIncludesUser

string

Facultatif. Filtrez les messages dans les MP et les chats de groupe qui incluent l'adresse e-mail ou l'ID de l'utilisateur spécifique.
spaceDisplayNames[]

string

Facultatif. Filtrer par une liste de noms d'espaces ; les noms d'affichage des espaces sont partiellement mis en correspondance. Remarque : Seules les cinq premières correspondances sont renvoyées.

OrderBy

Spécifie l'ordre dans lequel les résultats doivent être renvoyés. Par défaut, RELEVANCE_DESC est utilisé si is_unread n'est pas défini sur "true". Sinon, CREATE_TIME_DESC est utilisé.

Enums
ORDER_BY_UNSPECIFIED Valeur par défaut.
CREATE_TIME_DESC Trier par date de création dans l'ordre décroissant.
RELEVANCE_DESC Trier par pertinence dans l'ordre décroissant

Schéma de sortie

Réponse à la recherche de messages Google Chat. Si next_page_token est renseigné, SearchMessages peut être appelé à nouveau avec ce jeton pour récupérer la page de résultats suivante.

SearchMessagesResponse

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

object (ChatMessage)

Liste des objets de message correspondant aux critères de recherche, classés selon le paramètre de requête order_by.
nextPageToken

string

Jeton pouvant être envoyé 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.

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é.

UserType

Type d'utilisateur Google Chat.

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

Source

Source de la pièce jointe.

Enums
SOURCE_UNSPECIFIED Réservé.
DRIVE_FILE Le fichier est un fichier Google Drive.
UPLOADED_CONTENT Le fichier est importé dans Chat.

Annotations d'outils

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