Method: users.sections.list

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

يتطلّب مصادقة المستخدم باستخدام نطاق التفويض:

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly

طلب HTTP

GET https://chat.googleapis.com/v1/{parent=users/*}/sections

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

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

المعلمات
parent

string

الحقل مطلوب. العنصر الرئيسي، وهو اسم مورد المستخدم الذي يملك هذه المجموعة من الأقسام. يتيح هذا الخيار عرض أقسام القوائم للمستخدم الذي يجري المكالمة فقط. للإشارة إلى المستخدم الذي يجري المكالمة، اضبط أحد الخيارات التالية:

  • الاسم المستعار me مثلاً: users/me

  • عنوان بريدهم الإلكتروني في Workspace مثلاً: users/user@example.com

  • رقم تعريف المستخدم مثلاً: users/123456789

التنسيق: users/{user}

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

المعلمات
pageSize

integer

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

إذا لم يتم تحديد عدد، سيتم عرض 10 أقسام على الأكثر.

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

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

string

اختيارية: رمز مميّز للصفحة تم استلامه من طلب سابق لعرض أقسام القائمة قدِّم هذه السمة لاسترداد الصفحة التالية.

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

نص الطلب

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

نص الاستجابة

رسالة الرد لأقسام بيانات الفنادق

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

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

object (Section)

الأقسام من المستخدم المحدّد
nextPageToken

string

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

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

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly

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