變更區塊位置

本指南說明如何使用 Google Chat API Section 資源的 position 方法，變更 Google Chat 中某個區段的排序順序。

詳情請參閱「在 Google Chat 中建立及整理區段」。

必要條件

Python

變更區塊位置

如要變更含有使用者驗證的區段位置，請在要求中傳遞下列內容：

  • 指定 chat.users.sections 授權範圍。
  • 呼叫 PositionSection 方法。
  • 在要求主體中，指定要放置的區段 name 和新位置：
    • 將 sortOrder 設為絕對位置 (大於 0)。
    • 或者，將 relativePosition 設為 START 或 END。

以下範例會將某個區段移至清單開頭：

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)

如要執行這個範例，請替換下列項目：

  • SECTION_NAME：區段的資源名稱。您可以呼叫 ListSections 方法來取得資源名稱。

Chat API 會傳回更新後的 Section 執行個體。