VideoCategories: list

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

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

Typowe przypadki użycia

Prośba

Żą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ędzie zawierać odpowiedź interfejsu API. Ustaw wartość parametru na snippet.
Filtry (określ dokładnie jeden z tych parametrów)
id string
Parametr id zawiera rozdzieloną przecinkami listę identyfikatorów kategorii filmów dla pobieranych zasobów.
regionCode string
Parametr regionCode powoduje, że interfejs API zwraca listę kategorii filmów dostępnych w danym kraju. Jego wartością jest kod kraju zgodny ze standardem ISO 3166-1 alfa-2.
Parametry opcjonalne
hl string
Parametr hl określa język, który powinien być używany na potrzeby wartości tekstowych w odpowiedzi interfejsu API. Wartością domyślną jest en_US.

Treść żądania

Nie podawaj treści żądania podczas wywoływania tej metody.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź o następującej strukturze:

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

Właściwości

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

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartością będzie youtube#videoCategoryListResponse.
etag etag
ETag tego zasobu.
nextPageToken string
Token, który może być używany jako wartość parametru pageToken w celu pobrania następnej strony w zestawie wyników.
prevPageToken string
Token, który może być używany jako wartość parametru pageToken do pobierania poprzedniej strony w zestawie wyników.
pageInfo object
Obiekt pageInfo zawiera informacje o stronicowaniu zbioru wyników.
pageInfo.totalResults integer
Łączna liczba wyników w zestawie.
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 w YouTube. Na tej mapie identyfikator kategorii filmu jest kluczem mapy, a jego wartością jest odpowiadający jej 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 szczegółów znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
notFound (404) videoCategoryNotFound Nie udało się znaleźć kategorii filmu określonej przez parametr id. Aby pobrać listę prawidłowych wartości, użyj metody videoCategories.list.

Wypróbuj

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