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