تعرض هذه السمة المساحات التي يكون المتصل عضوًا فيها. لا يتم إدراج المحادثات الجماعية والرسائل المباشرة إلى أن يتم إرسال الرسالة الأولى. على سبيل المثال، اطّلِع على قائمة المساحات.
تتوافق مع أنواع المصادقة التالية:
مصادقة التطبيق باستخدام نطاق التفويض:
https://www.googleapis.com/auth/chat.bot
مصادقة المستخدم باستخدام أحد نطاقات التفويض التالية:
https://www.googleapis.com/auth/chat.spaces.readonly
https://www.googleapis.com/auth/chat.spaces
لعرض جميع المساحات المُسمّاة حسب مؤسسة Google Workspace، استخدِم طريقة spaces.search()
باستخدام امتيازات مشرف Workspace بدلاً من ذلك.
طلب 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
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.