MCP Tools Reference: chatmcp.googleapis.com

Araç: search_conversations

Google Chat görüşmelerini görünen ada göre arar.

Yalnızca katılımcılar sağlanırsa bu araç, belirtilen katılımcıları ve arayan kullanıcıyı içeren bire bir doğrudan mesajları (bir katılımcı sağlanırsa) veya grup sohbetlerini (birden fazla katılımcı sağlanırsa) bulur.

Yalnızca bir sorgu sağlanırsa bu araç, sorgunun ileti dizisinin görünen adının büyük/küçük harfe duyarsız bir alt dizesi olduğu ileti dizilerini arar.

Hem katılımcılar hem de sorgu sağlanırsa bu araç, katılımcılara göre görüşmeleri bulur ve ardından bunları görünen ada göre filtreler.

Ne katılımcılar ne de sorgu sağlanırsa bu araç, arayan kullanıcının üyesi olduğu tüm görüşmeleri listeler.

Bu araç yalnızca arayan kullanıcının üyesi olduğu görüşmeleri listeler.

ÖNEMLİ: Boş bir "konuşmalar" listesi, genel olarak başka sonuç olmadığı anlamına gelmez. "next_page_token" mevcutsa daha fazla sayfa getirilebilir. Boş bir liste alırsanız ancak "next_page_token" varsa kullanıcıya aramaya devam edip etmemeniz gerektiğini sorun.

Aşağıdaki örnekte, curl kullanılarak search_conversations MCP aracının nasıl çağrılacağı gösterilmektedir.

Curl İsteği 
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": "search_conversations",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

FindConversations RPC için istek mesajı.

SearchConversationsRequest

JSON gösterimi 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
Alanlar
spaceNameQuery

string

İsteğe bağlı. Alan görünen adlarında aranacak metin.
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum alan sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmezse en fazla 100 alan döndürülür. Maksimum değer 1.000'dir. 1.000'in üzerindeki değerler 1.000'e zorlanır.
pageToken

string

İsteğe bağlı. Önceki bir search_conversations çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.
participants[]

string

İsteğe bağlı. Arayan hariç, görüşmeleri filtrelemek için kullanılacak katılımcıların e-posta adreslerinin listesi.

Çıkış şeması

FindConversations RPC'nin yanıt mesajı.

SearchConversationsResponse

JSON gösterimi 
{
  "conversations": [
    {
      object (Conversation)
    }
  ],
  "nextPageToken": string
}
Alanlar
conversations[]

object (Conversation)

Arama ölçütleriyle eşleşen görüşme nesnelerinin listesi.
nextPageToken

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

Etkileşim

JSON gösterimi 
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
Alanlar
conversationId

string

Görüşmenin kimliği (ör. "spaces/AAAAAAAAA").
displayName

string

Yazışmanın görünen adı.
conversationType

enum (ConversationType)

Görüşme türü (DIRECT_MESSAGE, GROUP_CHAT veya NAMED_SPACE).
lastActiveTimestamp

string (Timestamp format)

ISO 8601 biçiminde belirtilen, görüşmenin son etkin olduğu zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

Zaman damgası

JSON gösterimi 
{
  "seconds": string,
  "nanos": integer
}
Alanlar
seconds

string (int64 format)

Unix sıfır zamanı 1970-01-01T00:00:00Z'den itibaren UTC zamanının saniyelerini gösterir. -62135596800 ile 253402300799 arasında olmalıdır (0001-01-01T00:00:00Z ile 9999-12-31T23:59:59Z'ye karşılık gelir).
nanos

integer

Nanosaniye çözünürlüğünde, negatif olmayan saniyenin kesirleri. Bu alan, sürenin nanosaniye kısmıdır ve saniyenin alternatifi değildir. Kesirli negatif saniye değerleri, zaman içinde ileriye doğru sayılan negatif olmayan nanos değerlerine sahip olmalıdır. 0 ile 999.999.999 arasında olmalıdır (bu değerler dahil).

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌