يسرد المساحات التي ينتمي إليها المتصل. ولا يتم إدراج المحادثات الجماعية والرسائل المباشرة حتى يتم إرسال الرسالة الأولى. للحصول على مثال، راجِع إدراج المساحات.
يتطلب المصادقة. يتوافق مع مصادقة التطبيقات ومصادقة المستخدم.
يسرد المساحات المرئية للمتصل أو المستخدم الذي تمت مصادقته. ولا يتم إدراج المحادثات الجماعية والرسائل المباشرة حتى يتم إرسال الرسالة الأولى.
طلب HTTP
GET https://chat.googleapis.com/v1/spaces
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات طلب البحث
المَعلمات | |
---|---|
pageSize |
اختياريّ. الحد الأقصى لعدد المسافات المطلوب عرضها. وقد تعرِض الخدمة أقل من هذه القيمة. في حال عدم تحديد قيمة، يتم عرض 100 مسافة كحدّ أقصى. الحد الأقصى للقيمة هو 1000. إذا كنت تستخدم قيمة أكثر من 1000، سيتم تغييرها تلقائيًا إلى 1000. تعرض القيم السالبة خطأ |
pageToken |
اختياريّ. رمز مميّز للصفحة تم تلقّيه من مكالمة سابقة لمساحات العمل في قائمة سابقة. قدِّم هذه المَعلمة لاسترداد الصفحة التالية. عند التقسيم على صفحات، يجب أن تتطابق قيمة الفلتر مع الطلب الذي تم توفير الرمز المميّز للصفحة. قد يؤدي تمرير قيمة مختلفة إلى نتائج غير متوقعة. |
filter |
اختياريّ. فلتر طلبات البحث يمكنك فلترة المساحات حسب نوع المساحة ( لفلترة البيانات حسب نوع المساحة، عليك تحديد قيمة تعداد صالحة، مثل على سبيل المثال، تعد طلبات البحث التالية صالحة:
رفض الخادم طلبات البحث غير الصالحة مع ظهور خطأ |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الاستجابة لطلب مساحات قائمة.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"spaces": [
{
object ( |
الحقول | |
---|---|
spaces[] |
قائمة بالمساحات في الصفحة المطلوبة (أو الأولى) |
nextPageToken |
يمكنك إرسال رمز مميّز بصفتك |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.readonly
https://www.googleapis.com/auth/chat.bot
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.