MCP Tools Reference: gmailmcp.googleapis.com

Araç: label_thread

Kimliği doğrulanmış kullanıcının Gmail hesabındaki bir ileti dizisinin tamamına etiket ekler. Bu işlem, şu anda mesaj dizisinde bulunan tüm iletileri ve gelecekte eklenecek iletileri etkiler.

İş parçacığı kimliğinden emin değilseniz önce search_threads aracını kullanın.

Bir kullanıcı etiketinin kimliğinden emin değilseniz önce list_labels aracını kullanarak mevcut etiketleri ve kimliklerini keşfedin. Bir ileti dizisine çöp kutusu etiketi veya spam etiketi eklemek için lütfen apply_sensitive_thread_label aracını kullanın.

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

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

Giriş Şeması

LabelThread RPC için istek mesajı.

LabelThreadRequest

JSON gösterimi 
{
  "threadId": string,
  "labelIds": [
    string
  ]
}
Alanlar
threadId

string

Zorunlu. Etiket eklenecek ileti dizisinin benzersiz tanımlayıcısı.
labelIds[]

string

Zorunlu. Eklenecek etiketlerin benzersiz tanımlayıcıları. Sistem etiketi kimliği (ör. "INBOX", "STARRED", "UNREAD", "IMPORTANT") veya kullanıcı tanımlı etiket kimliği olabilir. Araç, etiket adlarını değil label_ids değerini kabul eder. Kullanıcı tanımlı etiketlerin görünen adıyla ilgili etiketin kimliğini almak için list_labels aracını kullanın.

Çıkış Şeması

LabelThread RPC'si için yanıt mesajı.

Araç Ek Açıklamaları

Yıkıcı ipucu: ❌ | İdempotent ipucu: ✅ | Salt okunur ipucu: ❌ | Açık dünya ipucu: ❌

Yetkilendirme Kapsamları

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

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify