Position eines Abschnitts ändern

In diesem Leitfaden wird erläutert, wie Sie mit der Methode position für die Ressource Section der Google Chat API die Sortierreihenfolge eines Bereichs in Google Chat ändern.

Weitere Informationen finden Sie unter Abschnitte in Google Chat erstellen und organisieren.

Vorbereitung

Python

Position eines Abschnitts ändern

Wenn Sie die Position eines Abschnitts mit Nutzerauthentifizierung ändern möchten, übergeben Sie Folgendes in Ihrer Anfrage:

  • Geben Sie den chat.users.sections-Autorisierungsbereich an.
  • Rufen Sie die Methode PositionSection auf.
  • Geben Sie im Anfragetext die name des zu positionierenden Abschnitts und die neue Position an:
    • Setzen Sie sortOrder auf eine absolute Position (größer als 0).
    • ODER legen Sie relativePosition auf START oder END fest.

Im folgenden Beispiel wird ein Abschnitt an den Anfang der Liste verschoben:

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)

Wenn Sie dieses Beispiel ausführen möchten, ersetzen Sie Folgendes:

  • SECTION_NAME: Der Ressourcenname des Abschnitts. Sie können den Ressourcennamen abrufen, indem Sie die Methode ListSections aufrufen.

Die Chat API gibt die aktualisierte Instanz von Section zurück.