MCP Tools Reference: chatmcp.googleapis.com

الأداة: search_conversations

يبحث عن محادثات Google Chat حسب الاسم المعروض.

في حال توفير المشاركين فقط، تعثر هذه الأداة على الرسائل المباشرة بين شخصين (إذا تم توفير مشارك واحد) أو محادثات جماعية (إذا تم توفير عدة مشاركين) تتضمّن المشاركين المحدّدين والمستخدم الذي يجري البحث.

في حال تقديم طلب بحث فقط، تبحث هذه الأداة عن المحادثات التي يكون فيها طلب البحث سلسلة فرعية غير حساسة لحالة الأحرف من الاسم المعروض للمحادثة.

في حال توفير كل من المشاركين وطلب البحث، تعثر هذه الأداة على المحادثات حسب المشاركين ثم تفلترها حسب الاسم المعروض.

في حال عدم توفير المشاركين أو طلب البحث، تعرض هذه الأداة جميع المحادثات التي يكون المستخدم المتصل عضوًا فيها.

لا تعرض هذه الأداة سوى المحادثات التي يكون المستخدم الذي يجري المكالمة عضوًا فيها.

ملاحظة مهمة: لا تعني قائمة "المحادثات" الفارغة أنّه لم يعُد هناك أي نتائج بشكل عام. إذا كان الرمز المميز next_page_token متوفّرًا، يمكن جلب المزيد من الصفحات. إذا تلقّيت قائمة فارغة ولكن ظهر الرمز next_page_token، اسأل المستخدم عمّا إذا كان يجب مواصلة البحث.

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

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

مخطط الإدخال

طلب البحث في محادثات Google Chat باستخدام الفلاتر

SearchConversationsRequest

تمثيل JSON 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
الحقول
spaceNameQuery

string

اختياريّ. النص المطلوب البحث عنه في الأسماء المعروضة للمساحات.
pageSize

integer

اختياريّ. الحدّ الأقصى لعدد المساحات المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 100 مساحة على الأكثر. الحد الأقصى للقيمة هو 1000، وسيتم فرض القيمة 1000 على القيم الأعلى من 1000.
pageToken

string

اختياريّ. رمز مميز للصفحة تم تلقّيه من طلب search_conversations سابق. يجب تقديم هذا الرمز لاسترداد الصفحة التالية.
participants[]

string

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

مخطط النتائج

ردّ يتضمّن قائمة بالمحادثات المطابقة

SearchConversationsResponse

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

object (Conversation)

قائمة بكائنات المحادثات التي تطابق معايير البحث
nextPageToken

string

رمز مميّز يمكن إرساله كـ page_token لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

المحادثة

تمثيل JSON 
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
الحقول
conversationId

string

رقم تعريف المحادثة (على سبيل المثال، "spaces/AAAAAAAAA").
displayName

string

الاسم المعروض للمحادثة.
conversationType

enum (ConversationType)

نوع المحادثة (DIRECT_MESSAGE أو GROUP_CHAT أو NAMED_SPACE)
lastActiveTimestamp

string (Timestamp format)

تمثّل هذه السمة آخر وقت كانت فيه المحادثة نشطة بتنسيق ISO 8601.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".

الطابع الزمني

تمثيل JSON 
{
  "seconds": string,
  "nanos": integer
}
الحقول
seconds

string (int64 format)

تمثّل هذه السمة عدد ثواني التوقيت العالمي المنسق (UTC) المنقضية منذ بداية حقبة يونكس 1970-01-01T00:00:00Z. يجب أن تتراوح القيمة بين ‎-62135596800 و253402300799، بما في ذلك طرفي النطاق (وهو ما يتوافق مع النطاق من 0001-01-01T00:00:00Z إلى 9999-12-31T23:59:59Z).
nanos

integer

تشير هذه السمة إلى أجزاء الثانية غير السالبة بدقة النانو ثانية هذا الحقل هو جزء من المدة بوحدة النانو ثانية، وليس بديلاً عن الثواني. يجب أن تتضمّن قيم الثواني السالبة مع الكسور قيمًا غير سالبة للنانو ثانية يتم احتسابها للأمام في الوقت. يجب أن تتراوح القيمة بين 0 و999,999,999، بما في ذلك طرفي النطاق.

ConversationType

تحدّد هذه السمة نوع المحادثة.

عمليات التعداد
CONVERSATION_TYPE_UNSPECIFIED غير محدد
NAMED_SPACE مساحة تحمل اسمًا
GROUP_CHAT محادثة جماعية بين ثلاثة أشخاص أو أكثر
DIRECT_MESSAGE رسالة مباشرة بين شخصين أو بين شخص وتطبيق Chat

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

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