MCP Tools Reference: chatmcp.googleapis.com

Araç: list_messages

Belirtilen Google Chat görüşmesindeki (alan, doğrudan mesaj (DM) veya grup DM'si) mesajları Markdown biçiminde alır. İleti dizisine, zaman aralığına ve ileti sayısına göre filtreleme yapılmasına olanak tanır. Ayrıca, daha fazla bağlam bilgisi sağlamak için sonraki ileti sayfası da alınabilir. Özel mesajlar (yalnızca tek birốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngốngống

Aşağıdaki kod örneğinde, list_messages MCP aracını çağırmak için curl simgesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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
}'

Giriş Şeması

ListChatMessagesRequest

JSON gösterimi 
{
  "conversationId": string,
  "threadId": string,
  "pageSize": integer,
  "pageToken": string,
  "startTime": string,
  "endTime": string
}
Alanlar
conversationId

string

Zorunlu. Görüşmenin kimliği. Bir görüşme; alan, doğrudan mesaj (DM) veya grup DM/Chat olabilir. Biçim: spaces/{space}
threadId

string

İsteğe bağlı. Görüşmedeki belirli bir ileti dizisinin kimliği. Belirtilirse yalnızca bu ileti dizisindeki iletiler döndürülür. Atlanırsa görüşmedeki tüm ileti dizilerinden gelen iletiler dikkate alınır. Biçim: spaces/{space}/threads/{thread}
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum mesaj sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmemişse varsayılan olarak 20 olur. Maksimum değer 50'dir. 50'den büyük bir değer kullanırsanız bu değer otomatik olarak 50 olarak değiştirilir.
pageToken

string

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

string

İsteğe bağlı. İletileri filtrelemek için ISO 8601 zaman damgası. Yalnızca bu tarihten sonra oluşturulan mesajlar döndürülür.
endTime

string

İsteğe bağlı. İletileri filtrelemek için ISO 8601 zaman damgası. মহিলাদের জন্য পোশাকের দোকান

Çıkış şeması

İstenen görüşmedeki mesajların listesini içeren yanıt.

ListChatMessagesResponse

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

object (ChatMessage)

Alınan mesajların listesi, ters kronolojik sırayla (en yeni mesaj en başta) gösterilir.
nextPageToken

string

Bir sonraki ileti sayfasını almak için sonraki ListMessagesRequest içinde page_token olarak gönderilebilen bir jeton. Bu alan boşsa başka sayfa yoktur.

ChatMessage

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

string

İletinin kaynak adı. Biçim: spaces/{space}/messages/{message}
threadId

string

Bu iletinin ait olduğu ileti dizisi. İleti işlenmemişse bu alan boş olur. Biçim: spaces/{space}/threads/{thread}
plaintextBody

string

Markdown biçimlendirmesi kullanılarak oluşturulan iletinin metin gövdesi.
sender

object (User)

Mesajın göndereni.
createTime

string

Yalnızca çıkış. İletinin oluşturulduğu zaman damgası.
threadedReply

boolean

İletinin ileti dizisi yanıtı olup olmadığı.
attachments[]

object (ChatAttachmentMetadata)

İletiye eklenen dosyalar.
reactionSummaries[]

object (ReactionSummary)

Mesaja eklenen emoji tepkilerinin özeti.

Kullanıcı

JSON gösterimi 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Alanlar
userId

string

Chat kullanıcısının kaynak adı. Biçim: users/{user}.
displayName

string

Chat kullanıcısının görünen adı.
email

string

Kullanıcının e-posta adresi. Bu alan yalnızca kullanıcı türü HUMAN olduğunda doldurulur.
userType

enum (UserType)

Kullanıcının türü.

ChatAttachmentMetadata

JSON gösterimi 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
Alanlar
attachmentId

string

Ekin kaynak adı. Biçim: spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

Ekin adı.
mimeType

string

İçerik türü (MIME türü).
source

enum (Source)

Ekin kaynağı.

ReactionSummary

JSON gösterimi 
{
  "emoji": string,
  "count": integer
}
Alanlar
emoji

string

Emoji Unicode dizesi veya özel emoji adı.
count

integer

İlişkili emoji kullanılarak verilen toplam tepki sayısı.

UserType

Google Chat kullanıcısının türü.

Sıralamalar
USER_TYPE_UNSPECIFIED Belirtilmedi.
HUMAN Gerçek bir kullanıcı.
APP Uygulama kullanıcısı.

Kaynak

Ekin kaynağı.

Sıralamalar
SOURCE_UNSPECIFIED Ayrılan
DRIVE_FILE Dosya, Google Drive dosyasıdır.
UPLOADED_CONTENT Dosya Chat'e yüklenir.

Araç Ek Açıklamaları

Araç açıklamaları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilmeyen olarak değerlendirir ancak onay isteminin kullanıcıya ne zaman gönderileceğine karar vermek için kullanılabilirler.

Başlık dizesinin yanı sıra aşağıdaki Boole ipuçları şu şekilde tanımlanır:

  • readOnlyHint: Doğruysa araç ortamını değiştirmez. Varsayılan: false.
  • destructiveHint: Doğruysa araç, yıkıcı işlemler gerçekleştirebilir. Yanlış ise araç yalnızca ekleme işlemleri gerçekleştirebilir. Varsayılan: true.
  • idempotentHint: Doğruysa aynı bağımsız değişkenlerle aracı tekrar tekrar çağırmanın ortamı üzerinde ek bir etkisi olmaz. Varsayılan: false.
  • openWorldHint: Doğruysa araç, harici öğelerden oluşan bir "açık dünya" ile etkileşim kurabilir. Yanlışsa araç yalnızca dahili öğelerle etkileşim kurabilir. Örneğin, bir web arama aracı açık dünya olurken bir bellek aracı açık dünya olmaz.

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

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly