REST Resource: users.sections

Tài nguyên: Phần

Đại diện cho một phần trong Google Chat. Các phần giúp người dùng sắp xếp không gian của họ. Có hai loại phần:

  1. Phần hệ thống: Đây là những phần được xác định trước do Google Chat quản lý. Tên tài nguyên của các chỉ số này là cố định và bạn không thể tạo, xoá hoặc sửa đổi displayName. Ví dụ:

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

  2. Phần tuỳ chỉnh: Đây là những phần do người dùng tạo và quản lý. Để tạo một phần tuỳ chỉnh bằng sections.create , bạn cần có displayName. Bạn có thể cập nhật các phần tuỳ chỉnh bằng cách dùng sections.patch và xoá bằng cách dùng sections.delete.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "displayName": string,
  "sortOrder": integer,
  "type": enum (SectionType)
}
Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của mục.

Đối với các phần hệ thống, mã nhận dạng phần là một chuỗi hằng:

  • DEFAULT_DIRECT_MESSAGES: users/{user}/sections/default-direct-messages
  • DEFAULT_SPACES: users/{user}/sections/default-spaces
  • DEFAULT_APPS: users/{user}/sections/default-apps

Định dạng users/{user}/sections/{section}
displayName

string

Bắt buộc. Tên hiển thị của mục. Chỉ được điền sẵn cho các phần thuộc loại CUSTOM_SECTION. Hỗ trợ tối đa 80 ký tự. Bắt buộc khi tạo CUSTOM_SECTION.
sortOrder

integer

Chỉ có đầu ra. Thứ tự của phần này so với các phần khác. Các phần có giá trị sortOrder thấp hơn sẽ xuất hiện trước các phần có giá trị cao hơn.
type

enum (SectionType)

Bắt buộc. Loại phần.

SectionType

Các loại phần.

Enum
SECTION_TYPE_UNSPECIFIED Loại phần chưa được chỉ định.
CUSTOM_SECTION Mục tuỳ chỉnh.
DEFAULT_DIRECT_MESSAGES Phần mặc định chứa DIRECT_MESSAGE giữa hai người dùng là con người hoặc các phòng GROUP_CHAT không thuộc bất kỳ phần tuỳ chỉnh nào.
DEFAULT_SPACES Các không gian mặc định không thuộc bất kỳ phần tuỳ chỉnh nào.
DEFAULT_APPS Phần mặc định chứa các ứng dụng đã cài đặt của người dùng.

Phương thức

create

 Tạo một phần nội dung trong Google Chat.

delete

 Xoá một phần thuộc loại CUSTOM_SECTION.

list

 Liệt kê các mục mà người dùng Chat có thể truy cập.

patch

 Cập nhật một phần.

position

 Thay đổi thứ tự sắp xếp của một phần.