Method: users.sections.items.list

Wyświetla listę elementów w sekcji.

Obecnie elementami sekcji mogą być tylko pokoje. 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/*}/items

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Element nadrzędny, czyli nazwa zasobu sekcji, do której należy ta kolekcja elementów sekcji. Obsługuje tylko elementy sekcji listy dla użytkownika wywołującego.

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

Parametry zapytania

Parametry
pageSize

integer

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

Jeśli nie zostanie określona, zwracanych będzie maksymalnie 10 elementów 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 elementów 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.
filter

string

Opcjonalnie: filtr zapytania,

Obecnie obsługuje tylko filtrowanie według przestrzeni.

Na przykład: space = spaces/{space}.

Nieprawidłowe zapytania są odrzucane z błędem INVALID_ARGUMENT.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Wiadomość z odpowiedzią dotyczącą elementów sekcji informacji.

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

Zapis JSON 
{
  "sectionItems": [
    {
      object (SectionItem)
    }
  ],
  "nextPageToken": string
}
Pola
sectionItems[]

object (SectionItem)

Elementy sekcji z określonej sekcji.
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.