MCP Tools Reference: chatmcp.googleapis.com

الأداة: list_memberships

تعرض هذه الأداة قوائم العضويات في محادثة على Google Chat.

يوضّح نموذج الرمز البرمجي التالي كيفية استخدام curl لاستدعاء أداة list_memberships في MCP.

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

مخطط الإدخال

ListMembershipsRequest

تمثيل JSON 
{
  "conversationId": string,
  "pageSize": integer,
  "pageToken": string,
  "membershipFilter": enum (MembershipFilter)
}
الحقول
conversationId

string

الحقل مطلوب. معرّف المحادثة التي سيتم عرض عضوياتها التنسيق: spaces/{space}
pageSize

integer

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

string

اختياريّ. رمز مميّز للصفحة تم تلقّيه من استدعاء سابق للدالة list_memberships يُرجى تقديم هذا الرمز لاسترداد الصفحة التالية.
membershipFilter

enum (MembershipFilter)

اختياريّ. يحدّد هذا الحقل مجموعة العضويات الفرعية المطلوب عرضها. إذا لم يتم تحديد أي قيمة، يتم عرض العضويات التي تم الانضمام إليها فقط.

MembershipFilter

يحدّد هذا الحقل مجموعة العضويات الفرعية المطلوب عرضها.

عمليات التعداد
MEMBERSHIP_FILTER_UNSPECIFIED القيمة التلقائية إذا لم يتم تحديد أي قيمة، يتم عرض العضويات التي تم الانضمام إليها فقط.
JOINED_ONLY يتم عرض العضويات التي تم الانضمام إليها فقط.
JOINED_AND_INVITED يتم عرض العضويات التي تم الانضمام إليها والتي تم توجيه دعوة للانضمام إليها.

مخطط النتائج

الردّ الذي يحتوي على قائمة العضويات في المحادثة

ListMembershipsResponse

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

object (Membership)

قائمة العضويات في المحادثة المطلوبة
nextPageToken

string

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

Membership

تمثيل JSON 
{
  "member": {
    object (User)
  },
  "state": enum (State),
  "role": enum (Role)
}
الحقول
member

object (User)

المستخدم العضو
state

enum (State)

النتائج فقط. حالة العضوية
role

enum (Role)

دور العضو

المستخدم

تمثيل JSON 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
الحقول
userId

string

اسم المورِد لمستخدم Chat التنسيق: users/{user}
displayName

string

الاسم المعروض لمستخدم Chat
email

string

عنوان البريد الإلكتروني للمستخدم تتم تعبئة هذا الحقل فقط عندما يكون نوع المستخدم HUMAN.
userType

enum (UserType)

نوع المستخدم

UserType

نوع مستخدم Google Chat

عمليات التعداد
USER_TYPE_UNSPECIFIED غير محدد
HUMAN مستخدم بشري
APP مستخدم تطبيق

ولاية

حالة العضوية

عمليات التعداد
STATE_UNSPECIFIED غير محدد
JOINED المستخدم عضو في مساحة العمل.
INVITED تمت دعوة المستخدم للانضمام إلى مساحة العمل.

الدور

دور العضو

عمليات التعداد
ROLE_UNSPECIFIED غير محدد
MEMBER المستخدم عضو في مساحة العمل.
MANAGER المستخدم مدير مساحة العمل.
ASSISTANT_MANAGER المستخدم مساعد مدير مساحة العمل.

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

يتم إرسال التعليقات التوضيحية للأداة إلى عملاء MCP لوصف المخاطر الأساسية لأداة معيّنة. تتعامل معظم البرامج مع هذه التلميحات على أنّها غير موثوق بها، ولكن يمكن استخدامها لتحديد الوقت الذي قد يتم فيه إرسال طلب تأكيد إلى المستخدم.

بالإضافة إلى سلسلة العنوان، يتم تعريف التلميحات المنطقية التالية على النحو التالي:

  • readOnlyHint: إذا كانت القيمة "صحيح"، لا تعدّل الأداة بيئتها. القيمة التلقائية: "خطأ"
  • destructiveHint: إذا كانت القيمة "صحيح"، يمكن للأداة تنفيذ إجراءات مدمّرة. إذا كانت القيمة "خطأ"، يمكن للأداة تنفيذ إجراءات إضافية فقط. القيمة التلقائية: "صحيح"
  • idempotentHint: إذا كانت القيمة "صحيح"، لن يؤدي استدعاء الأداة بشكل متكرّر باستخدام الوسيطات نفسها إلى أي تأثير إضافي على بيئتها. القيمة التلقائية: "خطأ"
  • openWorldHint: إذا كانت القيمة "صحيح"، يمكن للأداة التفاعل مع "عالم مفتوح" من الكيانات الخارجية. إذا كانت القيمة "خطأ"، يمكن للأداة التفاعل مع الكيانات الداخلية فقط. على سبيل المثال، ستكون أداة البحث على الويب عالمًا مفتوحًا، بينما لن تكون أداة الذاكرة عالمًا مفتوحًا.

تلميح مدمّر: ❌ | تلميح متكرّر: ✅ | تلميح للقراءة فقط: ✅ | تلميح للعالم المفتوح: ❌

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

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

  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly