Thay đổi vị trí của một phần

Hướng dẫn này giải thích cách sử dụng phương thức position trên tài nguyên Section của API Google Chat để thay đổi thứ tự sắp xếp của một phần trong Google Chat.

Để biết thêm thông tin, hãy xem bài viết Tạo và sắp xếp các mục trong Google Chat.

Điều kiện tiên quyết

Python

Thay đổi vị trí của một phần

Để thay đổi vị trí của một mục có xác thực người dùng, hãy truyền các thông tin sau trong yêu cầu của bạn:

  • Chỉ định phạm vi uỷ quyền chat.users.sections.
  • Gọi phương thức PositionSection.
  • Trong phần nội dung yêu cầu, hãy chỉ định name của phần cần định vị và vị trí mới:
    • Đặt sortOrder thành vị trí tuyệt đối (lớn hơn 0).
    • HOẶC đặt relativePosition thành START hoặc END.

Ví dụ sau đây di chuyển một phần đến đầu danh sách:

Python

from google.cloud import chat_v1

def position_section():
    # Create a client
    client = chat_v1.ChatServiceClient()

    # Initialize request
    request = chat_v1.PositionSectionRequest(
        name="SECTION_NAME",
        relative_position=chat_v1.PositionSectionRequest.Position.START
    )

    # Make the request
    response = client.position_section(request=request)

    print(response)

Để chạy mẫu này, hãy thay thế các giá trị sau:

  • SECTION_NAME: Tên tài nguyên của phần. Bạn có thể lấy tên tài nguyên bằng cách gọi phương thức ListSections.

API Chat trả về phiên bản đã cập nhật của Section.