Cómo cambiar la posición de una sección

En esta guía, se explica cómo usar el método position en el recurso Section de la API de Google Chat para cambiar el orden de clasificación de una sección en Google Chat.

Para obtener más información, consulta Cómo crear y organizar secciones en Google Chat.

Requisitos previos

Python

Cómo cambiar la posición de una sección

Para cambiar la posición de una sección con autenticación del usuario, pasa lo siguiente en tu solicitud:

  • Especifica el alcance de autorización chat.users.sections.
  • Llama al método PositionSection.
  • En el cuerpo de la solicitud, especifica el name de la sección que se posicionará y la nueva posición:
    • Establece sortOrder en una posición absoluta (mayor que 0).
    • O BIEN establece relativePosition en START o END.

En el siguiente ejemplo, se mueve una sección al principio de la lista:

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)

Para ejecutar esta muestra, reemplaza lo siguiente:

  • SECTION_NAME: Es el nombre del recurso de la sección. Puedes obtener el nombre del recurso llamando al método ListSections.

La API de Chat devuelve la instancia actualizada de Section.