MCP Tools Reference: chatmcp.googleapis.com

Araç: list_messages

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

Aşağıdaki kod örneğinde, list_messages MCP aracını çağırmak için curl öğesinin 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 MCP tool 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. Görüşme; alan, doğrudan mesaj (DM) veya grup DM'si/Chat olabilir. Biçim: spaces/{space}
threadId

string

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

integer

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

string

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

string

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

string

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

Çı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, yeniden eskiye doğru sıralanmış şekilde (en yeni mesaj en üstte) gösterilir.
nextPageToken

string

Sonraki mesaj sayfasını almak için sonraki bir 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)
    }
  ],
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  }
}
Alanlar
messageId

string

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

string

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

string

Markdown biçimlendirmesi kullanılarak mesajın metin gövdesi.
sender

object (User)

Mesajı gönderen kişi.
createTime

string

Yalnızca çıkış. Mesajın oluşturulduğu zaman damgası. Biçim: ISO 8601 zaman damgası.
threadedReply

boolean

Mesajın bir mesaj dizisi yanıtı olup olmadığı.
attachments[]

object (ChatAttachmentMetadata)

İletiye eklenen dosyalar.
reactionSummaries[]

object (ReactionSummary)

Mesaja dahil edilen emoji tepkilerinin özeti.
quotedMessageMetadata

object (QuotedMessageMetadata)

Yalnızca çıkış. Bu iletide alıntılanan veya yönlendirilen orijinal iletiyle ilgili bilgiler. Not: Bu alan geliştirme aşamasındadır ve henüz tüm ortamlarda kullanılamayabilir.

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),
  "driveFileId": string
}
Alanlar
attachmentId

string

Ekin kaynak adı. Biçim: spaces/{alan}/messages/{mesaj}/attachments/{ek}.
filename

string

Ekin adı.
mimeType

string

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

enum (Source)

Ekin kaynağı.
driveFileId

string

Yalnızca çıkış. Google Drive dosyasının kimliği. Yalnızca kaynak DRIVE_FILE olduğunda doldurulur. Google Drive MCP ile kullanın.

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 tepkilerin toplam sayısı.

QuotedMessageMetadata

JSON gösterimi 
{
  "messageId": string,
  "lastUpdateTime": string,
  "quoteType": enum (QuoteType),
  "plaintextBody": string,
  "sender": string,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "forwardedMetadata": {
    object (ForwardedMetadata)
  }
}
Alanlar
messageId

string

Yalnızca çıkış. Alıntılanan veya yönlendirilen orijinal mesajın kaynak adı. Biçim: spaces/{space}/messages/{message}
lastUpdateTime

string

Yalnızca çıkış. Orijinal mesajın oluşturulduğu veya alıntılanmadan ya da yönlendirilmeden önce en son güncellendiği zaman damgası. Biçim: ISO 8601 zaman damgası.
quoteType

enum (QuoteType)

Yalnızca çıkış. Alıntının türü.
plaintextBody

string

Yalnızca çıkış. Alıntı yapma veya yönlendirme sırasında orijinal iletinin metin gövdesinin anlık görüntüsü. FORWARD için Markdown, REPLY için düz metin kullanılarak biçimlendirilir.
sender

string

Yalnızca çıkış. Orijinal mesajın yazarının görünen adı.
attachments[]

object (ChatAttachmentMetadata)

Yalnızca çıkış. Orijinal iletinin parçası olan ekler. Yalnızca FORWARD teklif türü için doldurulur.
forwardedMetadata

object (ForwardedMetadata)

Yalnızca çıkış. Yönlendirilen mesajın kaynak görüşmesiyle ilgili meta veriler. Yalnızca FORWARD teklif türü için doldurulur.

ForwardedMetadata

JSON gösterimi 
{
  "conversationId": string,
  "conversationDisplayName": string
}
Alanlar
conversationId

string

Yalnızca çıkış. Kaynak görüşmenin kaynak adı. Biçim: spaces/{space}
conversationDisplayName

string

Yalnızca çıkış. Mesajın yönlendirildiği sırada kaynak görüşmenin görünen adı. Adlandırılmış alanlar için bu, alan adıdır. Bire bir doğrudan mesajlarda bu, diğer katılımcının adıdır. Adsız grup sohbetleri için bu, üyelerin adlarına göre oluşturulan bir addır.

UserType

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

Sıralamalar
USER_TYPE_UNSPECIFIED Belirtilmedi.
HUMAN Gerçek kişi.
APP Uygulama kullanıcısı.

Kaynak

Ekin kaynağı.

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

QuoteType

Mesajın alıntı yanıt mı yoksa yönlendirilmiş mesaj mı olduğunu gösteren alıntı türü.

Sıralamalar
QUOTE_TYPE_UNSPECIFIED Ayrıldı. Tanımlanmamış teklif türü.
REPLY Mesaj, aynı ileti dizisindeki orijinal bir mesajın alıntılanarak yanıtlanmasıdır.
FORWARD Mesaj, farklı bir görüşmedeki orijinal bir mesajdan veya aynı görüşmedeki farklı bir ileti dizisinden yönlendirilmiştir.

Araç Notları

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

Başlık dizesiyle birlikte aşağıdaki boole ipuçları şu şekilde tanımlanır:

  • readOnlyHint: Doğru ise araç, ortamını değiştirmez. Varsayılan: false.
  • destructiveHint: Doğru ise 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ğru ise aracın aynı bağımsız değişkenlerle tekrar tekrar çağrılması, ortamı üzerinde ek bir etki yaratmaz. Varsayılan: false.
  • openWorldHint: Doğru ise araç, harici varlıkların "açık dünyası" ile etkileşime girebilir. Yanlış ise araç yalnızca dahili varlıklarla etkileşim kurabilir. Örneğin, web arama aracı açık dünya iken bellek aracı açık dünya değildir.

Yıkıcı İpucu: ❌ | Eşgüçlü İ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