MCP Tools Reference: chatmcp.googleapis.com

Narzędzie: `list_messages`

Pobiera wiadomości z określonej rozmowy w Google Chat (pokoju, czatu lub czatu grupowego). Umożliwia filtrowanie według wątku, zakresu czasu i liczby wiadomości. Możesz też pobrać następną stronę wiadomości, aby uzyskać więcej kontekstu. Wiadomości prywatne (widoczne tylko dla jednego użytkownika) są odfiltrowywane.

Poniższy przykład pokazuje, jak za pomocą znaku curl wywołać narzędzie list_messages MCP.

Żądanie 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 }'

Żądanie 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
}'

Schemat wejściowy

Wiadomość żądania dla RPC ListMessages.

ListChatMessagesRequest

Zapis JSON
{ "conversationId": string, "threadId": string, "pageSize": integer, "pageToken": string, "startTime": string, "endTime": string }

Pola
`conversationId`	`string` Wymagane. Identyfikator rozmowy. Rozmowa może być pokojem, czatem lub czatem grupowym. Format: spaces/{space}
`threadId`	`string` Opcjonalnie. Identyfikator konkretnego wątku w rozmowie. Jeśli zostanie podany, zwracane będą tylko wiadomości z tego wątku. Jeśli ten parametr zostanie pominięty, brane pod uwagę będą wiadomości ze wszystkich wątków w rozmowie. Format: spaces/{space}/threads/{thread}
`pageSize`	`integer` Opcjonalnie. Maksymalna liczba wiadomości do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wartość 20. Maksymalna dozwolona wartość to 50.
`pageToken`	`string` Opcjonalnie. Token strony otrzymany z poprzedniego wywołania list_messages. Podaj ten token, aby pobrać kolejną stronę.
`startTime`	`string` Opcjonalnie. Sygnatura czasowa w formacie ISO 8601 służąca do filtrowania wiadomości. Wyświetlane będą tylko wiadomości utworzone po tym czasie.
`endTime`	`string` Opcjonalnie. Sygnatura czasowa w formacie ISO 8601 służąca do filtrowania wiadomości. Wyświetlane będą tylko wiadomości utworzone przed tym czasem.

Schemat wyjściowy

Wiadomość z odpowiedzią na RPC ListMessages.

ListChatMessagesResponse

Zapis JSON
{ "messages": [ { object (`ChatMessage`) } ], "nextPageToken": string }

Pola

Pola
`messages[]`	`object (ChatMessage)` Lista pobranych wiadomości w odwrotnej kolejności chronologicznej (od najnowszych do najstarszych).
`nextPageToken`	`string` Token, który można wysłać jako `page_token` w kolejnym żądaniu `ListMessagesRequest`, aby pobrać następną stronę wiadomości. Jeśli to pole jest puste, nie ma więcej stron.

messages[]

object (ChatMessage)

Lista pobranych wiadomości w odwrotnej kolejności chronologicznej (od najnowszych do najstarszych).

nextPageToken

string

Token, który można wysłać jako page_token w kolejnym żądaniu ListMessagesRequest, aby pobrać następną stronę wiadomości. Jeśli to pole jest puste, nie ma więcej stron.

ChatMessage

Zapis JSON

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

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

Pola
`messageId`	`string` Nazwa zasobu wiadomości. Format: spaces/{space}/messages/{message}
`threadId`	`string` Wątek, do którego należy ta wiadomość. Jeśli wiadomość nie jest częścią wątku, to pole będzie puste. Format: spaces/{space}/threads/{thread}
`plaintextBody`	`string` Treść wiadomości w formacie zwykłego tekstu.
`sender`	`object (User)` Nadawca wiadomości.
`createTime`	`string` Tylko dane wyjściowe. Sygnatura czasowa utworzenia wiadomości.
`threadedReply`	`boolean` Określa, czy wiadomość jest odpowiedzią w wątku.
`attachments[]`	`object (ChatAttachmentMetadata)` Załączniki dołączone do wiadomości.
`reactionSummaries[]`	`object (ReactionSummary)` Podsumowanie reakcji emotikonami zawarte w wiadomości.

Użytkownik

Zapis JSON
{ "userId": string, "displayName": string, "email": string, "userType": enum (`UserType`) }

Pola
`userId`	`string` Nazwa zasobu użytkownika Google Chat. Format: users/{user}.
`displayName`	`string` Wyświetlana nazwa użytkownika Google Chat.
`email`	`string` Adres e-mail użytkownika. To pole jest wypełniane tylko wtedy, gdy typ użytkownika to HUMAN.
`userType`	`enum (UserType)` Typ użytkownika.

ChatAttachmentMetadata

Zapis JSON
{ "attachmentId": string, "filename": string, "mimeType": string, "source": enum (`Source`) }

Pola
`attachmentId`	`string` Nazwa zasobu załącznika. Format: spaces/{space}/messages/{message}/attachments/{attachment}.
`filename`	`string` Nazwa załącznika.
`mimeType`	`string` Typ treści (typ MIME).
`source`	`enum (Source)` Źródło załącznika.

Zapis JSON
{ "emoji": string, "count": integer }

Pola

Pola
`emoji`	`string` Ciąg znaków Unicode emotikona lub nazwa niestandardowego emotikona.
`count`	`integer` Łączna liczba reakcji z użyciem powiązanego emotikona.

emoji

string

Ciąg znaków Unicode emotikona lub nazwa niestandardowego emotikona.

count

integer

Łączna liczba reakcji z użyciem powiązanego emotikona.

Adnotacje narzędzi

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌