يسرد الاشتراكات في مساحة. للحصول على مثال، يمكنك الاطّلاع على مقالة إدراج المستخدمين وتطبيقات Google Chat في مساحة. يتم إدراج الاشتراكات في البيانات باستخدام ميزة مصادقة التطبيقات في المساحات التي يمكن لتطبيق Chat الوصول إليها، ولكن يتم استبعاد تلك الاشتراكات في التطبيق، بما في ذلك الاشتراكات الخاصة بالتطبيق. تسرد الاشتراكات الداعمة عبر مصادقة المستخدم الاشتراكات في المساحات التي يمكن للمستخدم الذي تمت مصادقته الوصول إليها.
يتطلب المصادقة. يتوافق مع مصادقة التطبيقات ومصادقة المستخدم.
طلب HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/members
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
parent |
مطلوبة. اسم المورد للمساحة المطلوب جلب قائمة عضوية لها. التنسيق: المسافات/{space} |
معلمات طلب البحث
المَعلمات | |
---|---|
pageSize |
اختياريّ. الحدّ الأقصى لعدد العضويات المطلوب عرضها وقد تعرِض الخدمة أقل من هذه القيمة. وفي حال عدم تحديد قيمة هذه الميزة، يتمّ عرض 100 اشتراك داعم كحدّ أقصى. الحد الأقصى للقيمة هو 1000. إذا كنت تستخدم قيمة أكثر من 1000، سيتم تغييرها تلقائيًا إلى 1000. تعرض القيم السالبة خطأ |
pageToken |
اختياريّ. رمز مميّز للصفحة تم تلقّيه من مكالمة سابقة لإدراج العضويات في القناة. قدِّم هذه المَعلمة لاسترداد الصفحة التالية. عند تقسيم النتائج على عدّة صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدّمة مع الطلب الذي وفّر الرمز المميّز للصفحة. وقد يؤدي تمرير قيم مختلفة إلى المعلَمات الأخرى إلى نتائج غير متوقعة. |
filter |
اختياريّ. فلتر طلبات البحث يمكنك فلترة الاشتراكات حسب دور العضو ( للفلترة حسب الدور، اضبط السمة للفلترة حسب النوع، اضبط السمة لفلترة البيانات حسب الدور والنوع، استخدِم عامل التشغيل يجب إدخال إما على سبيل المثال، تعد طلبات البحث التالية صالحة:
طلبات البحث التالية غير صالحة:
رفض الخادم طلبات البحث غير الصالحة مع ظهور خطأ |
showGroups |
اختياريّ. عند عرض |
showInvited |
اختياريّ. عند عرض يتطلب حاليًا مصادقة المستخدم. |
useAdminAccess |
true ، يتم تشغيل الطريقة باستخدام امتيازات مشرف Google Workspace للمستخدم.يجب أن يكون مستخدم الاتصال مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". يتطلب ذلك نطاق OAuth 2.0 لا يتوفّر خيار إدراج اشتراكات التطبيقات في مساحة عند استخدام إذن وصول إداري. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
ردّ على قائمة العضويات في المساحة.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"memberships": [
{
object ( |
الحقول | |
---|---|
memberships[] |
قائمة بدون ترتيب. قائمة بالعضويات في الصفحة المطلوبة (أو الأولى) |
nextPageToken |
رمز مميز يمكنك إرساله باسم |
نطاقات التفويض
يتطلب استخدام أحد نطاقات 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
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.