MCP Tools Reference: gmailmcp.googleapis.com

Araç: unlabel_message

Kimliği doğrulanmış kullanıcının Gmail hesabındaki belirli bir iletiden bir veya daha fazla etiketi kaldırır. İleti kimliğini bulmak için search_threads veya get_thread gibi araçları kullanın. Bir kullanıcı etiketinin kimliğinden emin değilseniz önce list_labels aracını kullanarak mevcut etiketleri ve kimliklerini keşfedin.

Aşağıdaki örnekte, unlabel_message 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": "unlabel_message",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

UnlabelMessage RPC için istek mesajı.

UnlabelMessageRequest

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

string

Zorunlu. Etiketlerin kaldırılacağı iletinin kimliği.
labelIds[]

string

Zorunlu. Kaldırılacak etiketlerin kimlikleri. Sistem etiketi kimliği (ör. "INBOX", "TRASH", "SPAM", "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ı

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

Araç Ek Açıklamaları

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://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify