Method: spaces.members.list

يسرد العضوية في مساحة. على سبيل المثال، راجِع إنشاء قائمة بالمستخدمين وتطبيقات Google Chat في مساحة. تعرض بطاقة بيانات المتجر التي تستخدم ميزة المصادقة على التطبيق الاشتراكات في المساحات التي يمكن لتطبيق Chat الوصول إليها، ولكنها تستبعد الاشتراكات في التطبيقات في Chat، بما فيها المساحات الخاصة. تحتوي بطاقة بيانات المتجر باستخدام ميزة مصادقة المستخدم على إدراج الاشتراكات في المساحات التي يمكن للمستخدم الذي تمت مصادقته الوصول إليها.

تتطلب المصادقة. يتيح هذا الإجراء مصادقة التطبيقات ومصادقة المستخدم.

طلب HTTP

GET https://chat.googleapis.com/v1/{parent=spaces/*}/members

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

مَعلمات المسار

المعلمات
parent

string

مطلوب. اسم مورد المساحة التي يمكنك استرجاع قائمة عضوية لها.

التنسيق: Spaces/{space}

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

المعلمات
pageSize

integer

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

وفي حال عدم تحديد قيمة هذا الخيار، يتم إرجاع 100 عضوية كحدّ أقصى.

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

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

pageToken

string

اختياريّ. رمز مميّز للصفحة، تم تلقّيه من مكالمة سابقة لإدراج العضويات في القناة. قدِّم هذه المَعلمة لاسترداد الصفحة التالية.

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

filter

string

اختياريّ. فلتر طلب بحث

يمكنك فلترة الاشتراكات حسب دور العضو (role) والنوع (member.type).

للفلترة حسب الدور، اضبط role على ROLE_MEMBER أو ROLE_MANAGER.

للفلترة حسب النوع، اضبط member.type على HUMAN أو BOT. معاينة المطوّر: يمكنك أيضًا الفلترة حسب member.type باستخدام عامل التشغيل !=.

للفلترة حسب كل من الدور والنوع، استخدِم عامل التشغيل AND. للفلترة حسب الدور أو النوع، استخدِم عامل التشغيل OR.

يجب إدخال إما member.type = "HUMAN" أو member.type != "BOT" عند ضبط useAdminAccess على "صحيح". سيتم رفض فلاتر أنواع الأعضاء الأخرى.

على سبيل المثال، طلبات البحث التالية صالحة:

role = "ROLE_MANAGER" OR role = "ROLE_MEMBER"
member.type = "HUMAN" AND role = "ROLE_MANAGER"

member.type != "BOT"

طلبات البحث التالية غير صالحة:

member.type = "HUMAN" AND member.type = "BOT"
role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"

يرفض الخادم طلبات البحث غير الصالحة مع ظهور الخطأ INVALID_ARGUMENT.

showGroups

boolean

اختياريّ. عند تلقّي عضوية في قناة true، يتم أيضًا عرض العضويات المرتبطة بـ Google Group، بالإضافة إلى أنواع أخرى من العضويات. في حال ضبط filter، لن يتم عرض اشتراكات Google Group التي لا تتطابق مع معايير الفلتر.

showInvited

boolean

اختياريّ. عند عرض "true"، يعرض أيضًا العضويات المرتبطة بأعضاء invited، بالإضافة إلى أنواع أخرى من العضويات. وفي حال ضبط فلتر، لن يتم عرض عضويات invited التي لا تتطابق مع معايير الفلتر.

تتطلب حاليًا مصادقة المستخدم.

useAdminAccess

boolean

عند true، يتم تشغيل الطريقة باستخدام امتيازات مشرف Google Workspace للمستخدم.

يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات".

يتطلب نطاق OAuth 2.0 chat.admin.memberships.readonly أو chat.admin.memberships.

لا يمكن إدراج اشتراكات التطبيقات في مساحة عند استخدام إذن الوصول الإداري.

نص الطلب

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

نص الاستجابة

الرد لإدراج أعضاء المساحة في المساحة

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

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

object (Membership)

قائمة بدون ترتيب. قائمة العضويات الظاهرة على الصفحة المطلوبة (أو الأولى)

nextPageToken

string

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

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

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

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

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