VideoCategories: list

Zwraca listę kategorii, które można powiązać z filmami w YouTube.

Wpływ limitu: wywołanie tej metody ma limit limitu wynoszący 1 jednostkę.

Typowe przypadki użycia

Żądanie

Żądanie HTTP

GET https://www.googleapis.com/youtube/v3/videoCategories

Parametry

W poniższej tabeli podano parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametr part określa właściwości zasobu videoCategory, które będą uwzględniane w odpowiedzi interfejsu API. Ustaw wartość parametru na snippet.
Filtry (podaj jeden z tych parametrów)
id string
Parametr id określa oddzieloną przecinkami listę identyfikatorów kategorii filmów dla pobieranych zasobów.
regionCode string
Parametr regionCode nakazuje interfejsowi API zwracanie listy kategorii filmów dostępnych w danym kraju. Wartością tego parametru jest kod kraju w formacie ISO 3166-1 alfa-2.
Parametry opcjonalne
hl string
Parametr hl określa język, którego należy używać w wartościach tekstowych w odpowiedzi interfejsu API. Wartością domyślną jest en_US.

Treść żądania

Podczas wywoływania tej metody nie podawaj treści żądania.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź w następującym formacie:

{
  "kind": "youtube#videoCategoryListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    videoCategory resource
  ]
}

Usługi

Poniższa tabela określa właściwości, które pojawiają się w tym zasobie:

Usługi
kind string
Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#videoCategoryListResponse.
etag etag
Otagowanie tego zasobu.
nextPageToken string
Token, który może zostać użyty jako wartość parametru pageToken, by pobrać następną stronę z zestawu wyników.
prevPageToken string
Token, którego można użyć jako wartości parametru pageToken w celu pobrania poprzedniej strony z zestawu wyników.
pageInfo object
Obiekt pageInfo zawiera informacje o stronicowaniu dla zestawu wyników.
pageInfo.totalResults integer
Łączna liczba wyników w zestawie wyników.
pageInfo.resultsPerPage integer
Liczba wyników zawartych w odpowiedzi interfejsu API.
items[] list
Lista kategorii filmów, które można powiązać z filmami w YouTube. Na tej mapie identyfikator kategorii filmów to klucz, a jego wartość to odpowiedni zasób videoCategory.

Błędy

W tabeli poniżej znajdziesz komunikaty o błędach, które interfejs API może zwrócić w odpowiedzi na wywołanie tej metody. Więcej informacji znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
notFound (404) videoCategoryNotFound Nie można znaleźć kategorii filmu wskazywanej przez parametr id. Aby pobrać listę prawidłowych wartości, użyj metody videoCategory.list.

Wypróbuj

Użyj APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.