VideoCategories: list

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

Wpływ na limit: wywołanie tej metody wiąże się z kosztem limitu wynoszącym 1 jednostkę.

Częste zastosowania

Żądanie

Żądanie HTTP

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

Parametry

W tabeli poniżej znajdziesz 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ędnione w odpowiedzi interfejsu API. Ustaw wartość parametru na snippet.
Filtry (określ dokładnie 1 z tych parametrów)
id string
Parametr id określa rozdzieloną przecinkami listę identyfikatorów kategorii filmów, które chcesz pobrać.
regionCode string
Parametr regionCode instruuje interfejs API, aby zwrócił listę kategorii filmów dostępnych w określonym kraju. Wartość parametru to 2-znakowy kod kraju ISO 3166-1 alpha-2.
Parametry opcjonalne
hl string
Parametr hl określa język, który ma być używany w przypadku wartości tekstowych w odpowiedzi interfejsu API. Wartość domyślna to en_US.

Treść żądania

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

Odpowiedź

Jeśli operacja się uda, ta metoda zwróci treść odpowiedzi o tej strukturze:

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

Właściwości

W tabeli poniżej znajdziesz właściwości, które pojawiają się w tym zasobie:

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartość to youtube#videoCategoryListResponse.
etag etag
Etag tego zasobu.
nextPageToken string
Token, którego można użyć jako wartości parametru pageToken, aby pobrać następną stronę w zbiorze wyników.
prevPageToken string
Token, którego można użyć jako wartości parametru pageToken, aby pobrać poprzednią stronę w zbiorze wyników.
pageInfo object
Obiekt pageInfo zawiera informacje o stronicowaniu zbioru wyników.
pageInfo.totalResults integer
Łączna liczba wyników w zbiorze wyników.
pageInfo.resultsPerPage integer
Liczba wyników uwzględnionych w odpowiedzi interfejsu API.
items[] list
Lista kategorii filmów, które można powiązać z filmami na YouTube. W tej mapie identyfikator kategorii filmu jest kluczem mapy, 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 określonej przez parametr id. Aby pobrać listę prawidłowych wartości, użyj metody videoCategories.list.

Wypróbuj

Aby wywołać ten interfejs API i zobaczyć żądanie do interfejsu API oraz odpowiedź, użyj APIs Explorer.