Method: users.sections.list

Wyświetla sekcje dostępne dla użytkownika Chatu. Sekcje pomagają użytkownikom grupować rozmowy i dostosowywać listę pokoi wyświetlanych w panelu nawigacyjnym Google Chat. 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
  • https://www.googleapis.com/auth/chat.users.sections.readonly

Żądanie HTTP

GET https://chat.googleapis.com/v1/{parent=users/*}/sections

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Element nadrzędny, czyli nazwa zasobu użytkownika, do którego należy ta kolekcja sekcji. Obsługuje tylko sekcje list dla użytkownika, który wywołuje funkcję. Aby odwołać się do użytkownika wywołującego, ustaw jedną z tych wartości:

  • Alias me. Na przykład: users/me.

  • adres e-mail Workspace, Na przykład: users/user@example.com.

  • identyfikator użytkownika, Na przykład: users/123456789.

Format: users/{user}

Parametry zapytania

Parametry
pageSize

integer

Opcjonalnie: Maksymalna liczba sekcji do zwrócenia. Usługa może zwrócić mniej niż ta wartość.

Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 10 sekcji.

Maksymalna wartość to 100. Jeśli użyjesz wartości większej niż 100, zostanie ona automatycznie zmieniona na 100.

Wartości ujemne zwracają błąd INVALID_ARGUMENT.
pageToken

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania listy sekcji. Podaj ten token, aby pobrać kolejną stronę.

Podczas stronicowania wszystkie inne podane parametry powinny być zgodne z wywołaniem, które dostarczyło token strony. Przekazywanie różnych wartości do innych parametrów może prowadzić do nieoczekiwanych wyników.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Wiadomość z odpowiedzią dotyczącą sekcji informacji o produktach.

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

Zapis JSON 
{
  "sections": [
    {
      object (Section)
    }
  ],
  "nextPageToken": string
}
Pola
sections[]

object (Section)

sekcje określonego użytkownika;
nextPageToken

string

Token, który można wysłać jako pageToken, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w przewodniku po autoryzacji.