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 از سینتکس Transcoding در 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 فیلد Union. الزامی. موقعیت جدید بخش. position می‌تواند فقط یکی از موارد زیر باشد:
sortOrder

integer

اختیاری. موقعیت مطلق بخش در لیست بخش‌ها. موقعیت باید بزرگتر از ۰ باشد. اگر موقعیت بزرگتر از تعداد بخش‌ها باشد، بخش به انتهای لیست اضافه می‌شود. این عملیات بخش را در موقعیت داده شده وارد می‌کند و بخش اصلی در آن موقعیت و بخش‌های زیر آن را به موقعیت بعدی منتقل می‌کند.

relativePosition

enum ( Position )

اختیاری. موقعیت نسبی بخش در لیست بخش‌ها.

بدنه پاسخ

پیام پاسخ برای تعیین موقعیت یک بخش.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "section": {
    object (Section)
  }
}
فیلدها
section

object ( Section )

بخش به‌روز شده.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.

موقعیت

موقعیت بخش.

انوم‌ها
POSITION_UNSPECIFIED موقعیت نامشخص.
START شروع فهرست بخش‌ها.
END پایان فهرست بخش‌ها.