MCP Tools Reference: chatmcp.googleapis.com

Tool: search_conversations

Sucht nach Google Chat-Unterhaltungen anhand des Anzeigenamens.

Wenn nur Teilnehmer angegeben werden, sucht dieses Tool nach 1:1-Direktnachrichten (wenn ein Teilnehmer angegeben ist) oder Gruppenchats (wenn mehrere Teilnehmer angegeben sind), die die angegebenen Teilnehmer und den aufrufenden Nutzer enthalten.

Wenn nur eine Abfrage angegeben wird, sucht dieses Tool nach Unterhaltungen, bei denen die Abfrage eine nicht berücksichtigende Teilstring des Anzeigenamens der Unterhaltung ist.

Wenn sowohl Teilnehmer als auch eine Abfrage angegeben werden, sucht dieses Tool nach Unterhaltungen anhand der Teilnehmer und filtert sie dann nach Anzeigenamen.

Wenn weder Teilnehmer noch eine Abfrage angegeben werden, listet dieses Tool alle Unterhaltungen auf, an denen der aufrufende Nutzer beteiligt ist.

Dieses Tool listet nur Unterhaltungen auf, an denen der aufrufende Nutzer beteiligt ist.

WICHTIG: Eine leere Liste von Unterhaltungen bedeutet nicht, dass es keine weiteren Ergebnisse gibt. Wenn „next_page_token“ vorhanden ist, können weitere Seiten abgerufen werden. Wenn Sie eine leere Liste, aber ein „next_page_token“ erhalten, fragen Sie den Nutzer, ob Sie die Suche fortsetzen sollen.

Das folgende Beispiel zeigt, wie Sie das MCP-Tool search_conversations mit curl aufrufen.

Curl-Anfrage 
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": "search_conversations",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfragenachricht für die RPC „FindConversations“.

SearchConversationsRequest

JSON-Darstellung 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
Felder
spaceNameQuery

string

Optional. Der Text, nach dem in den Anzeigenamen der Bereiche gesucht werden soll.
pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden Bereiche. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 100 Bereiche zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen search_conversations-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.
participants[]

string

Optional. Liste der E‑Mail-Adressen der Teilnehmer, nach denen die Unterhaltungen gefiltert werden sollen, ohne den Anrufer.

Ausgabeschema

Antwortnachricht für die RPC „FindConversations“.

SearchConversationsResponse

JSON-Darstellung 
{
  "conversations": [
    {
      object (Conversation)
    }
  ],
  "nextPageToken": string
}
Felder
conversations[]

object (Conversation)

Liste der Unterhaltungsobjekte, die den Suchkriterien entsprechen.
nextPageToken

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Unterhaltung

JSON-Darstellung 
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
Felder
conversationId

string

Die ID der Unterhaltung (z.B. „spaces/AAAAAAAAA“).
displayName

string

Der Anzeigename der Unterhaltung.
conversationType

enum (ConversationType)

Der Typ der Unterhaltung (DIRECT_MESSAGE, GROUP_CHAT oder NAMED_SPACE).
lastActiveTimestamp

string (Timestamp format)

Die letzte aktive Zeit der Unterhaltung im ISO-8601-Format.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld ist der Nanosekundenanteil der Dauer und keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen.

Toolanmerkungen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Hinweis „Nur lesen“: ✅ | Hinweis „Offene Welt“: ❌