Method: spaces.findGroupChats

تعرض هذه الطريقة جميع المساحات التي تتضمّن spaceType == GROUP_CHAT، والتي تتضمّن عضوياتها من المستخدمين بالضبط المستخدم الذي يطلب البيانات والمستخدمين المحدّدين في FindGroupChatsRequest.memberships.

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

يجب أن تحتوي مجموعة المستخدمين المحدّدة على عضويات بشرية (غير تابعة لتطبيقات) فقط. لا يعرض الطلب الذي يتضمّن مستخدمين غير بشريين أي مساحات.

يتطلّب مصادقة المستخدم باستخدام أحد نطاقات التفويض التالية:

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

طلب HTTP

GET https://chat.googleapis.com/v1/spaces:findGroupChats

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات طلب البحث

المعلمات
user[]

string

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

التنسيق: users/{user}، حيث يمثّل {user} إما id للشخص من People API، أو id للمستخدم في Directory API. على سبيل المثال، للعثور على جميع المحادثات الجماعية التي تضم المستخدم الذي يجري المكالمة ومستخدمَين آخرَين، مع أرقام تعريف الملف الشخصي 123456789 و987654321 في People API، يمكنك استخدام users/123456789 وusers/987654321. يمكنك أيضًا استخدام عنوان البريد الإلكتروني كاسم مستعار لـ {user}. على سبيل المثال، users/example@gmail.com حيث example@gmail.com هو البريد الإلكتروني لمستخدم Google Chat.

عندما يكون المستخدم الذي يجري المكالمة من مستخدمي Google Workspace، يجب أن يكون جميع المستخدمين المطلوبين أعضاءً في مؤسسة Google Workspace نفسها التي ينتمي إليها المستخدم الذي يجري المكالمة.
pageSize

integer

اختيارية: الحد الأقصى لعدد المسافات المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة.

إذا لم يتم تحديدها، سيتم عرض 100 مساحة على الأكثر.

الحدّ الأقصى للقيمة هو 1000. إذا استخدمت قيمة أكبر من 1000، سيتم تغييرها تلقائيًا إلى 1000.

تعرض القيم السالبة الخطأ INVALID_ARGUMENT.
pageToken

string

اختيارية: رمز مميز للصفحة تم استلامه من طلب سابق للعثور على محادثات جماعية قدِّم هذه المَعلمة لاسترداد الصفحة التالية.

عند تقسيم المحتوى إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة مع الطلب الذي قدّم الرمز المميّز. قد يؤدي تمرير قيم مختلفة إلى نتائج غير متوقّعة.
spaceView

enum (SpaceView)

نوع عرض المساحة المطلوب. إذا لم يتم ضبطها، تكون القيمة التلقائية SPACE_VIEW_RESOURCE_NAME_ONLY. يجب أن تتضمّن الطلبات التي تحدّد SPACE_VIEW_EXPANDED نطاقات تسمح بقراءة بيانات المساحة، مثل https://www.googleapis.com/auth/chat.spaces أو https://www.googleapis.com/auth/chat.spaces.readonly.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

استجابة تحتوي على مساحات محادثات جماعية تضم المستخدم الذي يجري المكالمة والمستخدمين المطلوبين فقط

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

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

object (Space)

قائمة المساحات في الصفحة المطلوبة (أو الصفحة الأولى).
nextPageToken

string

رمز مميّز يمكنك إرساله كـ pageToken لاسترداد الصفحة التالية من النتائج. إذا كانت فارغة، يعني ذلك أنّه لا توجد صفحات لاحقة.

نطاقات الأذونات

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

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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

SpaceView

طريقة عرض تحدّد الحقول التي يجب ملؤها في مرجع "المساحة". لضمان التوافق مع الإصدارات المستقبلية، ننصح بأن يراعي الرمز قيمًا إضافية.

عمليات التعداد
SPACE_VIEW_UNSPECIFIED القيمة التلقائية أو غير المضبوطة
SPACE_VIEW_RESOURCE_NAME_ONLY يتم ملء اسم مورد المساحة فقط.
SPACE_VIEW_EXPANDED تعبئة حقول مرجع "المساحة" ملاحظة: لن تتم تعبئة الحقل permissionSettings. يجب أن تتضمّن الطلبات التي تحدّد SPACE_VIEW_EXPANDED نطاقات تسمح بقراءة بيانات المساحة، مثل https://www.googleapis.com/auth/chat.spaces أو https://www.googleapis.com/auth/chat.spaces.readonly.