MCP Tools Reference: gmailmcp.googleapis.com

Araç: get_thread

Kimliği doğrulanmış kullanıcının Gmail hesabından belirli bir e-posta yazışma dizisini (ileti listesi dahil) alır.

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

Curl Request 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_thread",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

GetThread RPC için istek mesajı.

GetThreadRequest

JSON gösterimi 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
Alanlar
threadId

string

Zorunlu. Getirilecek ileti dizisinin benzersiz tanımlayıcısı.
messageFormat

enum (MessageFormat)

İsteğe bağlı. İleti dizisinde döndürülen iletilerin biçimini belirtir. Varsayılan olarak FULL_CONTENT değerine ayarlanır. Not: Gövde içeriğine veya eklerine ihtiyacınız varsa FULL_CONTENT'i kullanın. MINIMAL kullanılırken plaintext_body ve attachment_ids alanları doldurulmaz. Hangi biçimi kullanacağınızdan emin değilseniz FULL_CONTENT kullanarak varsayılan davranışı kullanın.

MessageFormat

İleti dizisindeki iletilerin ayrıntı düzeyini kontrol etmek için kullanılan enum.

Sıralamalar
MESSAGE_FORMAT_UNSPECIFIED Varsayılan olarak FULL_CONTENT değerine ayarlanır.
MINIMAL İleti snippet'lerini ve önemli üstbilgileri (Konu, Gönderen, Alıcı, Cc, Tarih) döndürür.
FULL_CONTENT "MINIMAL" (En Az) seçeneğindeki tüm bilgilerin yanı sıra her iletinin tam gövde içeriğini döndürür.

Çıkış şeması

İleti listesini içeren ileti dizisi.

İplik

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

string

İş parçacığının benzersiz tanımlayıcısı.
messages[]

object (Message)

İleti dizisindeki iletilerin kronolojik olarak sıralanmış listesi.

Mesaj

JSON gösterimi 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ]
}
Alanlar
id

string

Mesajın benzersiz tanımlayıcısı.
snippet

string

E-posta mesajının snippet'i.
subject

string

Üstbilgilerden çıkarılan ileti konusu:
sender

string

Gönderenin e-posta adresi.
toRecipients[]

string

Alıcı e-posta adreslerine
ccRecipients[]

string

CC alıcılarının e-posta adresleri.
date

string

İletinin ISO 8601 biçimindeki tarihi (YYYY-AA-GG).
plaintextBody

string

İletinin tam içeriği. Yalnızca MessageFormat FULL_CONTENT ise doldurulur.
attachmentIds[]

string

Yalnızca çıkış. Ek kimlikleri, yalnızca MessageFormat FULL_CONTENT ise doldurulur.

Araç Ek Açıklamaları

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