Method: users.sections.position

Thay đổi thứ tự sắp xếp của một phần. Để biết thông tin chi tiết, hãy xem bài viết Tạo và sắp xếp các mục trong Google Chat.

Yêu cầu xác thực người dùng bằng phạm vi uỷ quyền:

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

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
name

string

Bắt buộc. Tên tài nguyên của phần cần định vị.

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

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng 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.
}
Trường
Trường nhóm position. Bắt buộc. Vị trí mới của phần. position chỉ có thể là một trong những trạng thái sau:
sortOrder

integer

Không bắt buộc. Vị trí tuyệt đối của phần trong danh sách các phần. Vị trí phải lớn hơn 0. Nếu vị trí lớn hơn số lượng phần, phần đó sẽ được thêm vào cuối danh sách. Thao tác này sẽ chèn phần tại vị trí đã cho và chuyển phần ban đầu tại vị trí đó cũng như các phần bên dưới vị trí đó sang vị trí tiếp theo.
relativePosition

enum (Position)

Không bắt buộc. Vị trí tương đối của phần trong danh sách các phần.

Nội dung phản hồi

Thông báo phản hồi để định vị một phần.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "section": {
    object (Section)
  }
}
Trường
section

object (Section)

Phần được cập nhật.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.

Vị trí

Vị trí của mục.

Enum
POSITION_UNSPECIFIED Vị trí không xác định.
START Bắt đầu danh sách các phần.
END Đã đọc hết danh sách các phần.