MCP Tools Reference: chatmcp.googleapis.com

Outil : search_conversations

Recherche des conversations Google Chat par nom à afficher.

Si seuls des participants sont fournis, cet outil recherche les messages privés entre deux personnes (si un seul participant est fourni) ou les discussions de groupe (si plusieurs participants sont fournis) qui incluent les participants spécifiés et l'utilisateur appelant.

Si seule une requête est fournie, cet outil recherche les conversations dans lesquelles la requête est une sous-chaîne insensible à la casse du nom à afficher de la conversation.

Si des participants et une requête sont fournis, cet outil recherche les conversations par participants, puis les filtre par nom à afficher.

Si aucun participant ni aucune requête ne sont fournis, cet outil liste toutes les conversations dont l'utilisateur appelant est membre.

Cet outil ne liste que les conversations dont l'utilisateur appelant est membre.

IMPORTANT : Une liste "conversations" vide ne signifie pas qu'il n'y a plus de résultats. Si "next_page_token" est présent, vous pouvez récupérer d'autres pages. Si vous obtenez une liste vide, mais un "next_page_token", demandez à l'utilisateur si vous devez poursuivre la recherche.

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

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_conversations",
    "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 FindConversations.

SearchConversationsRequest

Représentation JSON 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
Champs
spaceNameQuery

string

Facultatif. Texte à rechercher dans les noms à afficher des espaces.
pageSize

integer

Facultatif. Nombre maximal d'espaces à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 100 espaces au maximum sont renvoyés. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.
pageToken

string

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

string

Facultatif. Liste des adresses e-mail des participants pour filtrer les conversations, à l'exclusion de l'appelant.

Schéma de sortie

Message de réponse pour le RPC FindConversations.

SearchConversationsResponse

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

object (Conversation)

Liste des objets de conversation correspondant aux critères de recherche.
nextPageToken

string

Jeton qui peut ê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.

Conversation

Représentation JSON 
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
Champs
conversationId

string

ID de la conversation (par exemple, "spaces/AAAAAAAAA").
displayName

string

Nom à afficher de la conversation.
conversationType

enum (ConversationType)

Type de conversation (DIRECT_MESSAGE, GROUP_CHAT ou NAMED_SPACE).
lastActiveTimestamp

string (Timestamp format)

Dernière heure d'activité de la conversation au format ISO 8601.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

Horodatage

Représentation JSON 
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. Doit être compris entre -62135596800 et 253402300799 inclus (ce qui correspond à 0001-01-01T00:00:00Z à 9999-12-31T23:59:59Z).
nanos

integer

Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie en nanosecondes de la durée, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. Doit être compris entre 0 et 999 999 999 inclus.

ConversationType

Définit le type de conversation.

Enums
CONVERSATION_TYPE_UNSPECIFIED Non spécifié.
NAMED_SPACE Espace nommé.
GROUP_CHAT Chat de groupe entre trois personnes ou plus.
DIRECT_MESSAGE Message privé entre deux personnes, ou entre une personne et une application Chat.

Annotations d'outil

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