Videos

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

video представляет собой видео YouTube.

Методы

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

getRating
Получает оценки, которые авторизованный пользователь дал списку указанных видео. Попробуйте сейчас .
list
Возвращает список видео, соответствующих параметрам запроса 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
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "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
Этаг этого ресурса.
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
Указывает, является ли видео предстоящей/активной прямой трансляцией. Или «нет», если видео не является предстоящей/активной прямой трансляцией.

Допустимые значения для этого свойства:
  • 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 – Е
  • acbG – Г
  • acbM – М
  • acbMa15plus – МА15+
  • acbP – программы, которым Австралийское управление по коммуникациям и средствам массовой информации присвоило класс P Эти программы предназначены для детей дошкольного возраста.
  • acbPg – ПГ
  • acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating. agcomRating string
Рейтинг видео предоставлен итальянским агентством Autorità per le Garanzie nelle Comunicazioni (AGCOM).

Допустимые значения для этого свойства:
  • agcomT – Т
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – ВМ18
contentDetails.contentRating. anatelRating string
Рейтинг видео Anatel (Asociación Nacional de Televisión) для чилийского телевидения.

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

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

Допустимые значения для этого свойства:
  • bfvc13 – 13
  • bfvc15 – 15
  • bfvc18 – 18
  • bfvc20 – 20
  • bfvcB – Б
  • bfvcE – Е
  • 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 – А
  • cbfcS – С
  • cbfcU – У
  • 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 – 14А
  • chvrs18a – 18А
  • chvrsE – Е
  • chvrsG – G
  • chvrsPg – PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating. cicfRating string
Рейтинг видео от Комиссии по контролю за кино (Бельгия).

Допустимые значения для этого свойства:
  • cicfE – Е
  • cicfKntEna – КНТ/ЕНА
  • cicfKtEa – КТ/EA
  • cicfUnrated
contentDetails.contentRating. cnaRating string
Рейтинг видео предоставлен румынским CONSILIUL NATIONAL AL ​​AUDIOVIZUALULUI (CNA).

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

Допустимые значения для этого свойства:
  • cnc10 – 10
  • cnc12 – 12
  • cnc16 – 16
  • cnc18 – 18
  • cncE – E
  • cncT – Т
  • cncUnrated
contentDetails.contentRating. csaRating string
Рейтинг видео предоставлен Французским Высшим советом аудиовизуальных средств, который оценивает вещательный контент.

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

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

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

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

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

Допустимые значения для этого свойства:
  • eefilmK12 – К-12
  • eefilmK14 – К-14
  • eefilmK16 – К-16
  • eefilmK6 – К-6
  • eefilmL – Л
  • eefilmMs12 – МС-12
  • eefilmMs6 – МС-6
  • eefilmPere – Пере
  • eefilmUnrated
contentDetails.contentRating. egfilmRating string
Рейтинг видео в Египте.

Допустимые значения для этого свойства:
  • egfilm18 – 18
  • egfilmBn – БН
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating. eirinRating string
Рейтинг видео Эйрин (映倫). Эйрин — японская рейтинговая система.

Допустимые значения для этого свойства:
  • 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 – Ю
  • fcbmUnrated
contentDetails.contentRating. fcoRating string
Рейтинг видео от Управления по делам кино, газет и статей Гонконга.

Допустимые значения для этого свойства:
  • fcoI – я
  • 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 – Е
  • fmocU – У
  • fmocUnrated
contentDetails.contentRating. fpbRating string
Рейтинг видео от Совета по кинематографии и публикациям Южной Африки.

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

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

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

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

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

Допустимые значения для этого свойства:
  • ilfilm12 – 12
  • ilfilm16 – 16
  • ilfilm18 – 18
  • ilfilmAa – АА
  • 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 – АЛ
  • 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 – А
  • lsfBo – БО
  • lsfD – Д
  • lsfR – Р
  • lsfSu – ВС
  • lsfUnrated
contentDetails.contentRating. mccaaRating string
Рейтинг видео от Мальтийского совета по возрастной классификации фильмов.

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

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

Допустимые значения для этого свойства:
  • mcst0 – 0
  • mcst16plus – 16+
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – П
  • mcstUnrated
  • mcstT13 – Т13
  • mcstT16 – Т16
  • mcstT18 – Т18
  • mcstK – К
contentDetails.contentRating. mdaRating string
Рейтинг видео от Управления развития СМИ Сингапура (MDA) и, в частности, от Совета киноцензоров (BFC).

Допустимые значения для этого свойства:
  • mdaG – Г
  • mdaM18 – М18
  • mdaNc16 – NC16
  • mdaPg – ПГ
  • mdaPg13 – PG13
  • mdaR21 – Р21
  • 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 – С
  • 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 – Е
  • mocT – Т
  • mocUnrated
  • mocX – Х
contentDetails.contentRating. moctwRating string
Рейтинг видео от Министерства культуры Тайваня (文化部).

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

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

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

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

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

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

Допустимые значения для этого свойства:
  • nfvcb12 – 12
  • nfvcb12a – 12А
  • 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 – У
  • 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 – ПТ
  • pefilmUnrated
contentDetails.contentRating. resorteviolenciaRating string
Рейтинг видео в Венесуэле.

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

Допустимые значения для этого свойства:
  • rtcA – А
  • rtcAa – АА
  • rtcB – Б
  • rtcB15 – B15
  • rtcC – С
  • rtcD – Д
  • rtcUnrated
contentDetails.contentRating. rteRating string
Рейтинг видео от ирландского журналиста Raidió Teilifís Éireann.

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

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

Допустимые значения для этого свойства:
  • skfilmG – G
  • skfilmP2 – П2
  • skfilmP5 – П5
  • skfilmP8 – P8
  • skfilmUnrated
contentDetails.contentRating. smaisRating string
Рейтинг видео в Исландии.

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

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

Допустимые значения для этого свойства:
  • tvpgG – ТВ-Г
  • tvpgMa – ТВ-МА
  • tvpgPg – ТВ-ПГ
  • tvpgUnrated
  • tvpgY – ТВ-Y
  • tvpgY7 – ТВ-Y7
  • tvpgY7Fv – ТВ-Y7-ФВ
  • 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 , даже если видео уже является частным.
  • Если по вашему запросу запланирована публикация видео в какое-то время в прошлом, оно будет опубликовано сразу. Таким образом, установка свойства 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.
statistics object
Объект statistics содержит статистику о видео.
statistics. viewCount unsigned long
Количество просмотров видео.
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
Количество комментариев к видео.
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 и API Freebase идентификаторы тем начали работать по-другому с 27 февраля 2017 года. В это время YouTube начал возвращать небольшой набор идентификаторов курируемых тем.

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
Объект fileDetails инкапсулирует информацию о видеофайле, загруженном на YouTube, включая разрешение файла, продолжительность, аудио- и видеокодеки, битрейт потока и многое другое. Эти данные может получить только владелец видео.

Объект fileDetails будет возвращен только в том случае, если свойство processingDetails.fileAvailability имеет значение available .
fileDetails. fileName string
Имя загруженного файла. Это поле присутствует независимо от того, был ли загружен видеофайл или файл другого типа.
fileDetails. fileSize unsigned long
Размер загружаемого файла в байтах. 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 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.