Все видео, загруженные через конечную точку
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 }, "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 Этаг этого ресурса. |
id | string Идентификатор, который YouTube использует для уникальной идентификации видео. |
snippet | object Объект snippet содержит основные сведения о видео, такие как его заголовок, описание и категория. |
snippet. publishedAt | datetime Дата и время публикации видео. Обратите внимание, что это время может отличаться от времени загрузки видео. Например, если видео загружается как личное, а затем публикуется позже, в этом свойстве будет указано время, когда видео было опубликовано. Есть несколько особых случаев:
|
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 Допустимые ключевые значения:
|
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 символов. Обратите внимание на следующие правила расчета лимита символов:
|
snippet. categoryId | string Категория видео YouTube, связанная с видео. Вы должны установить значение для этого свойства, если вы вызываете метод videos.update и обновляете snippet video . |
snippet. liveBroadcastContent | string Указывает, является ли видео предстоящей/активной прямой трансляцией. Или «нет», если видео не является предстоящей/активной прямой трансляцией. Допустимые значения для этого свойства:
|
snippet. defaultLanguage | string Язык текста в свойствах snippet.title и snippet.description video . |
snippet. localized | object Объект snippet.localized содержит либо локализованный заголовок и описание видео, либо заголовок на языке по умолчанию для метаданных видео.
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 ) или только в стандартном разрешении.Допустимые значения для этого свойства:
|
contentDetails. caption | string Указывает, доступны ли субтитры для видео. Допустимые значения для этого свойства:
|
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 используются для классификации детских телепрограмм. Допустимые значения для этого свойства:
|
contentDetails.contentRating. agcomRating | string Рейтинг видео предоставлен итальянским агентством Autorità per le Garanzie nelle Comunicazioni (AGCOM). Допустимые значения для этого свойства:
|
contentDetails.contentRating. anatelRating | string Рейтинг видео Anatel (Asociación Nacional de Televisión) для чилийского телевидения. Допустимые значения для этого свойства:
|
contentDetails.contentRating. bbfcRating | string Рейтинг видео Британского совета по классификации фильмов (BBFC). Допустимые значения для этого свойства:
|
contentDetails.contentRating. bfvcRating | string Рейтинг видео от Совета цензоров кино и видео Таиланда. Допустимые значения для этого свойства:
|
contentDetails.contentRating. bmukkRating | string Рейтинг видео от Австрийского совета по классификации СМИ (Bundesministerium für Unterricht, Kunst und Kultur). Допустимые значения для этого свойства:
|
contentDetails.contentRating. catvRating | string Система рейтингов канадского телевидения - Канадская система классификации телевидения Рейтинг видео Канадской комиссии по радио, телевидению и телекоммуникациям (CRTC) для канадских англоязычных передач. Для получения дополнительной информации посетите веб-сайт Канадского совета по стандартам вещания . Допустимые значения для этого свойства:
|
contentDetails.contentRating. catvfrRating | string Рейтинг видео от Канадской комиссии по радио, телевидению и телекоммуникациям (CRTC) для канадского франкоязычного вещания. Для получения дополнительной информации посетите веб-сайт Канадского совета по стандартам вещания . Допустимые значения для этого свойства:
|
contentDetails.contentRating. cbfcRating | string Рейтинг Центрального совета по сертификации фильмов (CBFC – Индия) видео. Допустимые значения для этого свойства:
|
contentDetails.contentRating. cccRating | string Рейтинг видео Consejo de Calificación Cinematográfica (Чили). Допустимые значения для этого свойства:
|
contentDetails.contentRating. cceRating | string Рейтинг видео предоставлен Комиссией по классификации Португалии. Допустимые значения для этого свойства:
|
contentDetails.contentRating. chfilmRating | string Рейтинг видео в Швейцарии. Допустимые значения для этого свойства:
|
contentDetails.contentRating. chvrsRating | string Рейтинг канадской системы домашнего видео (CHVRS) для видео. Допустимые значения для этого свойства:
|
contentDetails.contentRating. cicfRating | string Рейтинг видео от Комиссии по контролю за кино (Бельгия). Допустимые значения для этого свойства:
|
contentDetails.contentRating. cnaRating | string Рейтинг видео предоставлен румынским CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA). Допустимые значения для этого свойства:
|
contentDetails.contentRating. cncRating | string Система рейтингов во Франции - Комиссия по кинематографической классификации Допустимые значения для этого свойства:
|
contentDetails.contentRating. csaRating | string Рейтинг видео предоставлен Французским Высшим советом аудиовизуальных средств, который оценивает вещательный контент. Допустимые значения для этого свойства:
|
contentDetails.contentRating. cscfRating | string Рейтинг видео предоставлен Комиссией по наблюдению за классификацией фильмов Люксембурга (CSCF). Допустимые значения для этого свойства:
|
contentDetails.contentRating. czfilmRating | string Рейтинг видео в Чехии. Допустимые значения для этого свойства:
|
contentDetails.contentRating. djctqRating | string Рейтинг Департамента юстиции, классификации, квалификации и титулов видео (DJCQT - Бразилия). Допустимые значения для этого свойства:
|
contentDetails.contentRating. djctqRatingReasons[] | list Причины, объясняющие, почему видео получило рейтинг DJCQT (Бразилия). |
contentDetails.contentRating. ecbmctRating | string Рейтинговая система в Турции - Оценочно-классификационный совет Министерства культуры и туризма Допустимые значения для этого свойства:
|
contentDetails.contentRating. eefilmRating | string Рейтинг видео в Эстонии. Допустимые значения для этого свойства:
|
contentDetails.contentRating. egfilmRating | string Рейтинг видео в Египте. Допустимые значения для этого свойства:
|
contentDetails.contentRating. eirinRating | string Рейтинг видео Эйрин (映倫). Эйрин — японская рейтинговая система. Допустимые значения для этого свойства:
|
contentDetails.contentRating. fcbmRating | string Рейтинг видео от Совета по цензуре фильмов Малайзии. Допустимые значения для этого свойства:
|
contentDetails.contentRating. fcoRating | string Рейтинг видео от Управления по делам кино, газет и статей Гонконга. Допустимые значения для этого свойства:
|
contentDetails.contentRating. fmocRating | string Это свойство устарело со 2 ноября 2015 г. Вместо него используйте свойство contentDetails.contentRating.cncRating .Рейтинг видео от Национального центра кино и аниме (Министерство культуры Франции). Допустимые значения для этого свойства:
|
contentDetails.contentRating. fpbRating | string Рейтинг видео от Совета по кинематографии и публикациям Южной Африки. Допустимые значения для этого свойства:
|
contentDetails.contentRating. fpbRatingReasons[] | list Причины, объясняющие, почему видео получило рейтинг ФПБ (ЮАР). |
contentDetails.contentRating. fskRating | string Рейтинг видео Freiwillige Selbstkontrolle der Filmwirtschaft (FSK – Германия). Допустимые значения для этого свойства:
|
contentDetails.contentRating. grfilmRating | string Рейтинг видео в Греции. Допустимые значения для этого свойства:
|
contentDetails.contentRating. icaaRating | string Рейтинг видео Института кинематографии и аудиовизуальных искусств (ICAA, Испания). Допустимые значения для этого свойства:
|
contentDetails.contentRating. ifcoRating | string Рейтинг видео от Ирландского управления классификации фильмов (IFCO – Ирландия). Дополнительную информацию можно найти на веб-сайте IFCO . Допустимые значения для этого свойства:
|
contentDetails.contentRating. ilfilmRating | string Рейтинг видео в Израиле. Допустимые значения для этого свойства:
|
contentDetails.contentRating. incaaRating | string Рейтинг видео INCAA (Национальный институт кино и аудиовизуальных искусств - Аргентина). Допустимые значения для этого свойства:
|
contentDetails.contentRating. kfcbRating | string Рейтинг видео от Классификационной комиссии фильмов Кении. Допустимые значения для этого свойства:
|
contentDetails.contentRating. kijkwijzerRating | string voor de Classificatie van Audiovisuele Media (Нидерланды). Допустимые значения для этого свойства:
|
contentDetails.contentRating. kmrbRating | string Рейтинг видео, присвоенный Корейским медиа-рейтинговым советом (영상물등급위원회). KMRB оценивает видео в Южной Корее. Допустимые значения для этого свойства:
|
contentDetails.contentRating. lsfRating | string Рейтинг видео предоставлен индонезийской компанией Lembaga Sensor Film. Допустимые значения для этого свойства:
|
contentDetails.contentRating. mccaaRating | string Рейтинг видео от Мальтийского совета по возрастной классификации фильмов. Допустимые значения для этого свойства:
|
contentDetails.contentRating. mccypRating | string Рейтинг видео предоставлен Советом СМИ для детей и молодежи Датского института кино (Det Danske Filminstitut). Допустимые значения для этого свойства:
|
contentDetails.contentRating. mcstRating | string Система рейтингов видео для Вьетнама - МЦСТ Допустимые значения для этого свойства:
|
contentDetails.contentRating. mdaRating | string Рейтинг видео от Управления развития СМИ Сингапура (MDA) и, в частности, от Совета киноцензоров (BFC). Допустимые значения для этого свойства:
|
contentDetails.contentRating. medietilsynetRating | string Рейтинг видео от Medietilsynet, Норвежского управления СМИ. Допустимые значения для этого свойства:
|
contentDetails.contentRating. mekuRating | string Рейтинг видео от Национального аудиовизуального института Финляндии Kansallinen Audiovisuaalinen Instituutti. Допустимые значения для этого свойства:
|
contentDetails.contentRating. mibacRating | string Рейтинг видео от Министерства Бени и делле Аттивита Культуры и Туризма (Италия). Допустимые значения для этого свойства:
|
contentDetails.contentRating. mocRating | string Рейтинг видео Министерства культуры (Колумбия). Допустимые значения для этого свойства:
|
contentDetails.contentRating. moctwRating | string Рейтинг видео от Министерства культуры Тайваня (文化部). Допустимые значения для этого свойства:
|
contentDetails.contentRating. mpaaRating | string Рейтинг видео Американской ассоциации кинематографистов (MPAA). Допустимые значения для этого свойства:
|
contentDetails.contentRating. mpaatRating | string Рейтинг Американской киноассоциации по трейлерам и превью фильмов. Допустимые значения для этого свойства:
|
contentDetails.contentRating. mtrcbRating | string Рейтинг видео от Совета по обзору и классификации кино и телевидения (Филиппины). Допустимые значения для этого свойства:
|
contentDetails.contentRating. nbcRating | string Рейтинг видео от Национального бюро классификации Мальдив. Допустимые значения для этого свойства:
|
contentDetails.contentRating. nfrcRating | string Рейтинг видео от Болгарского национального киноцентра . Допустимые значения для этого свойства:
|
contentDetails.contentRating. nfvcbRating | string Рейтинг видео от Национального совета цензоров кино и видео Нигерии. Допустимые значения для этого свойства:
|
contentDetails.contentRating. nkclvRating | string Рейтинг видео от Nacionãlais Kino centrs (Национального киноцентра Латвии). Допустимые значения для этого свойства:
|
contentDetails.contentRating. oflcRating | string Рейтинг видео Управления классификации кино и литературы (OFLC – Новая Зеландия). Допустимые значения для этого свойства:
|
contentDetails.contentRating. pefilmRating | string Рейтинг видео в Перу. Допустимые значения для этого свойства:
|
contentDetails.contentRating. resorteviolenciaRating | string Рейтинг видео в Венесуэле. Допустимые значения для этого свойства:
|
contentDetails.contentRating. rtcRating | string Рейтинг видео Главного управления радио, телевидения и кинематографии (Мексика). Допустимые значения для этого свойства:
|
contentDetails.contentRating. rteRating | string Рейтинг видео от ирландского журналиста Raidió Teilifís Éireann. Допустимые значения для этого свойства:
|
contentDetails.contentRating. russiaRating | string Рейтинг Национального кинореестра Российской Федерации (МКРФ - Россия). Допустимые значения для этого свойства:
|
contentDetails.contentRating. skfilmRating | string Рейтинг видео в Словакии. Допустимые значения для этого свойства:
|
contentDetails.contentRating. smaisRating | string Рейтинг видео в Исландии. Допустимые значения для этого свойства:
|
contentDetails.contentRating. smsaRating | string Рейтинг видео от Statens medieråd (Национальный совет СМИ Швеции). Допустимые значения для этого свойства:
|
contentDetails.contentRating. tvpgRating | string Рейтинг видео для родителей на ТВ (TVPG). Допустимые значения для этого свойства:
|
contentDetails.contentRating. ytRating | string Рейтинг, который YouTube использует для определения контента с возрастными ограничениями. Допустимые значения для этого свойства:
|
contentDetails. projection | string Указывает формат проецирования видео. Допустимые значения для этого свойства:
|
contentDetails. hasCustomThumbnail | boolean Указывает, предоставил ли пользователь, загрузивший видео, собственную миниатюру для видео. Это свойство видно только пользователю, загрузившему видео. |
status | object Объект status содержит информацию о статусах загрузки, обработки и конфиденциальности видео. |
status. uploadStatus | string Статус загруженного видео. Допустимые значения для этого свойства:
|
status. failureReason | string Это значение объясняет, почему видео не удалось загрузить. Это свойство присутствует только в том случае, если свойство uploadStatus указывает на то, что загрузка не удалась.Допустимые значения для этого свойства:
|
status. rejectionReason | string Это значение объясняет, почему YouTube отклонил загруженное видео. Это свойство присутствует только в том случае, если свойство uploadStatus указывает, что загрузка была отклонена.Допустимые значения для этого свойства:
|
status. privacyStatus | string Статус конфиденциальности видео. Допустимые значения для этого свойства:
|
status. publishAt | datetime Дата и время публикации видео. Его можно установить только в том случае, если статус конфиденциальности видео является частным. Значение указывается в формате ISO 8601 . Обратите внимание на следующие два дополнительных момента, касающихся поведения этого свойства:
|
status. license | string Лицензия на видео. Допустимые значения для этого свойства:
|
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 Количество комментариев к видео. |
paidProductPlacementDetails | object Объект paidProductPlacementDetails содержит информацию о платном продакт-плейсменте в видео. |
paidProductPlacementDetails. hasPaidProductPlacement | boolean Установите значение true , если в контенте используется платное продакт-плейсмент. По умолчанию установлено значение false . |
player | object Объект player содержит информацию, которую вы будете использовать для воспроизведения видео во встроенном проигрывателе. |
player. embedHtml | string Тег <iframe> , встраивающий проигрыватель, воспроизводящий видео.
|
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 Размер загружаемого файла в байтах. Это поле присутствует независимо от того, был ли загружен видеофайл или файл другого типа. |
fileDetails. fileType | string Тип загруженного файла, определенный механизмом обработки видео YouTube. В настоящее время YouTube обрабатывает только видеофайлы, но это поле присутствует независимо от того, был ли загружен видеофайл или файл другого типа. Допустимые значения для этого свойства:
|
fileDetails. container | string Загруженный формат контейнера видеофайла. |
fileDetails. videoStreams[] | list Список видеопотоков, содержащихся в загруженном видеофайе. Каждый элемент в списке содержит подробные метаданные о видеопотоке. |
fileDetails.videoStreams[]. widthPixels | unsigned integer Ширина кодированного видеоконтента в пикселях. Вы можете рассчитать соотношение кодирования видео как width_pixels / height_pixels . |
fileDetails.videoStreams[]. heightPixels | unsigned integer Кодированный видеоконтент в пикселях. |
fileDetails.videoStreams[]. frameRateFps | double Частота кадров видеопотока в кадрах в секунду. |
fileDetails.videoStreams[]. aspectRatio | double Соотношение вида отображения видеоконтента, которое указывает соотношение сторон, в котором следует отображать видео. |
fileDetails.videoStreams[]. codec | string Видеокодек, который использует поток. |
fileDetails.videoStreams[]. bitrateBps | unsigned long Битрейт видеопотока, в битах в секунду. |
fileDetails.videoStreams[]. rotation | string Сумма, которую YouTube должна повернуть исходный исходный контент, чтобы правильно отобразить видео. Допустимые значения для этого свойства:
|
fileDetails.videoStreams[]. vendor | string Значение, которое однозначно идентифицирует поставщика видео. Как правило, значение представляет собой четырехбуктный код поставщика. |
fileDetails. audioStreams[] | list Список аудио потоков, содержащихся в загруженном видеофайе. Каждый элемент в списке содержит подробные метаданные о аудио -потоке. |
fileDetails.audioStreams[]. channelCount | unsigned integer Количество аудиоканалов, которые содержит поток. |
fileDetails.audioStreams[]. codec | string Аудиокодек, который использует поток. |
fileDetails.audioStreams[]. bitrateBps | unsigned long Битрейт аудио -потока, в битах в секунду. |
fileDetails.audioStreams[]. vendor | string Значение, которое однозначно идентифицирует поставщика видео. Как правило, значение представляет собой четырехбуктный код поставщика. |
fileDetails. durationMs | unsigned long Длина загруженного видео в миллисекундах. |
fileDetails. bitrateBps | unsigned long Битрат загруженного видеофайла (видео и аудио) в битах в секунду. |
fileDetails. creationTime | string Дата и время, когда был создан загруженный видеофайл. Значение указано в формате ISO 8601 . В настоящее время поддерживаются следующие форматы ISO 8601:
|
processingDetails | object Объект processingDetails инкапсулирует информацию о прогрессе YouTube в обработке загруженного видеофайла. Свойства в объекте определяют текущий статус обработки и оценку времени, оставшегося до тех пор, пока YouTube не завершит обработку видео. Эта часть также указывает, доступны ли различные типы данных или контента, такие как данные файла или миниатюры, доступны для видео.Объект processingProgress предназначен для опроса, чтобы загруженное видео могло отслеживать прогресс, достигнутый YouTube при обработке загруженного видеофайла. Эти данные могут быть извлечены только владельцем видео. |
processingDetails. processingStatus | string Статус обработки видео. Это значение указывает, смог ли YouTube обработать видео или все еще обрабатывается видео. Допустимые значения для этого свойства:
|
processingDetails. processingProgress | object Объект processingProgress содержит информацию о прогрессе YouTube при обработке видео. Значения действительно актуальны только в том случае, если статус обработки видео processing . |
processingDetails.processingProgress. partsTotal | unsigned long Оценка общего количества частей, которые необходимо обработать для видео. Число может быть обновлено с более точными оценками, в то время как YouTube обрабатывает видео. |
processingDetails.processingProgress. partsProcessed | unsigned long Количество частей видео, которые уже обработал YouTube. Вы можете оценить процент видео, которое YouTube уже обработала путем расчета: 100 * parts_processed / parts_total Обратите внимание, что, поскольку предполагаемое количество частей может увеличиться без соответствующего увеличения количества частей, которые уже были обработаны, возможно, что рассчитываемый прогресс может периодически уменьшаться, когда на YouTube обрабатывает видео. |
processingDetails.processingProgress. timeLeftMs | unsigned long Оценка количества времени, в Миллсекундах, которое YouTube необходимо завершить обработку видео. |
processingDetails. processingFailureReason | string Причина, по которой YouTube не удалось обработать видео. Это свойство будет иметь значение только в том случае, если значение свойства processingStatus failed .Допустимые значения для этого свойства:
|
processingDetails. fileDetailsAvailability | string Это значение указывает, доступны ли данные файла для загруженного видео. Вы можете получить данные файла видео, запрашивая деталь fileDetails в вашем запросе videos.list() . |
processingDetails. processingIssuesAvailability | string Это значение указывает на то, создал ли двигатель обработки видео -обработки, которые могут улучшить способность YouTube обрабатывать видео, предупреждения, объясняющие проблемы обработки видео или ошибки, которые вызывают проблемы с обработкой видео. Вы можете получить эти предложения, запрашивая suggestions в вашем запросе videos.list() . |
processingDetails. tagSuggestionsAvailability | string Это значение указывает, доступны ли ключевые слова (теги) предложения для видео. Теги могут быть добавлены в метаданные видео, чтобы другим пользователям было легче найти видео. Вы можете получить эти предложения, запрашивая suggestions в вашем запросе videos.list() . |
processingDetails. editorSuggestionsAvailability | string Это значение указывает, доступны ли для видео предложения по редактированию видео, которые могут улучшить качество видео или опыт воспроизведения. Вы можете получить эти предложения, запрашивая suggestions в вашем запросе videos.list() . |
processingDetails. thumbnailsAvailability | string Это значение указывает на то, были ли сгенерированы изображения миниатюры для видео. |
suggestions | object Объект suggestions инкапсулирует предложения, которые определяют возможности для улучшения качества видео или метаданных для загруженного видео. Эти данные могут быть извлечены только владельцем видео.Объект suggestions будет возвращен только в том случае available если processingDetails.tagSuggestionsAvailability processingDetails.editorSuggestionsAvailability |
suggestions. processingErrors[] | list Список ошибок, которые не позволят успешно обработать загруженное видео YouTube. Эти ошибки указывают на то, что, независимо от текущего статуса обработки видео, в конечном итоге этот статус почти наверняка не будет failed .Допустимые значения для этого свойства:
|
suggestions. processingWarnings[] | list Список причин, по которым YouTube может испытывать трудности с транскодированием загруженного видео или которые могут привести к ошибочному транскодированию. Эти предупреждения генерируются до того, как YouTube фактически обрабатывает загруженный видеофайл. Кроме того, они выявляют проблемы, которые не обязательно указывают на то, что обработка видео потерпит неудачу, но это все еще может вызвать такие проблемы, как проблемы синхронизации, видео -артефакты или отсутствующий аудио -трек. Допустимые значения для этого свойства:
|
suggestions. processingHints[] | list Список предложений, которые могут улучшить способность YouTube обрабатывать видео. Допустимые значения для этого свойства:
|
suggestions. tagSuggestions[] | list Список тегов ключевых слов, которые могут быть добавлены в метаданные видео, чтобы увеличить вероятность того, что пользователи найдут ваше видео при поиске или просмотре на YouTube. |
suggestions.tagSuggestions[]. tag | string Тег ключевого слова предлагается для видео. |
suggestions.tagSuggestions[]. categoryRestricts[] | list Набор категорий видео, для которых тег актуален. Вы можете использовать эту информацию для отображения соответствующих предложений тегов на основе категории видео, которую видео загрузчика связывает с видео. По умолчанию предложения тегов имеют отношение к всем категориям, если нет ограничений, определенных для ключевого слова. |
suggestions. editorSuggestions[] | list Список операций по редактированию видео, которые могут улучшить качество видео или воспроизведение загруженного видео. Допустимые значения для этого свойства:
|
liveStreamingDetails | object Объект liveStreamingDetails содержит метаданные о прямой трансляции видео. Объект будет присутствовать в video ресурсе только в том случае, если видео будет предстоящей, живой или завершенной прямой трансляцией. |
liveStreamingDetails. actualStartTime | datetime Время, когда трансляция фактически началась. Значение указано в формате ISO 8601 . Это значение не будет доступно до начала трансляции. |
liveStreamingDetails. actualEndTime | datetime Время, когда трансляция фактически закончилась. Значение указано в формате ISO 8601 . Это значение не будет доступно до тех пор, пока трансляция не закончится. |
liveStreamingDetails. scheduledStartTime | datetime Время, когда трансляция должна начаться. Значение указано в формате ISO 8601 . |
liveStreamingDetails. scheduledEndTime | datetime Время, когда трансляция запланирована, закончится. Значение указано в формате ISO 8601 . Если значение пустое или свойство не присутствует, то трансляция планируется продолжаться бесконечно. |
liveStreamingDetails. concurrentViewers | unsigned long Количество зрителей, которые в настоящее время смотрят трансляцию. Собственность и ее стоимость будут присутствовать, если у трансляции есть нынешние зрители, а владелец трансляции не скрывал ViewCount для видео. Обратите внимание, что YouTube прекращает отслеживать количество одновременных зрителей для трансляции, когда трансляция заканчивается. Таким образом, это свойство не определит количество зрителей, которые смотрят архивное видео живой трансляции, которая уже закончилась. Одновременный зритель считает, что возврат API данных YouTube может отличаться от обработанного, преподаваемого одновременного зрителя, доступного через аналитику YouTube. Узнайте больше о живых потоковых метрик в Центре справки YouTube . |
liveStreamingDetails. activeLiveChatId | string Идентификатор активного живого чата прикреплен к этому видео. Это поле заполнено только в том случае, если видео является живой трансляцией в настоящее время, в которой есть живой чат. После того, как трансляции переходят на завершение этого поля, и будет удалена чат, а чат закрыт. Для постоянных трансляций, которые идентификатор в чате больше не будут привязаны к этому видео, а скорее с новым видео, отображаемым на постоянной странице. |
localizations | object Объект localizations содержит переводы метаданных видео. |
localizations. (key) | object Язык локализованного текста, связанный с ключевым значением. Значение-это строка, которая содержит языковой код BCP-47 . |
localizations.(key). title | string Локализованное видео название. |
localizations.(key). description | string Локализованное видео описание. |