Method: users.sections.position

Ändert die Sortierreihenfolge eines Abschnitts. Weitere Informationen finden Sie unter Bereiche in Google Chat erstellen und organisieren.

Erfordert Nutzerauthentifizierung mit dem Autorisierungsbereich:

  • https://www.googleapis.com/auth/chat.users.sections

HTTP-Anfrage

POST https://chat.googleapis.com/v1/{name=users/*/sections/*}:position

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Ressourcenname des zu positionierenden Abschnitts.

Format: users/{user}/sections/{section}

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{

  "sortOrder": integer,
  "relativePosition": enum (Position)
}
Felder
Erforderlich. Die neue Position des Abschnitts. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
sortOrder

integer

Optional. Die absolute Position des Bereichs in der Liste der Bereiche. Die Position muss größer als 0 sein. Wenn die Position größer als die Anzahl der Abschnitte ist, wird der Abschnitt an das Ende der Liste angehängt. Bei diesem Vorgang wird der Abschnitt an der angegebenen Position eingefügt und der ursprüngliche Abschnitt an dieser Position sowie die darunter liegenden Abschnitte werden an die nächste Position verschoben.
relativePosition

enum (Position)

Optional. Die relative Position des Abschnitts in der Liste der Abschnitte.
Ende der sich gegenseitig ausschließenden Felder.

Antworttext

Antwortnachricht für die Positionierung eines Abschnitts.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "section": {
    object (Section)
  }
}
Felder
section

object (Section)

Der aktualisierte Abschnitt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/chat.users.sections

Weitere Informationen finden Sie im Autorisierungsleitfaden.

Position

Die Position des Abschnitts.

Enums
POSITION_UNSPECIFIED Nicht angegebene Position.
START Beginn der Liste der Abschnitte.
END Ende der Liste der Abschnitte.