Method: users.sections.position

Zmienia kolejność sortowania sekcji. Więcej informacji znajdziesz w artykule Tworzenie i porządkowanie sekcji w Google Chat.

Wymaga uwierzytelnienia użytkownika z zakresem autoryzacji:

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

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagane. Nazwa zasobu sekcji do umieszczenia.

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

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{

  // Union field position can be only one of the following:
  "sortOrder": integer,
  "relativePosition": enum (Position)
  // End of list of possible types for union field position.
}
Pola
Pole zbiorcze position. Wymagane. Nowa pozycja sekcji. position może mieć tylko jedną z tych wartości:
sortOrder

integer

Opcjonalnie: Bezwzględna pozycja sekcji na liście sekcji. Pozycja musi być większa niż 0. Jeśli pozycja jest większa niż liczba sekcji, sekcja zostanie dodana na końcu listy. Ta operacja wstawia sekcję w danym miejscu i przesuwa pierwotną sekcję w tym miejscu oraz sekcje poniżej na następną pozycję.
relativePosition

enum (Position)

Opcjonalnie: Względna pozycja sekcji na liście sekcji.

Treść odpowiedzi

Wiadomość z odpowiedzią dotyczącą pozycjonowania sekcji.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "section": {
    object (Section)
  }
}
Pola
section

object (Section)

Zaktualizowana sekcja.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku po autoryzacji.

Pozycja

Pozycja sekcji.

Wartości w polu enum
POSITION_UNSPECIFIED Nieokreślona pozycja.
START Początek listy sekcji.
END Koniec listy sekcji.