MCP Tools Reference: chatmcp.googleapis.com

Tool: list_messages

Ruft Nachrichten aus einer bestimmten Google Chat-Unterhaltung ab (Gruppenbereich, Direktnachricht oder Gruppennachricht). Ermöglicht das Filtern nach Thread, Zeitraum und Anzahl der Nachrichten. Außerdem kann die nächste Seite mit Nachrichten abgerufen werden, um mehr Kontext zu erhalten. Private Nachrichten (Nachrichten, die nur für einen einzelnen Nutzer sichtbar sind) werden herausgefiltert.

Im folgenden Beispiel wird gezeigt, wie Sie das MCP-Tool list_messages 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": "list_messages",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfragenachricht für ListMessages RPC.

ListChatMessagesRequest

JSON-Darstellung 
{
  "conversationId": string,
  "threadId": string,
  "pageSize": integer,
  "pageToken": string,
  "startTime": string,
  "endTime": string
}
Felder
conversationId

string

Erforderlich. Die ID der Unterhaltung. Eine Unterhaltung kann ein Gruppenbereich, eine Direktnachricht oder eine Gruppennachricht/ein Gruppenchat sein. Format: spaces/{space}
threadId

string

Optional. Die ID eines bestimmten Threads in der Unterhaltung. Wenn angegeben, werden nur Nachrichten aus diesem Thread zurückgegeben. Wenn nicht angegeben, werden Nachrichten aus allen Threads in der Unterhaltung berücksichtigt. Format: spaces/{space}/threads/{thread}
pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden Nachrichten. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nichts anderes angegeben wird, wird der Wert standardmäßig auf 20 gesetzt. Der maximal zulässige Wert beträgt 50.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen Aufruf von „list_messages“ empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.
startTime

string

Optional. ISO 8601-Zeitstempel zum Filtern von Nachrichten. Es werden nur Nachrichten zurückgegeben, die nach diesem Zeitpunkt erstellt wurden.
endTime

string

Optional. ISO 8601-Zeitstempel zum Filtern von Nachrichten. Es werden nur Nachrichten zurückgegeben, die vor diesem Zeitpunkt erstellt wurden.

Ausgabeschema

Antwortnachricht für ListMessages RPC.

ListChatMessagesResponse

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

object (ChatMessage)

Liste der abgerufenen Nachrichten in umgekehrter chronologischer Reihenfolge (neueste zuerst).
nextPageToken

string

Ein Token, das als page_token in einer nachfolgenden ListMessagesRequest gesendet werden kann, um die nächste Seite mit Nachrichten abzurufen. Wenn dieses Feld leer ist, sind keine weiteren Seiten vorhanden.

ChatMessage

JSON-Darstellung 
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}
Felder
messageId

string

Ressourcenname der Nachricht. Format: spaces/{space}/messages/{message}
threadId

string

Der Thread, zu dem diese Nachricht gehört. Dieses Feld ist leer, wenn die Nachricht keinem Thread zugeordnet ist. Format: spaces/{space}/threads/{thread}
plaintextBody

string

Nur-Text-Textkörper der Nachricht.
sender

object (User)

Der Absender der Nachricht.
createTime

string

Nur Ausgabe. Zeitstempel für die Erstellung der Nachricht.
threadedReply

boolean

Gibt an, ob die Nachricht eine Antwort in einem Thread ist.
attachments[]

object (ChatAttachmentMetadata)

In der Nachricht enthaltene Anhänge.
reactionSummaries[]

object (ReactionSummary)

Die in der Nachricht enthaltene Zusammenfassung der Emoji-Reaktionen.

Nutzer

JSON-Darstellung 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Felder
userId

string

Ressourcenname eines Chat-Nutzers. Format: users/{user}.
displayName

string

Der Anzeigename eines Chat-Nutzers.
email

string

Die E-Mail-Adresse des Nutzers. Dieses Feld wird nur ausgefüllt, wenn der Nutzertyp „HUMAN“ ist.
userType

enum (UserType)

Der Typ des Nutzers.

ChatAttachmentMetadata

JSON-Darstellung 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
Felder
attachmentId

string

Ressourcenname des Anhangs. Format: spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

Name des Anhangs.
mimeType

string

Inhaltstyp (MIME-Typ).
source

enum (Source)

Die Quelle des Anhangs.

ReactionSummary

JSON-Darstellung 
{
  "emoji": string,
  "count": integer
}
Felder
emoji

string

Die Unicode-String des Emojis oder der Name des benutzerdefinierten Emojis.
count

integer

Die Gesamtzahl der Reaktionen mit dem zugehörigen Emoji.

Toolanmerkungen

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