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 Google Chat API để 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 phần 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 phần bằng cách xác thực người dùng, hãy truyền các thông tin sau trong yêu cầu:

  • Chỉ định phạm vi uỷ quyền chat.users.sections.
  • Gọi phương thức PositionSection.
  • Trong 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 một 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 thông tin 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 ListSections phương thức.

Chat API trả về thực thể đã cập nhật của Section.