Эта страница переведена с помощью Cloud Translation API.

Videos

Все видео, загруженные через конечную точку videos.insert из непроверенных проектов API, созданных после 28 июля 2020 года, будут доступны только в режиме приватного просмотра. Для снятия этого ограничения каждый проект API должен пройти аудит на соответствие Условиям предоставления услуг . Более подробную информацию см. в истории изменений API .

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
  },
  "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, кроме < и > .

snippet. thumbnails object
Карта миниатюр изображений, связанных с видео. Для каждого объекта на карте ключом является название миниатюры, а значением — объект, содержащий другую информацию о миниатюре.

snippet.thumbnails. (key)

object
Допустимые значения ключей:

default — изображение-миниатюра по умолчанию. Миниатюра по умолчанию для видео — или ресурса, ссылающегося на видео, например, элемента плейлиста или результата поиска — имеет ширину 120 пикселей и высоту 90 пикселей. Миниатюра по умолчанию для канала имеет ширину 88 пикселей и высоту 88 пикселей.
medium – версия миниатюрного изображения с более высоким разрешением. Для видео (или ресурса, ссылающегося на видео) это изображение имеет ширину 320 пикселей и высоту 180 пикселей. Для канала это изображение имеет ширину 240 пикселей и высоту 240 пикселей.
high – версия миниатюрного изображения с высоким разрешением. Для видео (или ресурса, ссылающегося на видео) это изображение имеет ширину 480 пикселей и высоту 360 пикселей. Для канала это изображение имеет ширину 800 пикселей и высоту 800 пикселей.
standard – версия миниатюры с ещё более высоким разрешением, чем изображение high разрешения. Это изображение доступно для некоторых видеороликов и других ресурсов, содержащих ссылки на видео, например, для элементов плейлистов или результатов поиска. Ширина этого изображения составляет 640 пикселей, а высота – 480 пикселей.
maxres – Максимально высокое разрешение миниатюрного изображения. Этот размер изображения доступен для некоторых видеороликов и других ресурсов, содержащих ссылки на видео, например, для элементов плейлистов или результатов поиска. Ширина этого изображения составляет 1280 пикселей, а высота — 720 пикселей.

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
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 от Австралийского управления связи и СМИ. Эти программы предназначены для детей (кроме детей дошкольного возраста) младше 14 лет.
acbE – E
acbG – G
acbM – M
acbMa15plus – MA15+
acbP – Программы, получившие классификацию P от Австралийского управления связи и СМИ. Эти программы предназначены для детей дошкольного возраста.
acbPg – PG
acbR18plus – R18+
acbUnrated

contentDetails.contentRating. agcomRating

string
Рейтинг видео предоставлен итальянским агентством Autorità per le Garanzie nelle Comunicazioni (AGCOM).

Допустимые значения для этого свойства:

agcomT – T
agcomUnrated
agcomVm14 – VM14
agcomVm18 – VM18

contentDetails.contentRating. anatelRating

string
Рейтинг видео Anatel (Asociación Nacional de Televisión) для чилийского телевидения.

Допустимые значения для этого свойства:

anatelA – А
anatelF – Ф
anatelI – I
anatelI10 – I-10
anatelI12 – I-12
anatelI7 – I-7
anatelR – Р
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 – B
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
Система рейтингов для канадского телевидения - Канадская система классификации телепрограмм. Рейтинг видео от Канадской комиссии по радиовещанию и телекоммуникациям (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
Рейтинг видео Consejo de Calificación Cinematográfica (Чили).

Допустимые значения для этого свойства:

ccc14 – 14+
ccc18 – 18+
ccc18s – 18+ - порнографическое содержание
ccc18v – 18+ - чрезмерное насилие
ccc6 – 6+ – Неудобно для периода от 7 лет
cccTe – Todo espectador
cccUnrated

contentDetails.contentRating. cceRating

string
Рейтинг видео предоставлен Комиссией по классификации Португалии.

Допустимые значения для этого свойства:

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 – Е
cicfKntEna – KNT/ENA
cicfKtEa – KT/EA
cicfUnrated

contentDetails.contentRating. cnaRating

string
Рейтинг видео предоставлен румынским CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA).

Допустимые значения для этого свойства:

cna12 – 12
cna15 – 15
cna18 – 18
cna18plus – 18+
cnaAp – AP
cnaUnrated

contentDetails.contentRating. cncRating

string
Система рейтингов во Франции - Commission de classification cinematographique

Допустимые значения для этого свойства:

cnc10 – 10
cnc12 – 12
cnc16 – 16
cnc18 – 18
cncE – E
cncT – T
cncUnrated

contentDetails.contentRating. csaRating

string
Рейтинг видео предоставлен Французским Высшим советом аудиовизуальных средств, который оценивает вещательный контент.

Допустимые значения для этого свойства:

csa10 – 10
csa12 – 12
csa16 – 16
csa18 – 18
csaInterdiction – Запрет
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 – 15A
ecbmct15plus – 15+
ecbmct18plus – 18+
ecbmct7a – 7A
ecbmct7plus – 7+
ecbmctG – G
ecbmctUnrated
ecbmct6a – 6A
ecbmct6plus – 6+
ecbmct10a – 10A
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
Рейтинг видео по системе Эйрин (映倫). Эйрин — это японская система рейтингов.

Допустимые значения для этого свойства:

eirinG – Г
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 лет)
incaaSam16 (только для майоров от 16 лет)
incaaSam18 (только для майоров от 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 – А
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 (Красная полоса – рекомендуется для лиц старше 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 – B
nfrcC – С
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
Рейтинг видео от Национального киноцентра Латвии.

Допустимые значения для этого свойства:

nkclv12plus – 12+
nkclv18plus – 18+
nkclv7plus – 7+
nkclvU – У
nkclvUnrated

contentDetails.contentRating. oflcRating

string
Рейтинг видео, присвоенный Управлением по классификации фильмов и литературы Новой Зеландии (OFLC).

Допустимые значения для этого свойства:

oflcG – G
oflcM – М
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 – Г
skfilmP2 – П2
skfilmP5 – П5
skfilmP8 – П8
skfilmUnrated

contentDetails.contentRating. smaisRating

string
Рейтинг видео в Исландии.

Допустимые значения для этого свойства:

smais12 – 12
smais14 – 14
smais16 – 16
smais18 – 18
smais7 – 7
smaisL – L
smaisUnrated

contentDetails.contentRating. smsaRating

string
Рейтинг видео от Statens medieråd (Национальный совет СМИ Швеции).

Допустимые значения для этого свойства:

smsa11 – 11
smsa15 – 15
smsa7 – 7
smsaA – Для всех возрастов
smsaUnrated

contentDetails.contentRating. tvpgRating

string
Видеоролик имеет рейтинг TV Parentlines (TVPG).

Допустимые значения для этого свойства:

tvpgG – TV-G
tvpgMa – TV-MA
tvpgPg – TV-PG
tvpgUnrated
tvpgY – TV-Y
tvpgY7 – TV-Y7
tvpgY7Fv – TV-Y7-FV
pg14 – ТВ-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
Статус конфиденциальности видео.

Допустимые значения для этого свойства:

private
public
unlisted

status. publishAt

datetime
Дата и время запланированной публикации видео. Указывается только в том случае, если статус конфиденциальности видео — «приватный». Значение указывается в формате ISO 8601. Обратите внимание на два дополнительных момента, касающихся поведения этого свойства:

Если вы задаете значение этого свойства при вызове метода videos.update , вам также необходимо установить значение свойства status.privacyStatus в значение private , даже если видео уже является приватным.
Этот параметр можно установить только в том случае, если статус конфиденциальности видео — 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 это свойство позволяет владельцу канала сообщить, что видео содержит реалистичный измененный или синтетический ( A/S ) контент. Подробнее о политике YouTube в отношении A/S контента можно узнать здесь.

Примерами контента A/S являются видеоролики, которые:

Создайте впечатление, что реальный человек говорит или делает то, чего на самом деле не говорил и не делал.
Изменять видеоматериалы реального события или места.
Создайте реалистично выглядящую сцену, которая на самом деле не происходила.

statistics object
Объект statistics содержит статистические данные о видео.

statistics. viewCount

unsigned long

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

Начиная с 31 марта 2025 года, для коротких видеороликов (Shorts) viewCount будет возвращать количество запусков или повторных воспроизведений короткого ролика, без требований к минимальному времени просмотра.

statistics. likeCount unsigned long
Количество пользователей, которые отметили, что им понравилось видео.

statistics. dislikeCount

unsigned long

Примечание: Свойство statistics.dislikeCount стало приватным с 13 декабря 2021 года. Это означает, что оно включается в ответ 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 начал возвращать небольшой набор тщательно отобранных идентификаторов тем.

См. поддерживаемые идентификаторы тем по состоянию на 15 февраля 2017 г.

Темы
Музыкальные темы
/m/04rlf	Музыка (родительская тема)
/m/02mscn	христианская музыка
/m/0ggq0m	Классическая музыка
/m/01lyv	Страна
/m/02lkt	Электронная музыка
/m/0glt670	Хип-хоп музыка
/m/05rwpb	Независимая музыка
/m/03_d0	Джаз
/m/028sqc	Музыка Азии
/m/0g293	Музыка Латинской Америки
/m/064t9	Поп-музыка
/m/06cqb	Регги
/m/06j6l	Ритм-энд-блюз
/m/06by7	Рок-музыка
/m/0gywn	Соул-музыка
Темы игр
/m/0bzvm2	Игры (родительская тема)
/m/025zzc	Экшен-игра
/m/02ntfj	Приключенческая игра в жанре экшн
/m/0b1vjn	Непринужденная игра
/m/02hygl	Музыкальная видеоигра
/m/04q1x3q	видеоигра-головоломка
/m/01sjng	Гоночная видеоигра
/m/0403l3g	Ролевая видеоигра
/m/021bp2	Видеоигра-симулятор
/m/022dc6	Спортивная игра
/m/03hf_rm	Стратегическая видеоигра
Спортивные темы
/m/06ntj	Спорт (родительская тема)
/m/0jm_	американский футбол
/m/018jz	Бейсбол
/m/018w8	Баскетбол
/m/01cgz	Бокс
/m/09xp_	Крикет
/m/02vx4	Футбол
/м/037Гц	Гольф
/m/03tmr	хоккей с шайбой
/m/01h7lh	Смешанные боевые искусства
/m/0410tth	Автоспорт
/m/07bs0	Теннис
/m/07_53	Волейбол
Темы развлечений
/m/02jjt	Развлечения (родительская тема)
/m/09kqc	Юмор
/m/02vxn	Фильмы
/m/05qjc	исполнительские искусства
/m/066wd	Профессиональная борьба
/m/0f2f9	телешоу
Темы, связанные с образом жизни
/m/019_rr	Образ жизни (родительская тема)
/m/032tl	Мода
/m/027x7n	Фитнес
/m/02wbm	Еда
/m/03glg	Хобби
/m/068hy	Домашние животные
/m/041xxh	Физическая привлекательность [Красота]
/m/07c1v	Технологии
/m/07bxq	Туризм
/m/07yv9	Транспортные средства
Темы общества
/m/098wr	Общество (родительская тема)
/m/09s1f	Бизнес
/m/0kt51	Здоровье
/m/01h6rj	Военный
/m/05qt0	Политика
/m/06bvp	Религия
Другие темы
/m/01k8wb	Знание

topicDetails. topicCategories[] list
Список URL-адресов статей Википедии, содержащих краткое описание содержания видео.

recordingDetails object
Объект recordingDetails содержит информацию о местоположении, дате и адресе, где было записано видео.

recordingDetails. locationDescription string
Данный объект недвижимости был амортизирован с 1 июня 2017 года. Более подробную информацию см. в объявлении об амортизации .

Текстовое описание места, где было записано видео.

recordingDetails. location object
Информация о геолокации, связанная с видео. Обратите внимание, что значения дочерних свойств определяют местоположение, которое владелец видео хочет связать с видео. Это значение можно редактировать, искать в общедоступных видео и оно может отображаться пользователям для общедоступных видео.

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
The fileDetails object encapsulates information about the video file that was uploaded to YouTube, including the file's resolution, duration, audio and video codecs, stream bitrates, and more. This data can only be retrieved by the video owner.

The fileDetails object will only be returned if the processingDetails.fileAvailability property has a value of available .

fileDetails. fileName string
The uploaded file's name. This field is present whether a video file or another type of file was uploaded.

fileDetails. fileSize unsigned long
The uploaded file's size in bytes. This field is present whether a video file or another type of file was uploaded.

fileDetails. fileType

string
The uploaded file's type as detected by YouTube's video processing engine. Currently, YouTube only processes video files, but this field is present whether a video file or another type of file was uploaded.

Valid values for this property are:

archive – The file is an archive file, such as a .zip archive.
audio – The file is a known audio file type, such as an .mp3 file.
document – The file is a document or text file, such as a MS Word document.
image – The file is an image file, such as a .jpeg image.
other – The file is another non-video file type.
project – The file is a video project file, such as a Microsoft Windows Movie Maker project, that does not contain actual video data.
video – The file is a known video file type, such as an .mp4 file.

fileDetails. container string
The uploaded video file's container format.

fileDetails. videoStreams[] list
A list of video streams contained in the uploaded video file. Each item in the list contains detailed metadata about a video stream.

fileDetails.videoStreams[]. widthPixels unsigned integer
The encoded video content's width in pixels. You can calculate the video's encoding aspect ratio as width_pixels / height_pixels .

fileDetails.videoStreams[]. heightPixels unsigned integer
The encoded video content's height in pixels.

fileDetails.videoStreams[]. frameRateFps double
The video stream's frame rate, in frames per second.

fileDetails.videoStreams[]. aspectRatio double
The video content's display aspect ratio, which specifies the aspect ratio in which the video should be displayed.

fileDetails.videoStreams[]. codec string
The video codec that the stream uses.

fileDetails.videoStreams[]. bitrateBps unsigned long
The video stream's bitrate, in bits per second.

fileDetails.videoStreams[]. rotation

string
The amount that YouTube needs to rotate the original source content to properly display the video.

Valid values for this property are:

clockwise – The video needs to be rotated 90 degrees clockwise.
counterClockwise – The video needs to be rotated 90 degrees counter-clockwise.
none – The video does not need to be rotated.
other – The video needs to be rotated in some other, non-trivial way.
upsideDown – The video needs to be rotated upside down.

fileDetails.videoStreams[]. vendor string
A value that uniquely identifies a video vendor. Typically, the value is a four-letter vendor code.

fileDetails. audioStreams[] list
A list of audio streams contained in the uploaded video file. Each item in the list contains detailed metadata about an audio stream.

fileDetails.audioStreams[]. channelCount unsigned integer
The number of audio channels that the stream contains.

fileDetails.audioStreams[]. codec string
The audio codec that the stream uses.

fileDetails.audioStreams[]. bitrateBps unsigned long
The audio stream's bitrate, in bits per second.

fileDetails.audioStreams[]. vendor string
A value that uniquely identifies a video vendor. Typically, the value is a four-letter vendor code.

fileDetails. durationMs unsigned long
The length of the uploaded video in milliseconds.

fileDetails. bitrateBps unsigned long
The uploaded video file's combined (video and audio) bitrate in bits per second.

fileDetails. creationTime

string
The date and time when the uploaded video file was created. The value is specified in ISO 8601 format. Currently, the following ISO 8601 formats are supported:

Date only: YYYY-MM-DD
Naive time: YYYY-MM-DDTHH:MM:SS
Time with timezone: YYYY-MM-DDTHH:MM:SS+HH:MM

processingDetails object
The processingDetails object encapsulates information about YouTube's progress in processing the uploaded video file. The properties in the object identify the current processing status and an estimate of the time remaining until YouTube finishes processing the video. This part also indicates whether different types of data or content, such as file details or thumbnail images, are available for the video.

The processingProgress object is designed to be polled so that the video uploaded can track the progress that YouTube has made in processing the uploaded video file. This data can only be retrieved by the video owner.

processingDetails. processingStatus

string
The video's processing status. This value indicates whether YouTube was able to process the video or if the video is still being processed.

Valid values for this property are:

failed – Video processing has failed. See ProcessingFailureReason.
processing – Video is currently being processed. See ProcessingProgress.
succeeded – Video has been successfully processed.
terminated – Processing information is no longer available.

processingDetails. processingProgress object
The processingProgress object contains information about the progress YouTube has made in processing the video. The values are really only relevant if the video's processing status is processing .

processingDetails.processingProgress. partsTotal unsigned long
An estimate of the total number of parts that need to be processed for the video. The number may be updated with more precise estimates while YouTube processes the video.

processingDetails.processingProgress. partsProcessed unsigned long
The number of parts of the video that YouTube has already processed. You can estimate the percentage of the video that YouTube has already processed by calculating:
100 * parts_processed / parts_total

Note that since the estimated number of parts could increase without a corresponding increase in the number of parts that have already been processed, it is possible that the calculated progress could periodically decrease while YouTube processes a video.

processingDetails.processingProgress. timeLeftMs unsigned long
An estimate of the amount of time, in millseconds, that YouTube needs to finish processing the video.

processingDetails. processingFailureReason

string
The reason that YouTube failed to process the video. This property will only have a value if the processingStatus property's value is failed .

Valid values for this property are:

other – Some other processing component has failed.
streamingFailed – Video could not be sent to streamers.
transcodeFailed – Content transcoding has failed.
uploadFailed – File delivery has failed.

processingDetails. fileDetailsAvailability string
This value indicates whether file details are available for the uploaded video. You can retrieve a video's file details by requesting the fileDetails part in your videos.list() request.

processingDetails. processingIssuesAvailability string
This value indicates whether the video processing engine has generated suggestions that might improve YouTube's ability to process the video, warnings that explain video processing problems, or errors that cause video processing problems. You can retrieve these suggestions by requesting the suggestions part in your videos.list() request.

processingDetails. tagSuggestionsAvailability string
This value indicates whether keyword (tag) suggestions are available for the video. Tags can be added to a video's metadata to make it easier for other users to find the video. You can retrieve these suggestions by requesting the suggestions part in your videos.list() request.

processingDetails. editorSuggestionsAvailability string
This value indicates whether video editing suggestions, which might improve video quality or the playback experience, are available for the video. You can retrieve these suggestions by requesting the suggestions part in your videos.list() request.

processingDetails. thumbnailsAvailability string
This value indicates whether thumbnail images have been generated for the video.

suggestions object
The suggestions object encapsulates suggestions that identify opportunities to improve the video quality or the metadata for the uploaded video. This data can only be retrieved by the video owner.

The suggestions object will only be returned if the processingDetails.tagSuggestionsAvailability property or the processingDetails.editorSuggestionsAvailability property has a value of available .

suggestions. processingErrors[]

list
A list of errors that will prevent YouTube from successfully processing the uploaded video. These errors indicate that, regardless of the video's current processing status , eventually, that status will almost certainly be failed .

Valid values for this property are:

archiveFile – An archive file (eg, a ZIP archive).
audioFile – File contains audio only (eg, an MP3 file).
docFile – Document or text file (eg, MS Word document).
imageFile – Image file (eg, a JPEG image).
notAVideoFile – Other non-video file.
projectFile – Movie project file (eg, Microsoft Windows Movie Maker project).

suggestions. processingWarnings[]

list
A list of reasons why YouTube may have difficulty transcoding the uploaded video or that might result in an erroneous transcoding. These warnings are generated before YouTube actually processes the uploaded video file. In addition, they identify issues that do not necessarily indicate that video processing will fail but that still might cause problems such as sync issues, video artifacts, or a missing audio track.

Valid values for this property are:

hasEditlist – Edit lists are not currently supported.
inconsistentResolution – Conflicting container and stream resolutions.
problematicAudioCodec – Audio codec that is known to cause problems was used.
problematicVideoCodec – Video codec that is known to cause problems was used.
unknownAudioCodec – Unrecognized audio codec, transcoding is likely to fail.
unknownContainer – Unrecognized file format, transcoding is likely to fail.
unknownVideoCodec – Unrecognized video codec, transcoding is likely to fail.

suggestions. processingHints[]

list
A list of suggestions that may improve YouTube's ability to process the video.

Valid values for this property are:

nonStreamableMov – The MP4 file is not streamable, this will slow down the processing.
sendBestQualityVideo – Probably a better quality version of the video exists.

suggestions. tagSuggestions[] list
A list of keyword tags that could be added to the video's metadata to increase the likelihood that users will locate your video when searching or browsing on YouTube.

suggestions.tagSuggestions[]. tag string
The keyword tag suggested for the video.

suggestions.tagSuggestions[]. categoryRestricts[] list
A set of video categories for which the tag is relevant. You can use this information to display appropriate tag suggestions based on the video category that the video uploader associates with the video. By default, tag suggestions are relevant for all categories if there are no restricts defined for the keyword.

suggestions. editorSuggestions[]

list
A list of video editing operations that might improve the video quality or playback experience of the uploaded video.

Valid values for this property are:

audioQuietAudioSwap – The audio track appears silent and could be swapped with a better quality one.
videoAutoLevels – Picture brightness levels seem off and could be corrected.
videoCrop – Margins (mattes) detected around the picture could be cropped.
videoStabilize – The video appears shaky and could be stabilized.

liveStreamingDetails object
The liveStreamingDetails object contains metadata about a live video broadcast. The object will only be present in a video resource if the video is an upcoming, live, or completed live broadcast.

liveStreamingDetails. actualStartTime datetime
The time that the broadcast actually started. The value is specified in ISO 8601 format. This value will not be available until the broadcast begins.

liveStreamingDetails. actualEndTime datetime
The time that the broadcast actually ended. The value is specified in ISO 8601 format. This value will not be available until the broadcast is over.

liveStreamingDetails. scheduledStartTime datetime
The time that the broadcast is scheduled to begin. The value is specified in ISO 8601 format.

liveStreamingDetails. scheduledEndTime datetime
The time that the broadcast is scheduled to end. The value is specified in ISO 8601 format. If the value is empty or the property is not present, then the broadcast is scheduled to continue indefinitely.

liveStreamingDetails. concurrentViewers

unsigned long
The number of viewers currently watching the broadcast. The property and its value will be present if the broadcast has current viewers and the broadcast owner has not hidden the viewcount for the video. Note that YouTube stops tracking the number of concurrent viewers for a broadcast when the broadcast ends. So, this property would not identify the number of viewers watching an archived video of a live broadcast that already ended.

The concurrent viewer counts that the YouTube Data API returns might differ from the processed, despammed concurrent viewer counts available through YouTube Analytics. Learn more about live streaming metrics in the YouTube Help Center .

liveStreamingDetails. activeLiveChatId string
The ID of the currently active live chat attached to this video. This field is filled only if the video is a currently live broadcast that has live chat. Once the broadcast transitions to complete this field will be removed and the live chat closed down. For persistent broadcasts that live chat id will no longer be tied to this video but rather to the new video being displayed at the persistent page.

localizations object
The localizations object contains translations of the video's metadata.

localizations. (key) object
The language of the localized text associated with the key value. The value is a string that contains a BCP-47 language code.

localizations.(key). title string
The localized video title.

localizations.(key). description string
The localized video description.

Videos Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Методы

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

Характеристики

Videos