REST Resource: users.sections

• المَرجع: القسم
  • تمثيل JSON
• SectionType
• الطُرق

المرجع: القسم

تمثّل هذه السمة قسمًا في Google Chat. تساعد الأقسام المستخدمين في تنظيم مساحاتهم. هناك نوعان من الأقسام:

1. أقسام النظام: هي أقسام محدّدة مسبقًا يديرها Google Chat. أسماء الموارد ثابتة، ولا يمكن إنشاؤها أو حذفها أو تعديل displayName. تشمل الأمثلة ما يلي:

   • users/{user}/sections/default-direct-messages
   • users/{user}/sections/default-spaces
   • users/{user}/sections/default-apps

2. الأقسام المخصّصة: هي أقسام ينشئها المستخدم ويديرها. يتطلّب إنشاء قسم مخصّص باستخدام sections.create displayName. يمكن تعديل الأقسام المخصّصة باستخدام sections.patch وحذفها باستخدام sections.delete.

   إصدار تجريبي للمطوّرين: يتوفّر كجزء من برنامج الإصدار التجريبي للمطوّرين في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة.

تمثيل JSON
{ "name": string, "displayName": string, "sortOrder": integer, "type": enum (SectionType) }

الحقول
name	string المعرّف اسم مورد القسم بالنسبة إلى أقسام النظام، يكون معرّف القسم عبارة عن سلسلة ثابتة: DEFAULT_DIRECT_MESSAGES: users/{user}/sections/default-direct-messages DEFAULT_SPACES: users/{user}/sections/default-spaces DEFAULT_APPS: users/{user}/sections/default-apps التنسيق: users/{user}/sections/{section}
displayName	string الحقل مطلوب. تمثّل هذه السمة الاسم المعروض للقسم. تتم تعبئة هذا الحقل لأقسام من النوع CUSTOM_SECTION فقط. يمكن أن يتضمّن ما يصل إلى 80 حرفًا. مطلوبة عند إنشاء CUSTOM_SECTION.
sortOrder	integer النتائج فقط. ترتيب القسم بالنسبة إلى الأقسام الأخرى تظهر الأقسام التي تتضمّن قيمة sortOrder أقل قبل الأقسام التي تتضمّن قيمة أعلى.
type	enum (SectionType) الحقل مطلوب. تمثّل هذه السمة نوع القسم.

SectionType

أنواع الأقسام

عمليات التعداد
SECTION_TYPE_UNSPECIFIED	نوع القسم غير محدَّد.
CUSTOM_SECTION	قسم مخصّص
DEFAULT_DIRECT_MESSAGES	القسم التلقائي الذي يحتوي على DIRECT_MESSAGE بين مستخدمَين بشريَين أو مساحات GROUP_CHAT التي لا تنتمي إلى أي قسم مخصّص
DEFAULT_SPACES	المساحات التلقائية التي لا تنتمي إلى أي قسم مخصّص
DEFAULT_APPS	القسم التلقائي الذي يحتوي على التطبيقات المثبَّتة لدى المستخدم

الطُرق
create	إصدار تجريبي للمطوّرين: يتوفّر كجزء من برنامج الإصدار التجريبي للمطوّرين في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. تُنشئ هذه الطريقة قسمًا في Google Chat.
delete	إصدار تجريبي للمطوّرين: يتوفّر كجزء من برنامج الإصدار التجريبي للمطوّرين في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. تحذف هذه الطريقة قسمًا من النوع CUSTOM_SECTION.
list	إصدار تجريبي للمطوّرين: يتوفّر كجزء من برنامج الإصدار التجريبي للمطوّرين في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. تعرض هذه السمة الأقسام المتاحة لمستخدم Chat.
patch	إصدار تجريبي للمطوّرين: يتوفّر كجزء من برنامج الإصدار التجريبي للمطوّرين في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. تعديل قسم
position	إصدار تجريبي للمطوّرين: يتوفّر كجزء من برنامج الإصدار التجريبي للمطوّرين في Google Workspace، الذي يتيح الوصول المبكر إلى ميزات معيّنة. تغيير نظام ترتيب قسم