MCP Tools Reference: gmailmcp.googleapis.com

الأداة: search_threads

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

يمكن لهذه الأداة فلترة سلاسل المحادثات استنادًا إلى سلسلة طلب بحث وتتيح تقسيم النتائج على صفحات. تعرض هذه الأداة قائمة بسلاسل المحادثات، بما في ذلك أرقام تعريفها والرسائل ذات الصلة. تحتوي كل رسالة ذات صلة على تفاصيل مثل مقتطف من نص الرسالة والموضوع والمُرسِل والمستلِمين وما إلى ذلك. يُرجى العِلم أنّ هذه الأداة لا تعرض النصوص الكاملة للرسائل، لذا استخدِم أداة "get_thread" مع رقم تعريف سلسلة المحادثات لجلب النص الكامل للرسالة إذا لزم الأمر.

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة search_threads في "منصة التحكّم في المحادثات" (MCP).

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

مخطط الإدخال

رسالة الطلب لاستدعاء إجراء عن بُعد (RPC) في SearchThreads.

SearchThreadsRequest

تمثيل JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "includeTrash": boolean
}
الحقول

حقل الربط _page_size

يمكن أن يكون _page_size إحدى القيم التالية فقط:
pageSize

integer

اختياريّ. الحد الأقصى لعدد سلاسل المحادثات المطلوب عرضها. إذا لم يتم تحديد هذه المَعلمة، يتم تلقائيًا عرض 20 سلسلة محادثات. الحد الأقصى المسموح به هو 50.

حقل الربط _page_token

يمكن أن يكون _page_token إحدى القيم التالية فقط:
pageToken

string

اختياريّ. رمز الصفحة لاسترداد صفحة معيّنة من النتائج في القائمة. اترك هذا الحقل فارغًا لجلب الصفحة الأولى.

حقل الربط _query

يمكن أن يكون _query إحدى القيم التالية فقط:
query

string

اختياريّ. سلسلة طلب بحث لفلترة سلاسل المحادثات، باستخدام التنسيق نفسه المستخدَم في شريط البحث في Gmail. إذا تم حذف هذه المَعلمة، يتم عرض جميع سلاسل المحادثات (باستثناء الرسائل غير المرغوب فيها والرسائل في المهملات تلقائيًا). عوامل التشغيل الرئيسية: from: - الرسائل الواردة من مُرسِل معيّن. to: - الرسائل المُرسَلة إلى مستلِم معيّن. subject: - الرسائل التي تتضمّن كلمات معيّنة في الموضوع. - الرسائل التي تتضمّن كلمات معيّنة في النص أو الموضوع. is:unread - الرسائل غير المقروءة. is:starred - الرسائل التي تم وضع نجمة عليها. has:attachment - الرسائل التي تتضمّن مرفقات. after:YYYY/MM/DD - الرسائل المُرسَلة بعد تاريخ معيّن. before:YYYY/MM/DD - الرسائل المُرسَلة قبل تاريخ معيّن. newer_than:

 Examples:
 "subject:OneMCP Update"
 "from:gduser1@workspacesamples.dev"
 "to:gduser2@workspacesamples.dev AND newer_than:7d"
 "project proposal has:attachment"
 "is:unread"

حقل الربط _include_trash

يمكن أن يكون _include_trash إحدى القيم التالية فقط:
includeTrash

boolean

اختياريّ. تضمين المسودات من المهملات في النتائج. القيمة التلقائية هي "false".

مخطط الرد

رسالة الرد لاستدعاء إجراء عن بُعد (RPC) في SearchThreads.

SearchThreadsResponse

تمثيل JSON 
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string
}
الحقول
threads[]

object (Thread)

قائمة بملخّصات سلاسل المحادثات.
nextPageToken

string

رمز يمكن استخدامه في طلب لاحق لاسترداد الصفحة التالية من سلاسل المحادثات. يظهر هذا الحقل فقط إذا كانت هناك نتائج إضافية.

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
}
الحقول
id

string

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

string

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

string

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

string

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

string

عناوين البريد الإلكتروني للمستلِمين في الحقل "إلى".
ccRecipients[]

string

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

string

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

string

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

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

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