Method: users.sections.position

تغيير نظام ترتيب قسم لمزيد من التفاصيل، راجِع المقالة كيفية إنشاء أقسام وتنظيمها في Google Chat.

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

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

طلب HTTP

POST https://chat.googleapis.com/v1/{name=users/*/sections/*}:position

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

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

المعلمات
name

string

الحقل مطلوب. تمثّل هذه السمة اسم مصدر القسم المطلوب تحديد موضعه.

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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{

  // Union field position can be only one of the following:
  "sortOrder": integer,
  "relativePosition": enum (Position)
  // End of list of possible types for union field position.
}
الحقول
حقل الدمج position الحقل مطلوب. تمثّل هذه السمة الموضع الجديد للقسم. يمكن أن تكون position إحدى القيم التالية فقط:
sortOrder

integer

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

enum (Position)

اختيارية: تمثّل هذه السمة الموضع النسبي للقسم في قائمة الأقسام.

نص الاستجابة

رسالة الردّ لتحديد موضع قسم

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

تمثيل JSON 
{
  "section": {
    object (Section)
  }
}
الحقول
section

object (Section)

القسم المعدَّل

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

يجب توفير نطاق OAuth التالي:

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

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

الموضع

تمثّل هذه السمة موضع القسم.

عمليات التعداد
POSITION_UNSPECIFIED موضع غير محدّد
START تمثّل هذه السمة بداية قائمة الأقسام.
END تمثّل هذه السمة نهاية قائمة الأقسام.