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
}'

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
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 
{
  "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.

ReactionSummary

Zapis JSON 
{
  "emoji": string,
  "count": integer
}
Pola
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: ❌