Videos

Ресурс video представляет видео на YouTube.

Методы

API поддерживает следующие методы для ресурсов videos:

getRating
Возвращает оценки, которые авторизованный пользователь поставил видео из указанного списка. Перейти
list
Возвращает список видео, соответствующих параметрам запроса к API. Перейти
batchGetStats
Возвращает список статистических данных о видео, соответствующих параметрам запроса к API. Перейти
insert
Загружает видео на YouTube и при необходимости задает метаданные.
update
Обновляет метаданные видео. Перейти
delete
Удаляет видео на YouTube. Перейти
rate
Поставить лайк или дизлайк видео или удалить оценку. Перейти
reportAbuse
Пожаловаться на видео с недопустимым контентом. Перейти

Представление ресурса

Ниже приведена структура JSON для ресурса videos:

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "brandPartner": {
    "channelId": string,
    "channelHandle": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Свойства

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

Свойства
kind string
Определяет тип ресурса API. Значение будет youtube#video.
etag etag
Тег Etag этого ресурса.
id string
Идентификатор, который YouTube использует для уникальной идентификации видео.
snippet object
Объект snippet содержит основные сведения о видео, такие как название, описание и категория.
snippet.publishedAt datetime
Дата и время публикации видео. Это время может отличаться от времени загрузки видео. Например, если видео было загружено как личное, а затем стало общедоступным, в этом свойстве будет указано время, когда видео стало общедоступным.

Есть несколько особых случаев:
  • Если видео загружено с ограниченным доступом и метаданные видео получены владельцем канала, то значение свойства указывает дату и время загрузки видео.
  • Если видео загружено с доступом по ссылке, в значении свойства также указывается дата и время загрузки. В этом случае любой, кто знает уникальный идентификатор видео, может получить его метаданные.
  • Если видео загружено как видео для спонсоров, значение свойства указывает дату и время загрузки.
Значение указывается в формате ISO 8601.
snippet.channelId string
Идентификатор, который YouTube использует для уникальной идентификации канала, на который было загружено видео. Это значение может меняться со временем, например если видео переносится на другой канал (например, тематический канал или канал исполнителя).
snippet.title string
Название видео. Значение свойства может содержать до 100 символов UTF-8, кроме < и >. Значение этого свойства необходимо задать, если вы вызываете метод videos.update и обновляете часть snippet ресурса video.
snippet.description string
Описание видео. Максимальная длина значения свойства – 5000 байт. Оно может содержать любые допустимые символы UTF-8, кроме < и >.

Чтобы разбить видео на эпизоды, добавьте в описание временные метки в формате 00:00.
snippet.thumbnails object
Карта значков, связанных с видео. Для каждого объекта на карте ключ – это название значка, а значение – это объект, который содержит другую информацию о значке.
snippet.thumbnails.(key) object
Допустимые значения ключей:
  • default – уменьшенное изображение по умолчанию. Ширина стандартного значка видео или ресурса, который ссылается на видео (например, элемента плейлиста или результата поиска), составляет 120 пикселей, а высота – 90 пикселей. По умолчанию значок канала имеет размер 88 x 88 пикселей.
  • medium – версия значка с более высоким разрешением. Для видео (или ресурса, который ссылается на видео) ширина изображения составляет 320 пикселей, а высота – 180 пикселей. Для канала размер изображения составляет 240 x 240 пикселей.
  • high – версия значка в высоком разрешении. Для видео (или ресурса, который ссылается на видео) это изображение имеет ширину 480 пикселей и высоту 360 пикселей. Для канала это изображение размером 800 x 800 пикселей.
  • standard – версия значка с более высоким разрешением, чем high. Это изображение доступно для некоторых видео и других ресурсов, которые ссылаются на видео, например элементов плейлиста или результатов поиска. Ширина этого изображения – 640 пикселей, а высота – 480 пикселей.
  • maxres – версия значка в высоком разрешении. Такой размер доступен для некоторых видео и других ресурсов, связанных с видео, например элементов плейлистов или результатов поиска. Ширина изображения – 1280 пикселей, высота – 720 пикселей.
  • fhd – значок в формате Full HD (1080p). Этот размер доступен для некоторых видео. Размер изображения – 1920 x 1080 пикселей.
  • qhd – версия значка в разрешении Quad HD (1440p / 2K). Этот размер доступен для некоторых видео. Ширина этого изображения – 2560 пикселей, а высота – 1440 пикселей.
  • uhd – значок в сверхвысоком разрешении (4K). Этот размер доступен для некоторых видео. Ширина этого изображения – 3840 пикселей, а высота – 2160 пикселей.
snippet.thumbnails.(key).url string
URL изображения.
snippet.thumbnails.(key).width unsigned integer
Ширина изображения.
snippet.thumbnails.(key).height unsigned integer
Высота изображения.
snippet.channelTitle string
Название канала, на котором размещено видео.
snippet.tags[] list
Список тегов с ключевыми словами, связанными с видео. Теги могут содержать пробелы. Максимальная длина значения свойства – 500 символов. Обратите внимание на следующие правила расчета ограничения на количество символов:
  • Значение свойства представляет собой список, и запятые между элементами в списке учитываются в ограничении.
  • Если в теге есть пробел, сервер API обрабатывает значение тега так, как если бы оно было заключено в кавычки, и кавычки учитываются в ограничении на количество символов. Таким образом, для целей ограничения на количество символов тег Foo-Baz содержит семь символов, а тег Foo Baz – девять.
snippet.categoryId string
Категория видео на YouTube. Если вы вызываете метод videos.update и обновляете часть snippet ресурса video, то должны задать значение для этого свойства.
snippet.liveBroadcastContent string

Указывает, является ли видео предстоящей или текущей прямой трансляцией. Если видео не является предстоящей или текущей прямой трансляцией, значение этого свойства – none.



Допустимые значения этого свойства:
  • live
  • none
  • upcoming
snippet.defaultLanguage string
Язык текста в свойствах snippet.title и snippet.description ресурса video.
snippet.localized object
Объект snippet.localized содержит локализованное название и описание видео или название на языке по умолчанию для метаданных видео.
  • Локализованный текст возвращается во фрагменте ресурса, если в запросе videos.list использовался параметр hl, указывающий язык, на котором должен быть возвращен локализованный текст, и локализованный текст доступен на этом языке.
  • Если значение параметра hl не указано или указано, но локализованные метаданные для выбранного языка недоступны, возвращаются метаданные на языке по умолчанию.
Свойство содержит значение, доступное только для чтения. Чтобы добавить, изменить или удалить локализованные названия, используйте объект localizations.
snippet.localized.title string
Локализованное название видео.
snippet.localized.description string
Локализованное описание видео.
snippet.defaultAudioLanguage string
Свойство default_audio_language указывает язык, на котором говорят в звуковой дорожке видео по умолчанию.
contentDetails object
Объект contentDetails содержит информацию о видеоконтенте, включая продолжительность видео и указание на то, доступны ли для него субтитры.
contentDetails.duration string
Продолжительность видео. Значение свойства – это продолжительность в формате ISO 8601. Например, для видео продолжительностью от одной минуты до одного часа используется формат PT#M#S, где буквы PT указывают на то, что значение определяет период времени, а буквы M и S – на продолжительность в минутах и секундах соответственно. Символы #, предшествующие буквам M и S, являются целыми числами, которые указывают количество минут (или секунд) видео. Например, значение PT15M33S указывает на то, что продолжительность видео составляет 15 минут 33 секунды.

Если видео длится не менее часа, то его продолжительность указывается в формате PT#H#M#S, где # перед буквой H – это длительность видео в часах, а все остальные данные такие же, как описано выше. Если видео длится не менее одного дня, буквы P и T разделяются, а значение имеет формат P#DT#H#M#S. Подробную информацию вы найдете в спецификации ISO 8601.
contentDetails.dimension string
Указывает, доступно ли видео в 3D или 2D.
contentDetails.definition string
Указывает, доступно ли видео в HD (HD) или только в стандартном разрешении.

Допустимые значения:
  • hd
  • sd
contentDetails.caption string
Указывает, есть ли у видео субтитры.

Допустимые значения:
  • false
  • true
contentDetails.licensedContent boolean
Показывает, является ли видео лицензированным контентом. Это означает, что контент был загружен на канал, связанный с партнером YouTube по контенту, и на него были заявлены права.
contentDetails.regionRestriction object
Объект regionRestriction содержит информацию о странах, в которых видео доступно или недоступно. Объект будет содержать свойство contentDetails.regionRestriction.allowed или contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[] list
Список кодов регионов, в которых доступно видео. Если это свойство указано, но в его значении нет кода страны, то видео будет заблокировано в этой стране. Если свойство присутствует, но список пуст, видео заблокировано во всех странах.
contentDetails.regionRestriction.blocked[] list
Список кодов регионов, которые обозначают страны, где видео заблокировано. Если это свойство указано и страны нет в его значении, видео можно смотреть в этой стране. Если это свойство присутствует и содержит пустой список, видео можно смотреть во всех странах.
contentDetails.contentRating object
Указывает рейтинги, которые видео получило в соответствии с различными системами.
contentDetails.contentRating.acbRating string
Возрастное ограничение, установленное Австралийской аттестационной комиссией (ACB) или Австралийским управлением по связи и средствам массовой информации (ACMA). Рейтинги ACMA используются для классификации детских телепрограмм.

Допустимые значения этого свойства:
  • acbC – программы, которым Управление по связи и средствам массовой информации Австралии присвоило рейтинг C. Программы с рейтингом C предназначены для детей младшего и среднего школьного возраста (до 14 лет).
  • acbE – E
  • acbG – G
  • acbM – M
  • acbMa15plus – MA15+
  • acbP – программы, которым Управление по связи и средствам массовой информации Австралии присвоило рейтинг P. Для детей дошкольного возраста.
  • acbPg – PG
  • acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
Возрастное ограничение, установленное итальянским Управлением по гарантиям в сфере связи (AGCOM).

Допустимые значения:
  • agcomT – T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
Возрастное ограничение для видео, установленное Национальной ассоциацией телевидения Чили (Anatel).

Допустимые значения:
  • anatelA – A
  • anatelF – F
  • anatelI – I
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 – I-7
  • anatelR – R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
Возрастное ограничение, установленное Британским советом по классификации фильмов (BBFC).

Допустимые значения:
  • bbfc12 – 12
  • bbfc12a – 12A
  • bbfc15 – 15
  • bbfc18 – 18
  • bbfcPg – PG
  • bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
Рейтинг видео, присвоенный Советом по цензуре фильмов и видео Таиланда.

Допустимые значения:
  • bfvc13 – 13
  • bfvc15 – 15
  • bfvc18 – 18
  • bfvc20 – 20
  • bfvcB – Б
  • bfvcE – E
  • bfvcG – G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
Возрастное ограничение видео, установленное Австрийским советом по классификации медиаконтента (Bundesministerium für Unterricht, Kunst und Kultur).

Допустимые значения этого свойства:
  • bmukk10 – 10+
  • bmukk12 – 12+
  • bmukk14 – 14+
  • bmukk16 – 16+
  • bmukk6 – 6+
  • bmukk8 – от 8 лет
  • bmukkAa – без ограничений
  • bmukkUnrated
contentDetails.contentRating.catvRating string
Система возрастных ограничений для канадского телевидения – Canadian TV Classification System. Возрастное ограничение, присвоенное видео Канадской комиссией по радио, телевидению и телекоммуникациям (CRTC) для англоязычных трансляций в Канаде. Дополнительную информацию можно найти на сайте Канадского совета по стандартам телерадиовещания.

Допустимые значения этого свойства:
  • catv14plus – 14+
  • catv18plus – 18+
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
Рейтинг видео, присвоенный Канадской комиссией по радио, телевидению и телекоммуникациям (CRTC) для франкоязычных трансляций в Канаде. Дополнительную информацию можно найти на сайте Канадского совета по стандартам телерадиовещания.

Допустимые значения этого свойства:
  • catvfr13plus – 13+
  • catvfr16plus – 16+
  • catvfr18plus – 18+
  • catvfr8plus – 8+
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Рейтинг видео, присвоенный Центральным советом по сертификации фильмов (CBFC) в Индии.

Допустимые значения этого свойства:
  • cbfcA – A
  • cbfcS – S
  • cbfcU – U
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus – U/A
contentDetails.contentRating.cccRating string
Рейтинг видео, присвоенный Советом по кинематографической классификации (Чили).

Допустимые значения этого свойства:
  • ccc14 – 14+
  • ccc18 – 18+
  • ccc18s – 18+ - contenido pornográfico
  • ccc18v – 18+ - contenido excesivamente violento
  • ccc6 – 6+ – Inconveniente para menores de 7 años
  • cccTe – Todo espectador
  • cccUnrated
contentDetails.contentRating.cceRating string
Возрастное ограничение для видео, установленное Португальской комиссией по классификации зрелищных мероприятий (Comissão de Classificação de Espectáculos).

Допустимые значения:
  • cceM12 – 12
  • cceM14 – 14
  • cceM16 – 16
  • cceM18 – 18
  • cceM4 – 4
  • cceM6 – 6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
Возрастное ограничение для видео в Швейцарии.

Допустимые значения:
  • chfilm0 – 0
  • chfilm12 – 12
  • chfilm16 – 16
  • chfilm18 – 18
  • chfilm6 – 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
Возрастное ограничение для видео по канадской системе оценки домашнего видео (CHVRS).

Допустимые значения:
  • chvrs14a – 14A
  • chvrs18a – 18A
  • chvrsE – E
  • chvrsG – G
  • chvrsPg – PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
Рейтинг видео от Комиссии по контролю за фильмами (Бельгия).

Допустимые значения этого свойства:
  • cicfE – E
  • cicfKntEna – KNT/ENA
  • cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
Возрастное ограничение для видео, установленное Национальным советом по аудиовизуальным средствам Румынии (CNA).

Допустимые значения:
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18
  • cna18plus – 18+
  • cnaAp – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
Система возрастных ограничений во Франции – Комиссия по классификации фильмов

Допустимые значения для этого свойства:
  • cnc10 – 10
  • cnc12 – 12
  • cnc16 – 16
  • cnc18 – 18
  • cncE – E
  • cncT – T
  • cncUnrated
contentDetails.contentRating.csaRating string
Возрастное ограничение, установленное Высшим советом по телерадиовещанию Франции (Conseil supérieur de l'audiovisuel).

Допустимые значения:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 – 18
  • csaInterdiction – Interdiction
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
Возрастное ограничение для видео, установленное Комиссией по надзору за классификацией фильмов (CSCF) в Люксембурге.

Допустимые значения:
  • cscf12 – 12
  • cscf16 – 16
  • cscf18 – 18
  • cscf6 – 6
  • cscf9 – 9
  • cscfA – A
  • cscfAl – AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
Возрастное ограничение для видео в Чехии.

Допустимые значения:
  • czfilm12 – 12
  • czfilm14 – 14
  • czfilm18 – 18
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
Возрастное ограничение для видео, установленное бразильским Департаментом юстиции, классификации, квалификации и титулов (DJCQT).

Допустимые значения:
  • djctq10 – 10
  • djctq12 – 12
  • djctq14 – 14
  • djctq16 – 16
  • djctq18 – 18
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
Причины, по которым видео получило возрастное ограничение по системе DJCQT (Бразилия).
contentDetails.contentRating.ecbmctRating string
Система возрастных ограничений в Турции – Совет по оценке и классификации Министерства культуры и туризма

Допустимые значения для этого свойства:
  • ecbmct13a – 13A
  • ecbmct13plus – 13+
  • ecbmct15a – 15 A
  • ecbmct15plus – 15+
  • ecbmct18plus – 18+
  • ecbmct7a – 7A
  • ecbmct7plus – 7+
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – 6+
  • ecbmct10a – 10 А
  • ecbmct10plus – 10+
  • ecbmct16plus – 16+
contentDetails.contentRating.eefilmRating string
Возрастное ограничение для видео в Эстонии.

Допустимые значения:
  • eefilmK12 – K-12
  • eefilmK14 – K-14
  • eefilmK16 – K-16
  • eefilmK6 – K-6
  • eefilmL – L
  • eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere – Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
Возрастное ограничение для видео в Египте.

Допустимые значения этого свойства:
  • egfilm18 – 18
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
Возрастное ограничение для видео, установленное Японским комитетом по классификации фильмов (EIRIN). Eirin – это японская система возрастных ограничений.

Допустимые значения этого свойства:
  • eirinG – G
  • eirinPg12 – PG-12
  • eirinR15plus – R15+
  • eirinR18plus – R18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
Возрастное ограничение, установленное Советом по цензуре фильмов Малайзии.

Допустимые значения:
  • fcbm13 – 13
  • fcbm16 – 16
  • fcbm18 – 18
  • fcbm18pa – 18PA
  • fcbm18pl – 18PL
  • fcbm18sg – 18SG
  • fcbm18sx – 18SX
  • fcbmP12 – P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
Возрастное ограничение видео, установленное Управлением по делам кино, газет и статей Гонконга.

Допустимые значения этого свойства:
  • fcoI – I
  • fcoIi – II
  • fcoIia – IIA
  • fcoIib – IIB
  • fcoIii – III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
Это свойство не поддерживается со 2 ноября 2015 г. Используйте свойство contentDetails.contentRating.cncRating.

Возрастное ограничение для видео, установленное Национальным центром кинематографии и анимации (Министерство культуры Франции).

Допустимые значения:
  • fmoc10 – 10
  • fmoc12 – 12
  • fmoc16 – 16
  • fmoc18 – 18
  • fmocE – E
  • fmocU – U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
Возрастное ограничение видео, установленное Советом по кинематографии и публикациям ЮАР.

Допустимые значения этого свойства:
  • fpb10 – 10
  • fpb1012Pg – 10-12PG
  • fpb13 – 13
  • fpb16 – 16
  • fpb18 – 18
  • fpb79Pg – 7-9PG
  • fpbA – A
  • fpbPg – PG
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
Причины, по которым видео получило возрастное ограничение FPB (ЮАР).
contentDetails.contentRating.fskRating string
Возрастное ограничение для видео, установленное организацией Freiwillige Selbstkontrolle der Filmwirtschaft (FSK, Германия).

Допустимые значения:
  • fsk0 – FSK 0
  • fsk12 – FSK 12
  • fsk16 – FSK 16
  • fsk18 – FSK 18
  • fsk6 – FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
Возрастное ограничение для видео в Греции.

Допустимые значения:
  • grfilmE – E
  • grfilmK – K
  • grfilmK12 – K-12
  • grfilmK13 – K-13
  • grfilmK15 – K-15
  • grfilmK17 – K-17
  • grfilmK18 – K-18
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
Рейтинг видео, присвоенный Институтом кинематографии и аудиовизуальных искусств Испании (ICAA).

Допустимые значения:
  • icaa12 – 12
  • icaa13 – 13
  • icaa16 – 16
  • icaa18 – 18
  • icaa7 – 7
  • icaaApta – APTA
  • icaaUnrated
  • icaaX – X
contentDetails.contentRating.ifcoRating string
Возрастное ограничение, установленное Ирландским бюро классификации фильмов (IFCO). Дополнительную информацию можно найти на сайте IFCO.

Допустимые значения этого свойства:
  • ifco12 – 12
  • ifco12a – 12A
  • ifco15 – 15
  • ifco15a – 15A
  • ifco16 – 16
  • ifco18 – 18
  • ifcoG – G
  • ifcoPg – PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
Возрастное ограничение для видео в Израиле.

Допустимые значения:
  • ilfilm12 – 12
  • ilfilm16 – 16
  • ilfilm18 – 18
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
Возрастное ограничение для видео, установленное Национальным институтом кино и аудиовизуальных искусств Аргентины (INCAA).

Допустимые значения:
  • incaaAtp – ATP (Apta para todo publico)
  • incaaC – X (только для зрителей старше 18 лет, показ с ограничениями)
  • incaaSam13 – 13 (только для зрителей старше 13 лет)
  • incaaSam16 – 16 (Solo apta para mayores de 16 años)
  • incaaSam18 – 18 (только для зрителей старше 18 лет)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
Возрастное ограничение, установленное Кенийским советом по классификации фильмов.

Допустимые значения:
  • kfcb16plus – 16
  • kfcbG – GE
  • kfcbPg – PG
  • kfcbR – 18
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (Нидерланды).

Допустимые значения:
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • kijkwijzer16 – 16
  • kijkwijzer18 – 18
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
Возрастное ограничение, установленное Корейским советом по классификации медиаконтента (영상물등급위원회). Корейский медийный совет по цензуре (KMRB) присваивает видео возрастные ограничения в Южной Корее.

Допустимые значения этого свойства:
  • kmrb12plus – 12세 이상 관람가
  • kmrb15plus – 15세 이상 관람가
  • kmrbAll – 전체관람가
  • kmrbR – 청소년 관람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
Рейтинг видео, присвоенный индонезийской организацией Lembaga Sensor Film.

Допустимые значения:
  • lsf13 – 13
  • lsf17 – 17
  • lsf21 – 21
  • lsfA – A
  • lsfBo – BO
  • lsfD – D
  • lsfR – R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
Возрастное ограничение видео, установленное Советом по классификации фильмов Мальты.

Допустимые значения:
  • mccaa12 – 12
  • mccaa12a – 12A
  • mccaa14 – 14 – эта категория была удалена из новой структуры классификации, введенной в 2013 году.
  • mccaa15 – 15
  • mccaa16 – 16. Эта категория была удалена из новой классификации, введенной в 2013 году.
  • mccaa18 – 18
  • mccaaPg – PG
  • mccaaU – U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
Рейтинг видео от Совета по СМИ для детей и молодежи при Датском институте кино (Det Danske Filminstitut).

Допустимые значения этого свойства:
  • mccyp11 – 11
  • mccyp15 – 15
  • mccyp7 – 7
  • mccypA – A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
Система возрастных ограничений для видео во Вьетнаме – MCST

Допустимые значения этого свойства:
  • mcst0 – 0
  • mcst16plus – 16+
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – K
contentDetails.contentRating.mdaRating string
Возрастное ограничение, установленное Управлением по развитию средств массовой информации Сингапура (MDA) и, в частности, его Советом по цензуре фильмов (BFC).

Допустимые значения:
  • mdaG – G
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • mdaR21 – R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
Возрастное ограничение видео, установленное Норвежским управлением по делам СМИ (Medietilsynet).

Допустимые значения:
  • medietilsynet11 – 11
  • medietilsynet12 – 12
  • medietilsynet15 – 15
  • medietilsynet18 – 18
  • medietilsynet6 – 6
  • medietilsynet7 – 7
  • medietilsynet9 – 9
  • medietilsynetA – A
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
Возрастное ограничение, установленное Национальным аудиовизуальным институтом Финляндии (Kansallinen Audiovisuaalinen Instituutti).

Допустимые значения:
  • meku12 – 12
  • meku16 – 16
  • meku18 – 18
  • meku7 – 7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
Возрастное ограничение, установленное Министерством культурного наследия, культурной деятельности и туризма Италии.

Допустимые значения:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
Возрастное ограничение, установленное Министерством культуры Колумбии.

Допустимые значения:
  • moc12 – 12
  • moc15 – 15
  • moc18 – 18
  • moc7 – 7
  • mocBanned – заблокировано
  • mocE – E
  • mocT – T
  • mocUnrated
  • mocX – X
contentDetails.contentRating.moctwRating string
Возрастное ограничение, установленное Министерством культуры Тайваня (文化部).

Допустимые значения:
  • moctwG – G
  • moctwP – P
  • moctwPg – PG
  • moctwR – R
  • moctwR12 – R-12
  • moctwR15 – R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
Возрастное ограничение, установленное Американской ассоциацией кинокомпаний (MPAA).

Допустимые значения:
  • mpaaG – G
  • mpaaNc17 – NC-17
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
Возрастное ограничение, установленное Американской ассоциацией кинокомпаний для трейлеров и предварительных просмотров фильмов.

Допустимые значения этого свойства:
  • mpaatGb – GB (зеленая полоса – для зрителей всех возрастов)
  • mpaatRb – RB (Red Band – рекомендуется для зрителей от 17 лет)
contentDetails.contentRating.mtrcbRating string
Возрастное ограничение видео от Совета по классификации кинофильмов и телепрограмм (Филиппины).

Допустимые значения:
  • mtrcbG – G
  • mtrcbPg – PG
  • mtrcbR13 – R-13
  • mtrcbR16 – R-16
  • mtrcbR18 – R-18
  • mtrcbUnrated
  • mtrcbX – X
contentDetails.contentRating.nbcRating string
Возрастное ограничение видео, установленное Национальным бюро классификации Мальдивских островов.

Допустимые значения:
  • nbc12plus – 12+
  • nbc15plus – 15+
  • nbc18plus – 18+
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
Возрастное ограничение, установленное Национальным центром кинематографии Болгарии.

Допустимые значения:
  • nfrcA – A
  • nfrcB – Б
  • nfrcC – C
  • nfrcD – D
  • nfrcUnrated
  • nfrcX – X
contentDetails.contentRating.nfvcbRating string
Возрастное ограничение, установленное Национальным советом Нигерии по цензуре фильмов и видео.

Допустимые значения:
  • nfvcb12 – 12
  • nfvcb12a – 12A
  • nfvcb15 – 15
  • nfvcb18 – 18
  • nfvcbG – G
  • nfvcbPg – PG
  • nfvcbRe – RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
Возрастное ограничение, установленное Национальным киноцентром Латвии (Nacionãlais Kino centrs).

Допустимые значения:
  • nkclv12plus – 12+
  • nkclv18plus – 18+
  • nkclv7plus – 7+
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
Возрастное ограничение, установленное Бюро классификации фильмов и литературы (OFLC, Новая Зеландия).

Допустимые значения:
  • oflcG – G
  • oflcM – M
  • oflcPg – PG
  • oflcR13 – R13
  • oflcR15 – R15
  • oflcR16 – R16
  • oflcR18 – R18
  • oflcRp13 – RP13
  • oflcRp16 – RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
Возрастное ограничение для видео в Перу.

Допустимые значения этого свойства:
  • pefilm14 – 14
  • pefilm18 – 18
  • pefilmPg – PG
  • pefilmPt – PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
Возрастное ограничение для видео в Венесуэле.

Допустимые значения:
  • resorteviolenciaA – A
  • resorteviolenciaB – B
  • resorteviolenciaC – C
  • resorteviolenciaD – D
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
Возрастное ограничение для видео, установленное Генеральным управлением радио, телевидения и кинематографии Мексики.

Допустимые значения:
  • rtcA – A
  • rtcAa – AA
  • rtcB – B
  • rtcB15 – B15
  • rtcC – C
  • rtcD – D
  • rtcUnrated
contentDetails.contentRating.rteRating string
Возрастное ограничение, установленное ирландской телерадиокомпанией Raidió Teilifís Éireann.

Допустимые значения:
  • rteCh – CH
  • rteGa – GA
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
Рейтинг видео, присвоенный Министерством культуры Российской Федерации (МК РФ).

Допустимые значения этого свойства:
  • russia0 – 0+
  • russia12 – 12+
  • russia16 – 16+
  • russia18 – 18+
  • russia6 – 6+
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
Возрастное ограничение для видео в Словакии.

Допустимые значения:
  • skfilmG – G
  • skfilmP2 – P2
  • skfilmP5 – P5
  • skfilmP8 – P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
Возрастное ограничение видео в Исландии.

Допустимые значения этого свойства:
  • smais12 – 12
  • smais14 – 14
  • smais16 – 16
  • smais18 – 18
  • smais7 – 7
  • smaisL – L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
Рейтинг видео от Национального совета по СМИ Швеции.

Допустимые значения этого свойства:
  • smsa11 – 11
  • smsa15 – 15
  • smsa7 – 7
  • smsaA – для всех возрастов.
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
Возрастное ограничение видео по системе TV Parental Guidelines (TVPG).

Допустимые значения этого свойства:
  • tvpgG – TV-G
  • tvpgMa – TV-MA
  • tvpgPg – TV-PG
  • tvpgUnrated
  • tvpgY – TV-Y
  • tvpgY7 – TV-Y7
  • tvpgY7Fv – TV-Y7-FV
  • pg14 – TV-14
contentDetails.contentRating.ytRating string
Оценка, которую YouTube использует для определения контента с ограничениями по возрасту.

Допустимые значения для этого свойства:
  • ytAgeRestricted
contentDetails.projection string
Формат проекции видео.

Допустимые значения:
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
Показывает, добавил ли пользователь, загрузивший видео, свой значок. Это свойство видно только автору видео.
status object
Объект status содержит информацию о статусах загрузки, обработки и конфиденциальности видео.
status.uploadStatus string
Статус загруженного видео.

Допустимые значения этого свойства:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status.failureReason string
Это значение объясняет, почему не удалось загрузить видео. Это свойство присутствует, только если свойство uploadStatus указывает на то, что загрузка не удалась.

Допустимые значения этого свойства:
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
status.rejectionReason string
Это значение объясняет, почему YouTube отклонил загруженное видео. Это свойство присутствует, только если свойство uploadStatus указывает, что загрузка была отклонена.

Допустимые значения для этого свойства:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
Статус доступа к видео. Если в запросе videos.insert не указано значение этого свойства, то по умолчанию загруженному видео присваивается статус public. Для некоторых загрузок по умолчанию может быть выбрана лицензия "private" в зависимости от настроек аккаунта автора, как описано в Справочном центре YouTube. Видео, загруженные из непроверенных проектов API, не ограничены режимом просмотра "Личное".

Допустимые значения для этого свойства:
  • private
  • public
  • unlisted
status.publishAt datetime
Дата и время, когда видео будет опубликовано. Это свойство можно задать, только если для видео установлен ограниченный доступ. Значение указывается в формате ISO 8601. Обратите внимание на следующие особенности работы этого свойства:
  • Если вы задаете значение этого свойства при вызове метода videos.update, то также должны задать значение private для свойства status.privacyStatus, даже если доступ к видео уже ограничен.
  • Это свойство можно задать, только если видео имеет статус доступа private и никогда не публиковалось.
  • Если в запросе указано время в прошлом, видео будет опубликовано сразу. Таким образом, если вы укажете в свойстве status.publishAt дату и время в прошлом, то это будет равносильно изменению значения свойства privacyStatus с private на public.
status.license string
Лицензия на видео.

Допустимые значения:
  • creativeCommon
  • youtube
status.embeddable boolean
Это значение указывает, можно ли встроить видео на другой сайт.
status.publicStatsViewable boolean
Этот параметр указывает, доступны ли расширенные данные о видео на странице просмотра. По умолчанию статистика доступна для просмотра. Некоторые данные, например количество просмотров и оценки, будут видны, даже если для этого свойства задано значение false.
status.madeForKids boolean
Это значение указывает, предназначен ли ролик для детей, и содержит текущий статус видео. Например, статус может определяться на основе значения свойства selfDeclaredMadeForKids. Подробнее о том, как указать аудиторию канала, видео или трансляции, рассказывается в Справочном центре YouTube.
status.selfDeclaredMadeForKids boolean
В запросе videos.insert или videos.update это свойство позволяет владельцу канала указать, что видео предназначено для детей. В запросе videos.list значение свойства возвращается, только если владелец канала авторизовал запрос к API.
status.containsSyntheticMedia boolean
В запросе videos.insert или videos.update это свойство позволяет владельцу канала сообщить, что видео содержит реалистичный измененный или синтетический (И/С) контент. Подробнее о правилах YouTube в отношении контента, связанного с алкоголем и табаком…

Примеры контента для взрослых:
  • Показывает, как реальный человек говорит или делает что-то, чего на самом деле он не говорил и не делал.
  • Содержит измененные изображения реального места или события.
  • Реалистично изображает событие, которого на самом деле не было.
statistics object
Объект statistics содержит статистику о видео.
statistics.viewCount unsigned long

Количество просмотров конкретного видео.

С 24 августа 2026 года для всех форматов видео на канале (обычных видео, трансляций и Shorts) viewCount будет обновлен, чтобы учитывать просмотры с момента начала воспроизведения (включая автовоспроизведение, наведение указателя и нажатие для воспроизведения).
statistics.likeCount unsigned long
Количество пользователей, которым понравилось видео.
statistics.dislikeCount unsigned long
Примечание. С 13 декабря 2021 г. доступ к ресурсу statistics.dislikeCount ограничен. Это означает, что свойство включается в ответ API, только если запрос к API был аутентифицирован владельцем видео. Подробнее об истории изменений…

Количество пользователей, которым не понравилось видео.
statistics.favoriteCount unsigned long
Примечание. Это свойство больше не поддерживается. Поддержка прекращена 28 августа 2015 г. Теперь значение свойства всегда равно 0.
statistics.commentCount unsigned long
Количество комментариев к видео.
paidProductPlacementDetails object
Объект paidProductPlacementDetails содержит информацию о продакт-плейсменте в видео.
paidProductPlacementDetails.hasPaidProductPlacement boolean
Укажите true, если в контенте есть продакт-плейсмент. Значение по умолчанию – false.
player object
Объект player содержит информацию, необходимую для воспроизведения видео во встроенном проигрывателе.
player.embedHtml string
Тег <iframe>, который встраивает проигрыватель для воспроизведения видео.
  • Если в запросе к API на получение ресурса указано значение для параметров maxHeight и/или maxWidth, размер встроенного проигрывателя масштабируется в соответствии с требованиями maxHeight и/или maxWidth.
  • Если соотношение сторон видео неизвестно, встроенный проигрыватель по умолчанию использует формат 4:3.
player.embedHeight long
Высота встроенного проигрывателя, возвращаемая в свойстве player.embedHtml. Это свойство возвращается, только если в запросе указано значение для параметров maxHeight и/или maxWidth и известно соотношение сторон видео.
player.embedWidth long
Ширина встроенного проигрывателя, возвращаемая в свойстве player.embedHtml. Это свойство возвращается, только если в запросе указано значение для параметров maxHeight и/или maxWidth и известно соотношение сторон видео.
topicDetails object
Объект topicDetails содержит информацию о темах, связанных с видео.

Важно! Ознакомьтесь с определениями свойств topicDetails.relevantTopicIds[] и topicDetails.topicIds[], а также с историей изменений, чтобы узнать больше о предстоящих изменениях, связанных с идентификаторами тем.
topicDetails.topicIds[] list
Важно! Это свойство не поддерживается с 10 ноября 2016 г. API больше не возвращает значения для этого свойства, а все темы, связанные с видео, теперь возвращаются значением свойства topicDetails.relevantTopicIds[].
topicDetails.relevantTopicIds[] list
Список идентификаторов тем, связанных с видео.

Это свойство не поддерживается с 10 ноября 2016 года. Поддержка будет прекращена 10 ноября 2017 г.

Важно! В связи с прекращением поддержки Freebase и Freebase API с 27 февраля 2017 г. идентификаторы тем работают по-другому. В то время YouTube начал возвращать небольшой набор идентификаторов тем.
topicDetails.topicCategories[] list
Список URL страниц Википедии, на которых приведено общее описание контента видео.
recordingDetails object
Объект recordingDetails содержит информацию о месте, дате и адресе съемки видео.
recordingDetails.locationDescription string
Поддержка этого свойства прекращена 1 июня 2017 г. Подробную информацию вы найдете в сообщении о прекращении поддержки.

Текстовое описание места, где было снято видео.
recordingDetails.location object
Это свойство больше не поддерживается. Все дочерние свойства (latitude, longitude, altitude) больше не поддерживаются.

Информация о геолокации, связанная с видео. Значения дочерних свойств определяют местоположение, которое владелец видео хочет связать с видео. Его можно изменить, найти в общедоступных видео и показывать пользователям.
recordingDetails.location.latitude double
Поддержка этого свойства прекращена 1 июня 2017 г. Подробную информацию вы найдете в сообщении о прекращении поддержки.

Широта в градусах.
recordingDetails.location.longitude double
Поддержка этого свойства прекращена 1 июня 2017 г. Подробную информацию вы найдете в сообщении о прекращении поддержки.

Долгота в градусах.
recordingDetails.location.altitude double
Это свойство не поддерживается с 9 июля 2018 г. Подробнее о прекращении поддержки…

Высота над референц-эллипсоидом в метрах.
recordingDetails.recordingDate datetime
Дата и время записи видео. Значение указывается в формате ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).
fileDetails object
Объект fileDetails содержит информацию о видеофайле, загруженном на YouTube, в том числе о его разрешении, продолжительности, аудио- и видеокодеках, битрейтах потоков и т. д. Эти данные доступны только владельцу видео.

Объект fileDetails возвращается, только если свойство processingDetails.fileAvailability имеет значение available.
fileDetails.fileName string
Название загруженного файла. Это поле присутствует независимо от того, был ли загружен видеофайл или файл другого типа.
fileDetails.fileSize unsigned long
Размер загруженного файла в байтах. Это поле присутствует независимо от того, был ли загружен видеофайл или файл другого типа.
fileDetails.fileType string
Тип загруженного файла, определенный системой обработки видео YouTube. В настоящее время YouTube обрабатывает только видеофайлы, но это поле присутствует независимо от того, какой тип файла был загружен.

Допустимые значения этого свойства:
  • archive – файл является архивом, например ZIP-архивом.
  • audio – файл относится к известному типу аудиофайлов, например MP3.
  • document – файл является документом или текстовым файлом, например документом MS Word.
  • image – файл является графическим файлом, например в формате JPEG.
  • other – файл другого типа (не видео).
  • project – файл является проектом видео, например проектом Microsoft Windows Movie Maker, и не содержит видеоданных.
  • video – файл относится к известному типу видеофайлов, например MP4.
fileDetails.container string
Формат медиаконтейнера загруженного видеофайла.
fileDetails.videoStreams[] list
Список видеопотоков, содержащихся в загруженном видеофайле. Каждый элемент списка содержит подробные метаданные о видеопотоке.
fileDetails.videoStreams[].widthPixels unsigned integer
Ширина закодированного видеоконтента в пикселях. Соотношение сторон кодирования видео можно рассчитать как width_pixels / height_pixels.
fileDetails.videoStreams[].heightPixels unsigned integer
Высота закодированного видеоконтента в пикселях.
fileDetails.videoStreams[].frameRateFps double
Количество кадров в секунду видеопотока.
fileDetails.videoStreams[].aspectRatio double
Соотношение сторон видеоконтента, которое определяет, в каком соотношении сторон должно показываться видео.
fileDetails.videoStreams[].codec string
Видеокодек, используемый в трансляции.
fileDetails.videoStreams[].bitrateBps unsigned long
Битрейт видеопотока в битах в секунду.
fileDetails.videoStreams[].rotation string
Угол, на который YouTube нужно повернуть исходный контент, чтобы видео показывалось правильно.

Допустимые значения:
  • clockwise – видео нужно повернуть на 90 градусов по часовой стрелке.
  • counterClockwise – видео нужно повернуть на 90 градусов против часовой стрелки.
  • none – видео не нужно поворачивать.
  • other – видео нужно повернуть другим, нетривиальным способом.
  • upsideDown – видео нужно перевернуть.
fileDetails.videoStreams[].vendor string
Значение, которое уникальным образом идентифицирует поставщика видео. Обычно это четырехбуквенный код поставщика.
fileDetails.audioStreams[] list
Список аудиопотоков, содержащихся в загруженном видеофайле. Каждый элемент списка содержит подробные метаданные об аудиопотоке.
fileDetails.audioStreams[].channelCount unsigned integer
Количество аудиоканалов в потоке.
fileDetails.audioStreams[].codec string
Аудиокодек, используемый в потоке.
fileDetails.audioStreams[].bitrateBps unsigned long
Битрейт аудиопотока в битах в секунду.
fileDetails.audioStreams[].vendor string
Значение, которое уникальным образом идентифицирует поставщика видео. Обычно это четырехбуквенный код поставщика.
fileDetails.durationMs unsigned long
Продолжительность загруженного видео в миллисекундах.
fileDetails.bitrateBps unsigned long
Общий битрейт (видео и аудио) загруженного видеофайла в битах в секунду.
fileDetails.creationTime string
Дата и время создания загруженного видеофайла. Значение указывается в формате ISO 8601. В настоящее время поддерживаются следующие форматы ISO 8601:
  • Только дата: YYYY-MM-DD
  • Наивное время: YYYY-MM-DDTHH:MM:SS
  • Время с часовым поясом: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
Объект processingDetails содержит информацию о том, как YouTube обрабатывает загруженный видеофайл. Свойства объекта указывают текущий статус обработки и приблизительное время, оставшееся до ее завершения. В этом разделе также указано, доступны ли для видео разные типы данных или контента, например сведения о файле или значки.

Объект processingProgress предназначен для опроса, чтобы загруженное видео могло отслеживать прогресс обработки загруженного видеофайла на YouTube. Эти данные доступны только владельцу видео.
processingDetails.processingStatus string
Статус обработки видео. Это значение указывает, удалось ли YouTube обработать видео или оно все ещё обрабатывается.

Допустимые значения для этого свойства:
  • failed – не удалось обработать видео. См. ProcessingFailureReason.
  • processing – видео обрабатывается. См. ProcessingProgress.
  • succeeded – видео успешно обработано.
  • terminated – информация об обработке больше недоступна.
processingDetails.processingProgress object
Объект processingProgress содержит информацию о ходе обработки видео на YouTube. Эти значения имеют значение, только если статус обработки видео – processing.
processingDetails.processingProgress.partsTotal unsigned long
Приблизительное общее количество частей, которые нужно обработать для видео. По мере обработки видео на YouTube это число может меняться.
processingDetails.processingProgress.partsProcessed unsigned long
Количество частей видео, которые уже обработаны на YouTube. Вы можете рассчитать процент видео, который уже обработан YouTube, по следующей формуле:
100 * parts_processed / parts_total

Обратите внимание, что расчетный процент может периодически уменьшаться, поскольку расчетное количество частей может увеличиваться без соответствующего увеличения количества уже обработанных частей.
processingDetails.processingProgress.timeLeftMs unsigned long
Приблизительное время в миллисекундах, которое потребуется YouTube, чтобы завершить обработку видео.
processingDetails.processingFailureReason string
Причина, по которой YouTube не удалось обработать видео. Это свойство будет иметь значение, только если свойство processingStatus имеет значение failed.

Допустимые значения для этого свойства:
  • other – произошел сбой в работе другого компонента обработки.
  • streamingFailed – не удалось отправить видео стримерам.
  • transcodeFailed – не удалось перекодировать контент.
  • uploadFailed – не удалось доставить файл.
processingDetails.fileDetailsAvailability string
Это значение указывает, доступны ли сведения о файле для загруженного видео. Чтобы получить информацию о файле видео, добавьте в запрос videos.list() часть fileDetails.
processingDetails.processingIssuesAvailability string
Это значение указывает, сгенерировал ли механизм обработки видео предложения, которые могут улучшить способность YouTube обрабатывать видео, предупреждения, объясняющие проблемы с обработкой видео, или ошибки, вызывающие проблемы с обработкой видео. Чтобы получить эти рекомендации, добавьте в запрос videos.list() часть suggestions.
processingDetails.tagSuggestionsAvailability string
Это значение указывает, доступны ли для видео подсказки ключевых слов (тегов). Теги можно добавлять в метаданные видео, чтобы пользователям было проще его найти. Чтобы получить эти подсказки, запросите часть suggestions в запросе videos.list().
processingDetails.editorSuggestionsAvailability string
Это значение показывает, доступны ли для видео рекомендации по редактированию, которые могут улучшить качество видео или удобство воспроизведения. Чтобы получить эти рекомендации, добавьте в запрос videos.list() часть suggestions.
processingDetails.thumbnailsAvailability string
Это значение показывает, были ли созданы значки для видео.
suggestions object
Объект suggestions содержит рекомендации по улучшению качества видео или метаданных загруженного видео. Эти данные может получить только владелец видео.

Объект suggestions будет возвращен, только если свойство processingDetails.tagSuggestionsAvailability или processingDetails.editorSuggestionsAvailability имеет значение available.
suggestions.processingErrors[] list
Список ошибок, которые помешают YouTube обработать загруженное видео. Эти ошибки указывают на то, что независимо от текущего статуса обработки видео, в конечном итоге он почти наверняка будет failed.

Допустимые значения для этого свойства:
  • archiveFile – архивный файл (например, ZIP-архив).
  • audioFile – файл содержит только аудио (например, MP3).
  • docFile – документ или текстовый файл (например, документ MS Word).
  • imageFile – графический файл (например, изображение в формате JPEG).
  • notAVideoFile – другой файл, не являющийся видео.
  • projectFile – файл проекта фильма (например, проект Microsoft Windows Movie Maker).
suggestions.processingWarnings[] list
Список причин, по которым у YouTube могут возникнуть проблемы с перекодированием загруженного видео или которые могут привести к ошибке перекодирования. Эти предупреждения генерируются до того, как YouTube обработает загруженный видеофайл. Кроме того, они выявляют проблемы, которые не обязательно приведут к сбою обработки видео, но могут вызвать другие неполадки, например проблемы с синхронизацией, артефакты видео или отсутствие аудиодорожки.

Допустимые значения этого свойства:
  • hasEditlist – списки редактирования в настоящее время не поддерживаются.
  • inconsistentResolution – контейнер и поток имеют разные разрешения.
  • problematicAudioCodec – использован аудиокодек, который вызывает проблемы.
  • problematicVideoCodec – использовался видеокодек, который, как известно, вызывает проблемы.
  • unknownAudioCodec – неизвестный аудиокодек, перекодирование, скорее всего, не удастся.
  • unknownContainer – формат файла не распознан, перекодирование может не удаться.
  • unknownVideoCodec – неизвестный видеокодек, перекодирование, скорее всего, не удастся.
suggestions.processingHints[] list
Список рекомендаций, которые могут помочь YouTube обработать видео.

Допустимые значения этого свойства:
  • nonStreamableMov – файл MP4 не поддерживает потоковую передачу, что замедлит обработку.
  • sendBestQualityVideo – возможно, существует более качественная версия видео.
suggestions.tagSuggestions[] list
Список тегов, которые можно добавить в метаданные видео, чтобы пользователи могли найти его на YouTube.
suggestions.tagSuggestions[].tag string
Тег ключевого слова, предложенный для видео.
suggestions.tagSuggestions[].categoryRestricts[] list
Набор категорий видео, к которым относится тег. На основе этой информации вы можете предлагать пользователям, загружающим видео, подходящие теги. По умолчанию, если для ключевого слова не заданы ограничения, предлагаемые теги подходят для всех категорий.
suggestions.editorSuggestions[] list
Список операций по редактированию видео, которые могут улучшить качество видео или воспроизведения загруженного видео.

Допустимые значения для этого свойства:
  • audioQuietAudioSwap – в аудиодорожке нет звука, и ее можно заменить на более качественную.
  • videoAutoLevels – яркость изображения кажется неправильной и может быть скорректирована.
  • videoCrop – обнаруженные вокруг изображения поля могут быть обрезаны.
  • videoStabilize – видео дрожит, и его можно стабилизировать.
liveStreamingDetails object
Объект liveStreamingDetails содержит метаданные о прямой видеотрансляции. Объект будет присутствовать в ресурсе video, только если видео является предстоящей, текущей или завершенной прямой трансляцией.
liveStreamingDetails.actualStartTime datetime
Время начала трансляции. Значение указывается в формате ISO 8601. Это значение будет доступно только после начала трансляции.
liveStreamingDetails.actualEndTime datetime
Время, когда трансляция была завершена. Значение указывается в формате ISO 8601. Это значение будет доступно только после окончания трансляции.
liveStreamingDetails.scheduledStartTime datetime
Время начала трансляции. Значение указывается в формате ISO 8601.
liveStreamingDetails.scheduledEndTime datetime
Время, когда трансляция должна закончиться. Значение указывается в формате ISO 8601. Если значение пустое или свойство отсутствует, трансляция будет продолжаться бесконечно.
liveStreamingDetails.concurrentViewers unsigned long
Количество зрителей, которые смотрят трансляцию в данный момент. Свойство и его значение будут присутствовать, если у трансляции есть зрители и владелец трансляции не скрыл количество просмотров видео. Обратите внимание, что после завершения трансляции YouTube прекращает отслеживать количество одновременных зрителей. Таким образом, это свойство не позволяет определить количество зрителей, которые смотрят архивную запись уже завершившейся прямой трансляции.
Количество зрителей, которые смотрят видео одновременно, возвращаемое YouTube Data API, может отличаться от обработанного и очищенного от спама количества зрителей, доступного в YouTube Аналитике. Подробнее о показателях прямых трансляций можно узнать в Справочном центре YouTube.
liveStreamingDetails.activeLiveChatId string
Идентификатор активного чата, связанного с видео. Это поле заполняется, только если видео является текущей прямой трансляцией с чатом. После того как трансляция завершится, это поле будет удалено, а чат закрыт. В случае с постоянными трансляциями идентификатор чата будет привязан не к этому видео, а к новому, которое показывается на постоянной странице.
brandPartner object
Объект brandPartner содержит сведения о бренде-партнере, связанном с видео, для которого автор предоставил доступ бренду-партнеру (CI BPA).
brandPartner.channelId string
Внешний идентификатор канала партнера. Это поле должно начинаться с "UC". При настройке доступа необходимо указать channelId или channelHandle, но в ответе возвращается только channelId.
brandPartner.channelHandle string
Псевдоним канала бренда-партнера. Значение этого поля должно начинаться с символа @. При настройке доступа необходимо указать либо channelId, либо channelHandle, но в ответе возвращается только channelId.
localizations object
Объект localizations содержит переводы метаданных видео.
localizations.(key) object
Язык локализованного текста, связанного со значением ключа. Значение представляет собой строку, содержащую код языка BCP-47.
localizations.(key).title string
Локализованное название видео.
localizations.(key).description string
Локализованное описание видео.