MCP Tools Reference: gmailmcp.googleapis.com

الأداة: get_thread

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

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة get_thread في "حزمة أدوات إدارة المحتوى في البريد الإلكتروني" (MCP).

طلب Curl 
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
}'

مخطط الإدخال

رسالة الطلب لإجراء GetThread RPC.

GetThreadRequest

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

string

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

enum (MessageFormat)

اختياريّ. يحدّد تنسيق الرسائل التي يتم عرضها ضمن سلسلة المحادثات. القيمة التلقائية هي FULL_CONTENT. ملاحظة: إذا كنت بحاجة إلى محتوى نص الرسالة أو المرفقات، استخدِم FULL_CONTENT. عند استخدام MINIMAL، لن تتم تعبئة الحقلَين plaintext_body وattachment_ids. إذا لم تكن متأكدًا من التنسيق الذي يجب استخدامه، استخدِم السلوك التلقائي من خلال استخدام FULL_CONTENT.

MessageFormat

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

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

مخطط النتائج

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

Thread

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

string

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

object (Message)

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

Message

تمثيل JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    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

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

تلميح بشأن الإجراءات المدمّرة: ❌ | تلميح بشأن الإجراءات غير المؤثرة: ✅ | تلميح بشأن الإجراءات للقراءة فقط: ✅ | تلميح بشأن الإجراءات في العالم المفتوح: ❌