MCP Tools Reference: chatmcp.googleapis.com

Narzędzie: search_messages

Wyszukiwanie wiadomości w Google Chat za pomocą słów kluczowych i filtrów. Działa we wszystkich pokojach, do których użytkownik ma dostęp, lub może być ograniczony do konkretnej rozmowy.

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

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

Schemat danych wejściowych

Prośba o wyszukanie wiadomości w Google Chat za pomocą słów kluczowych i filtrów. Działa we wszystkich pokojach, do których użytkownik ma dostęp, lub może być ograniczony do konkretnej rozmowy.

SearchMessagesRequest

Zapis JSON 
{
  "searchParameters": {
    object (SearchParameters)
  },
  "pageSize": integer,
  "pageToken": string
}
Pola
searchParameters

object (SearchParameters)

Wymagane. Parametry wyszukiwania, których chcesz użyć.
pageSize

integer

Opcjonalnie. Maksymalna liczba wyników do zwrócenia (maksymalnie 100). Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 25 wyników.
pageToken

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania search_messages. Podaj ten token, aby pobrać kolejną stronę.

SearchParameters

Zapis JSON 
{
  "keywords": [
    string
  ],
  "conversationId": string,
  "sender": string,
  "isUnread": boolean,
  "hasLink": boolean,
  "startTime": string,
  "endTime": string,
  "mentionsMe": boolean,
  "conversationIncludesUser": string,
  "spaceDisplayNames": [
    string
  ]
}
Pola
keywords[]

string

Opcjonalnie. Zestaw słów kluczowych, które służą do filtrowania wyników.
conversationId

string

Opcjonalnie. Ogranicza wyszukiwanie do konkretnego identyfikatora rozmowy zwróconego przez narzędzie search_conversations. Format: spaces/{ID}.
sender

string

Opcjonalnie. Filtrowanie wiadomości od określonego użytkownika. Możesz użyć adresu e-mail lub nazwy zasobu nadawcy. Nazwy zasobów użytkownika mają format users/{ID}, gdzie {ID} może być identyfikatorem osoby lub jej adresem e-mail.
isUnread

boolean

Opcjonalnie. Filtruj wiadomości, które nie zostały przeczytane przez użytkownika dzwoniącego.
hasLink

boolean

Opcjonalnie. Filtruj wiadomości zawierające co najmniej 1 adres URL.
startTime

string

Opcjonalnie. Filtruj wiadomości utworzone po tym czasie. Format: sygnatura czasowa ISO 8601.
endTime

string

Opcjonalnie. Filtruj wiadomości utworzone przed tym czasem. Format: sygnatura czasowa ISO 8601.
mentionsMe

boolean

Opcjonalnie. Filtruj wiadomości, które wyraźnie wspominają o użytkowniku dzwoniącym.
conversationIncludesUser

string

Opcjonalnie. Filtruj wiadomości na czatach i czatach grupowych, które zawierają adres e-mail lub identyfikator konkretnego użytkownika.
spaceDisplayNames[]

string

Opcjonalnie. Filtruj według listy nazw pokoi. Wyświetlane nazwy pokoi są dopasowywane częściowo. Uwaga: zwracanych jest tylko 5 najlepszych wyników.

Schemat wyjściowy

Odpowiedź na wyszukiwanie wiadomości w Google Chat. Jeśli pole next_page_token jest wypełnione, można ponownie wywołać funkcję SearchMessages z tym tokenem, aby pobrać następną stronę wyników.

SearchMessagesResponse

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

object (ChatMessage)

Lista obiektów wiadomości, które spełniają kryteria wyszukiwania.
nextPageToken

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych 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 Markdown.
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 niestandardowa nazwa emotikona.
count

integer

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

UserType

Typ użytkownika Google Chat.

Wartości w polu enum
USER_TYPE_UNSPECIFIED Nie określono.
HUMAN Użytkownik.
APP użytkownik aplikacji,

Źródło

Źródło załącznika.

Wartości w polu enum
SOURCE_UNSPECIFIED Zarezerwowano.
DRIVE_FILE Plik pochodzi z Dysku Google.
UPLOADED_CONTENT Plik zostanie przesłany do Google Chat.

Adnotacje narzędzi

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