REST Resource: users.sections

แหล่งข้อมูล: ส่วน

แสดงส่วนใน Google Chat ส่วนต่างๆ จะช่วยให้ผู้ใช้จัดระเบียบพื้นที่ทำงานได้ โดยส่วนมี 2 ประเภท ได้แก่

  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

การแสดง 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

ประเภทของส่วน

Enum
SECTION_TYPE_UNSPECIFIED ประเภทส่วนที่ไม่ได้ระบุ
CUSTOM_SECTION ส่วนที่กำหนดเอง
DEFAULT_DIRECT_MESSAGES ส่วนเริ่มต้นที่มี DIRECT_MESSAGE ระหว่างผู้ใช้ที่เป็นบุคคล 2 รายหรือพื้นที่ GROUP_CHAT ที่ไม่ได้อยู่ในส่วนที่กำหนดเอง
DEFAULT_SPACES พื้นที่เริ่มต้นที่ไม่ได้อยู่ในส่วนที่กำหนดเอง
DEFAULT_APPS ส่วนเริ่มต้นที่มีแอปที่ผู้ใช้ติดตั้งไว้

เมธอด

create

สร้างส่วนใน Google Chat

delete

ลบส่วนประเภท CUSTOM_SECTION

list

แสดงรายการส่วนที่ผู้ใช้ Chat ใช้ได้

patch

อัปเดตส่วน

position

เปลี่ยนลำดับการจัดเรียงของส่วน