Method: users.sections.position

Zmienia kolejność sortowania sekcji. Szczegółowe informacje 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.