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, którą chcesz umieścić.

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

Treść żądania

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

Zapis JSON 
{

  "sortOrder": integer,
  "relativePosition": enum (Position)
}
Pola
Wymagane. Nowa pozycja sekcji. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
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 dołączona 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.
Koniec pól wykluczających się nawzajem.

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)

zaktualizowaną sekcję;

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.