VideoCategories: list

Возвращает список категорий, которые можно связать с видео на YouTube.

Влияние на квоту. Вызов этого метода расходует 1 единицу квоты.

Примеры использования

Запрос

HTTP-запрос

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

Параметры

В таблице ниже перечислены параметры, которые поддерживает этот запрос. Все перечисленные параметры являются параметрами запроса.

Параметры
Обязательные параметры
part string
Параметр part определяет свойства ресурса videoCategory, которые будут включены в ответ API. Установите для параметра значение snippet.
Фильтры (укажите ровно один из следующих параметров)
id string
Параметр id задает список идентификаторов категорий видео с разделителями-запятыми для ресурсов, которые вы получаете.
regionCode string
Параметр regionCode указывает API, что нужно вернуть список категорий видео, доступных в указанной стране. Значение параметра – это код страны в формате ISO 3166-1 alpha-2.
Необязательные параметры
hl string
Параметр hl определяет язык, который должен использоваться для текстовых значений в ответе API. Значение по умолчанию – en_US.

Тело запроса

При вызове этого метода не указывайте тело запроса.

Ответ

В случае успеха метод возвращает тело ответа со следующей структурой:

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

Свойства

В таблице ниже описаны свойства, которые появляются в этом ресурсе.

Свойства
kind string
Тип ресурса API. Значение будет youtube#videoCategoryListResponse.
etag etag
Тег Etag этого ресурса.
nextPageToken string
Токен, который можно использовать в качестве значения параметра pageToken, чтобы получить следующую страницу в наборе результатов.
prevPageToken string
Токен, который можно использовать в качестве значения параметра pageToken, чтобы получить предыдущую страницу в наборе результатов.
pageInfo object
Объект pageInfo содержит информацию о постраничной организации набора результатов.
pageInfo.totalResults integer
Общее количество результатов в наборе.
pageInfo.resultsPerPage integer
Количество результатов, включенных в ответ API.
items[] list
Список категорий, которые можно присваивать видео на YouTube. В этой карте идентификатор категории видео – это ключ карты, а его значение – соответствующий ресурс videoCategory.

Ошибки

В таблице ниже перечислены сообщения об ошибках, которые API может возвращать в ответ на вызов этого метода. Подробную информацию можно найти в документации по сообщениям об ошибках.

Тип ошибки Сведения об ошибке Описание
notFound (404) videoCategoryNotFound Не удалось найти категорию видео, указанную в параметре id. Чтобы получить список допустимых значений, используйте метод videoCategories.list.

Попробовать

Используйте APIs Explorer, чтобы вызвать этот API и посмотреть запрос к API и ответ.