MCP Tools Reference: chatmcp.googleapis.com

Narzędzie: search_conversations

Wyszukuje rozmowy w Google Chat według nazwy wyświetlanej.

Jeśli podasz tylko uczestników, to narzędzie znajdzie wiadomości bezpośrednie 1:1 (jeśli podasz jednego uczestnika) lub czaty grupowe (jeśli podasz wielu uczestników), które obejmują określonych uczestników i użytkownika dzwoniącego.

Jeśli podasz tylko zapytanie, to narzędzie wyszuka rozmowy, w których zapytanie jest podciągiem nazwy wyświetlanej rozmowy (bez uwzględniania wielkości liter).

Jeśli podasz zarówno uczestników, jak i zapytanie, to narzędzie znajdzie rozmowy według uczestników, a następnie odfiltruje je według nazwy wyświetlanej.

Jeśli nie podasz uczestników ani zapytania, to narzędzie wyświetli listę wszystkich rozmów, w których uczestniczy użytkownik wywołujący.

To narzędzie wyświetla tylko rozmowy, w których uczestniczy dany użytkownik.

WAŻNE: pusta lista „conversations” nie oznacza, że nie ma już więcej wyników. Jeśli występuje parametr „next_page_token”, można pobrać więcej stron. Jeśli otrzymasz pustą listę, ale token „next_page_token”, zapytaj użytkownika, czy chcesz kontynuować wyszukiwanie.

Poniższy przykład pokazuje, jak za pomocą curl wywołać narzędzie search_conversations 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_conversations",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schemat danych wejściowych

Prośba o wyszukiwanie wątków w Google Chat za pomocą filtrów.

SearchConversationsRequest

Zapis JSON 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
Pola
spaceNameQuery

string

Opcjonalnie. Tekst do wyszukania w nazwach wyświetlanych pokoi.
pageSize

integer

Opcjonalnie. Maksymalna liczba miejsc do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podasz tej wartości, zwrócimy maksymalnie 100 przestrzeni. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.
pageToken

string

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

string

Opcjonalnie. Lista adresów e-mail uczestników, według których mają być filtrowane rozmowy (z wyłączeniem osoby dzwoniącej).

Schemat wyjściowy

Odpowiedź zawierająca listę pasujących rozmów.

SearchConversationsResponse

Zapis JSON 
{
  "conversations": [
    {
      object (Conversation)
    }
  ],
  "nextPageToken": string
}
Pola
conversations[]

object (Conversation)

Lista obiektów konwersacji pasujących do kryteriów 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.

Rozmowa

Zapis JSON 
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
Pola
conversationId

string

Identyfikator rozmowy (np. „spaces/AAAAAAAAA”).
displayName

string

Wyświetlana nazwa rozmowy.
conversationType

enum (ConversationType)

Typ rozmowy (DIRECT_MESSAGE, GROUP_CHAT lub NAMED_SPACE).
lastActiveTimestamp

string (Timestamp format)

Ostatnia aktywność w konwersacji w formacie ISO 8601.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

Sygnatura czasowa

Zapis JSON 
{
  "seconds": string,
  "nanos": integer
}
Pola
seconds

string (int64 format)

Reprezentuje sekundy czasu UTC od epoki uniksowej 1970-01-01T00:00:00Z. Musi mieścić się w przedziale od -62135596800 do 253402300799 (włącznie), co odpowiada zakresowi od 0001-01-01T00:00:00Z do 9999-12-31T23:59:59Z.
nanos

integer

Nieujemne ułamki sekundy w rozdzielczości nanosekundowej. To pole zawiera część czasu trwania w nanosekundach, a nie alternatywę dla sekund. Ujemne wartości sekund z ułamkami muszą mieć nieujemne wartości nanosekund, które liczą czas do przodu. Musi mieścić się w zakresie od 0 do 999 999 999 włącznie.

ConversationType

Określa typ rozmowy.

Wartości w polu enum
CONVERSATION_TYPE_UNSPECIFIED Nie określono.
NAMED_SPACE nazwany pokój,
GROUP_CHAT czat grupowy z co najmniej 3 osobami;
DIRECT_MESSAGE Czat między 2 osobami lub między osobą a aplikacją w Google Chat.

Adnotacje narzędzi

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