MCP Tools Reference: gmailmcp.googleapis.com

الأداة: get_thread

يسترد سلسلة رسائل إلكترونية معيّنة من حساب Gmail الخاص بالمستخدم الذي تمّت مصادقته، بما في ذلك قائمة برسائله.

يتحكّم المَعلمة الاختيارية messageFormat في تنسيق الرسائل التي يتم عرضها. بشكلٍ تلقائي (أو باستخدام FULL_CONTENT)، يعرض المحتوى الكامل للرسائل. استخدِم MINIMAL لتضمين الموضوع والمقتطف فقط (باستثناء النص الأساسي). استخدِم METADATA_ONLY لتضمين البيانات الوصفية الأساسية فقط (معرّف الرسالة ومعرّف سلسلة المحادثات والتصنيفات والطابع الزمني وتقدير الحجم).

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة get_thread MCP.

طلب Curl 
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": "get_thread",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

رسالة الطلب الخاصة باستدعاء إجراء GetThread عن بُعد

GetThreadRequest

تمثيل JSON 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
الحقول
threadId

string

الحقل مطلوب. المعرّف الفريد لسلسلة المحادثات المطلوب استرجاعها.
messageFormat

enum (MessageFormat)

اختياريّ. تحدّد هذه السمة تنسيق الرسائل المعروضة ضمن سلسلة المحادثات. القيمة التلقائية هي FULL_CONTENT. ملاحظة: يعرض التنسيق MINIMAL المعرّف والمقتطف والموضوع والمرسِل والمستلِم ونسخة إلى والتاريخ وlabelIds. يعرض التنسيق METADATA_ONLY المعرّف، ومن، وإلى، ونسخة طبق الأصل، والتاريخ، وlabelIds. تعرض FULL_CONTENT المعرّف والمقتطف والموضوع والمرسل إليه والمستلم ونسخة إلى والتاريخ ومعرّفات التصنيفات ومعرّفات المرفقات والنص العادي ورمز HTML والمرفقات.

MessageFormat

تعداد للتحكّم في مستوى تفاصيل الرسائل في سلسلة المحادثات.

عمليات التعداد
MESSAGE_FORMAT_UNSPECIFIED القيمة التلقائية هي FULL_CONTENT.
MINIMAL تعرض هذه الطريقة مقتطفات من الرسائل والعناوين الرئيسية (الموضوع، من، إلى، نسخة إلى، التاريخ).
FULL_CONTENT تعرِض هذه السمة جميع المعلومات في "MINIMAL" بالإضافة إلى محتوى نص كل رسالة.
METADATA_ONLY البيانات الوصفية فقط: لا تشمل الموضوع والمقتطف والنص وأسماء ملفات المرفقات.

مخطط النتائج

سلسلة محادثات تحتوي على قائمة بالرسائل

Thread

تمثيل JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
الحقول
id

string

المعرّف الفريد لسلسلة المحادثات.
messages[]

object (Message)

قائمة بالرسائل في سلسلة المحادثات، مرتبة حسب التسلسل الزمني

رسالة

تمثيل JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ],
  "htmlBody": string,
  "attachments": [
    {
      object (AttachmentMetadata)
    }
  ],
  "labelIds": [
    string
  ]
}
الحقول
id

string

المعرّف الفريد للرسالة.
snippet

string

مقتطف من نص الرسالة
subject

string

موضوع الرسالة المستخرَج من العناوين:
sender

string

عنوان البريد الإلكتروني للمُرسِل
toRecipients[]

string

إلى عناوين البريد الإلكتروني للمستلِمين
ccRecipients[]

string

عناوين البريد الإلكتروني للمستلِمين في الحقل "نسخة إلى"
date

string

تاريخ الرسالة بتنسيق ISO 8601 (YYYY-MM-DD)
plaintextBody

string

محتوى النص الكامل، ويتم ملؤه فقط إذا كانت قيمة MessageFormat هي FULL_CONTENT.
attachmentIds[]

string

النتائج فقط. معرّفات المرفقات، ويتم ملؤها فقط إذا كانت قيمة MessageFormat هي FULL_CONTENT.
htmlBody

string

محتوى HTML للرسالة الإلكترونية، تتم تعبئته فقط إذا كانت قيمة MessageFormat هي FULL_CONTENT.
attachments[]

object (AttachmentMetadata)

النتائج فقط. المرفقات، تتم تعبئة هذا الحقل فقط إذا كانت قيمة MessageFormat هي FULL_CONTENT.
labelIds[]

string

معرّفات التصنيفات المرفقة بالرسالة. يتضمّن هذا الحقل أرقام تعريف تصنيفات المستخدمين وتصنيفات النظام العادية التي تقتصر على INBOX وSPAM وTRASH وUNREAD وSTARRED وIMPORTANT وSENT وDRAFT وCHAT.

AttachmentMetadata

تمثيل JSON 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
الحقول
id

string

النتائج فقط. معرّف المرفق.
mimeType

string

نوع MIME للمرفق.
filename

string

اسم ملف المرفق

التعليقات التوضيحية للأدوات

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

نطاقات التفويض

يجب توفير أحد نطاقات OAuth التالية:

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