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

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,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

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

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

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

kind string
Идентифицирует тип ресурса API. Значением будет youtube#video .

etag etag
Этаг этого ресурса.

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.

status. containsSyntheticMedia

boolean
В запросе videos.insert или videos.update это свойство позволяет владельцу канала сообщить, что видео содержит реалистичный измененный или синтетический ( A/S ) контент. Узнайте больше о правилах YouTube в отношении контента A/S .

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

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

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

statistics. viewCount

unsigned long

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

Начиная с 31 марта 2025 г. для коротких видео функция viewCount будет возвращать количество раз, когда короткометражное видео запускалось или воспроизводилось повторно, без каких-либо требований к минимальному времени просмотра.

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

statistics. dislikeCount

unsigned long

Примечание. С 13 декабря 2021 г. свойство statistics.dislikeCount стало закрытым. Это означает, что это свойство включается в ответ API только в том случае, если запрос API был подтвержден владельцем видео. Дополнительную информацию смотрите в истории изменений .

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

statistics. favoriteCount unsigned long
Примечание. Это свойство устарело. Прекращение поддержки вступает в силу 28 августа 2015 г. Значение свойства теперь всегда равно 0 .

statistics. commentCount unsigned long
Количество комментариев к видео.

paidProductPlacementDetails object
Объект paidProductPlacementDetails содержит информацию о платном продакт-плейсменте в видео.

paidProductPlacementDetails. hasPaidProductPlacement boolean
Установите значение true , если в контенте используется платное продакт-плейсмент. По умолчанию установлено значение false .

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

player. embedHtml

string
Тег <iframe> , встраивающий проигрыватель, воспроизводящий видео.

Если запрос API на получение ресурса указывает значение параметров maxHeight и/или maxWidth , размер встроенного проигрывателя масштабируется в соответствии с требованиями maxHeight и/или maxWidth .
Если соотношение сторон видео неизвестно, встроенный проигрыватель по умолчанию использует формат 4:3.

player. embedHeight long
Высота встроенного проигрывателя возвращается в свойстве player.embedHtml . Это свойство возвращается только в том случае, если в запросе указано значение параметров maxHeight и/или maxWidth и известно соотношение сторон видео.

player. embedWidth long
Ширина встроенного проигрывателя, возвращаемая в свойстве player.embedHtml . Это свойство возвращается только в том случае, если в запросе указано значение параметров maxHeight и/или maxWidth и известно соотношение сторон видео.

topicDetails object
Объект topicDetails инкапсулирует информацию о темах, связанных с видео.

Важно! Дополнительные сведения о предстоящих изменениях, связанных с идентификаторами тем, см. в определениях свойств topicDetails.relevantTopicIds[] и topicDetails.topicIds[] , а также в истории изменений .

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

topicDetails. relevantTopicIds[]

list
Список идентификаторов тем, имеющих отношение к видео.

Это свойство устарело с 10 ноября 2016 г. Оно будет поддерживаться до 10 ноября 2017 г.

Важно! Из-за прекращения поддержки Freebase и API Freebase идентификаторы тем начали работать по-другому с 27 февраля 2017 г. В это время YouTube начал возвращать небольшой набор идентификаторов курируемых тем.

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

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

topicDetails. topicCategories[] list
Список URL-адресов Википедии, которые предоставляют высокоуровневое описание содержимого видео.

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

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

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

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

recordingDetails.location. latitude double
Этот объект устарел с 1 июня 2017 года. Более подробную информацию можно найти в объявлении о прекращении поддержки .

Широта в градусах.

recordingDetails.location. longitude double
Этот объект устарел с 1 июня 2017 года. Более подробную информацию можно найти в объявлении о прекращении поддержки .

Долгота в градусах.

recordingDetails.location. altitude double
Этот объект устарел с 9 июля 2018 года. Более подробную информацию можно найти в объявлении о прекращении поддержки .

Высота над опорным эллипсоидом в метрах.

recordingDetails. recordingDate datetime
Дата и время записи видео. Значение указывается в формате ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ ).

fileDetails object
Объект fileDetails инкапсулирует информацию о видеофайле, который был загружен на YouTube, включая разрешение файла, продолжительность, аудио и видеокодеки, битрейты потока и многое другое. Эти данные могут быть извлечены только владельцем видео.

Объект fileDetails будет возвращен только в том случае, если свойство processingDetails.fileAvailability имеет значение available .

fileDetails. fileName string
Имя загруженного файла. Это поле присутствует, был ли был загружен видеофайл или другой тип файла.

fileDetails. fileSize unsigned long
Размер загруженного файла в байтах. Это поле присутствует, был ли был загружен видеофайл или другой тип файла.

fileDetails. fileType

string
Тип загруженного файла, обнаруженный двигателем обработки видео YouTube. В настоящее время YouTube обрабатывает только видеофайлы, но это поле присутствует, был ли загруженный видеофайл или другой тип файла.

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

archive - файл представляет собой архивный файл, такой как архив .zip.
audio - файл является известным аудио -файлом, таким как файл .mp3.
document - файл является документом или текстовым файлом, таким как документ MS Word.
image - файл - это файл изображения, такой как изображение .jpeg.
other -файл-это еще один тип файла, не являющегося Video.
project - файл представляет собой файл видеопроекта, такой как проект Microsoft Windows Movie Maker, который не содержит реальных видеодантеров.
video - файл является известным типом видеофайла, такого как файл .mp4.

fileDetails. container string
Загруженный формат контейнера видеофайла.

fileDetails. videoStreams[] list
Список видеопотоков, содержащихся в загруженном видеофайе. Каждый элемент в списке содержит подробные метаданные о видеопотоке.

fileDetails.videoStreams[]. widthPixels unsigned integer
Ширина кодированного видеоконтента в пикселях. Вы можете рассчитать соотношение кодирования видео как width_pixels / height_pixels .

fileDetails.videoStreams[]. heightPixels unsigned integer
Кодированный видеоконтент в пикселях.

fileDetails.videoStreams[]. frameRateFps double
Частота кадров видеопотока в кадрах в секунду.

fileDetails.videoStreams[]. aspectRatio double
Соотношение вида отображения видеоконтента, которое указывает соотношение сторон, в котором следует отображать видео.

fileDetails.videoStreams[]. codec string
Видеокодек, который использует поток.

fileDetails.videoStreams[]. bitrateBps unsigned long
Битрейт видеопотока, в битах в секунду.

fileDetails.videoStreams[]. rotation

string
Сумма, которую YouTube должна повернуть исходный исходный контент, чтобы правильно отобразить видео.

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

clockwise - видео нужно повернуть на 90 градусов по часовой стрелке.
counterClockwise -видео необходимо повернуть на 90 градусов против часовой стрелки.
none - видео не нужно вращать.
other -видео нужно вращать каким-то другим, нетривиальным способом.
upsideDown - видео нужно повернуть вверх ногами.

fileDetails.videoStreams[]. vendor string
Значение, которое однозначно идентифицирует поставщика видео. Как правило, значение представляет собой четырехбуктный код поставщика.

fileDetails. audioStreams[] list
Список аудио потоков, содержащихся в загруженном видеофайе. Каждый элемент в списке содержит подробные метаданные о аудио -потоке.

fileDetails.audioStreams[]. channelCount unsigned integer
Количество аудиоканалов, которые содержит поток.

fileDetails.audioStreams[]. codec string
Аудиокодек, который использует поток.

fileDetails.audioStreams[]. bitrateBps unsigned long
Битрейт аудио -потока, в битах в секунду.

fileDetails.audioStreams[]. vendor string
Значение, которое однозначно идентифицирует поставщика видео. Как правило, значение представляет собой четырехбуктный код поставщика.

fileDetails. durationMs unsigned long
Длина загруженного видео в миллисекундах.

fileDetails. bitrateBps unsigned long
Битрат загруженного видеофайла (видео и аудио) в битах в секунду.

fileDetails. creationTime

string
Дата и время, когда был создан загруженный видеофайл. Значение указано в формате ISO 8601 . В настоящее время поддерживаются следующие форматы ISO 8601:

Только дата: YYYY-MM-DD
Наивное время: YYYY-MM-DDTHH:MM:SS
Время с часовым поясом: YYYY-MM-DDTHH:MM:SS+HH:MM

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

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

processingDetails. processingStatus

string
Статус обработки видео. Это значение указывает, смог ли YouTube обработать видео или все еще обрабатывается видео.

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

failed - обработка видео не удалась. См. ProcessingFailurerease Season.
processing - видео в настоящее время обрабатывается. См. Программный процесс.
succeeded - видео было успешно обработано.
terminated - информация о обработке больше не доступна.

processingDetails. processingProgress object
Объект processingProgress содержит информацию о прогрессе YouTube при обработке видео. Значения действительно актуальны только в том случае, если статус обработки видео processing .

processingDetails.processingProgress. partsTotal unsigned long
Оценка общего количества частей, которые необходимо обработать для видео. Число может быть обновлено с более точными оценками, в то время как YouTube обрабатывает видео.

processingDetails.processingProgress. partsProcessed unsigned long
Количество частей видео, которые уже обработал YouTube. Вы можете оценить процент видео, которое YouTube уже обработала путем расчета:
100 * parts_processed / parts_total

Обратите внимание, что, поскольку предполагаемое количество частей может увеличиться без соответствующего увеличения количества частей, которые уже были обработаны, возможно, что рассчитываемый прогресс может периодически уменьшаться, когда на YouTube обрабатывает видео.

processingDetails.processingProgress. timeLeftMs unsigned long
Оценка количества времени, в Миллсекундах, которое YouTube необходимо завершить обработку видео.

processingDetails. processingFailureReason

string
Причина, по которой YouTube не удалось обработать видео. Это свойство будет иметь значение только в том случае, если значение свойства processingStatus failed .

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

other - какой -то другой компонент обработки потерпел неудачу.
streamingFailed - видео не может быть отправлено стримерам.
transcodeFailed - Контент -транскодирование не удалось.
uploadFailed - доставка файлов не удалась.

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 .

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

archiveFile - архивный файл (например, архив ZIP).
audioFile - файл содержит только аудио (например, файл mp3).
docFile - документ или текстовый файл (например, документ MS Word).
imageFile - файл изображения (например, изображение JPEG).
notAVideoFile -другой неиндео-файл.
projectFile - Файл проекта фильма (например, Microsoft Windows Movie Maker Project).

suggestions. processingWarnings[]

list
Список причин, по которым YouTube может испытывать трудности с транскодированием загруженного видео или которые могут привести к ошибочному транскодированию. Эти предупреждения генерируются до того, как YouTube фактически обрабатывает загруженный видеофайл. Кроме того, они выявляют проблемы, которые не обязательно указывают на то, что обработка видео потерпит неудачу, но это все еще может вызвать такие проблемы, как проблемы синхронизации, видео -артефакты или отсутствующий аудио -трек.

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

hasEditlist - Редактировать списки в настоящее время не поддерживаются.
inconsistentResolution - противоречивые контейнер и разрешения потока.
problematicAudioCodec - аудиокодек, который, как известно, вызывал проблемы.
problematicVideoCodec - видеокодек, который, как известно, вызывает проблемы.
unknownAudioCodec - нераспознанный аудиокодек, транскодирование, вероятно, потерпит неудачу.
unknownContainer - нераспознанный формат файла, транскодирование, вероятно, не удастся.
unknownVideoCodec - нераспознанный видеокодек, транскодирование, вероятно, потерпит неудачу.

suggestions. processingHints[]

list
Список предложений, которые могут улучшить способность YouTube обрабатывать видео.

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

nonStreamableMov - файл MP4 не является потоком, это замедлит обработку.
sendBestQualityVideo - Вероятно, существует лучшая качественная версия видео.

suggestions. tagSuggestions[] list
Список тегов ключевых слов, которые могут быть добавлены в метаданные видео, чтобы увеличить вероятность того, что пользователи найдут ваше видео при поиске или просмотре на YouTube.

suggestions.tagSuggestions[]. tag string
Тег ключевого слова предлагается для видео.

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

suggestions. editorSuggestions[]

list
Список операций по редактированию видео, которые могут улучшить качество видео или воспроизведение загруженного видео.

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

audioQuietAudioSwap - аудио -трек появляется тихо и может быть поменена с лучшим качеством.
videoAutoLevels - Уровни яркости изображения кажутся и могут быть исправлены.
videoCrop - Margins (Mattes), обнаруженная вокруг картинки, может быть обрезана.
videoStabilize - видео выглядит шатким и может быть стабилизировано.

liveStreamingDetails object
Объект liveStreamingDetails содержит метаданные о прямой трансляции видео. Объект будет присутствовать в video ресурсе только в том случае, если видео будет предстоящей, живой или завершенной прямой трансляцией.

liveStreamingDetails. actualStartTime datetime
Время, когда трансляция фактически началась. Значение указано в формате ISO 8601 . Это значение не будет доступно до начала трансляции.

liveStreamingDetails. actualEndTime datetime
Время, когда трансляция фактически закончилась. Значение указано в формате ISO 8601 . Это значение не будет доступно до тех пор, пока трансляция не закончится.

liveStreamingDetails. scheduledStartTime datetime
Время, когда трансляция должна начаться. Значение указано в формате ISO 8601 .

liveStreamingDetails. scheduledEndTime datetime
Время, когда трансляция запланирована, закончится. Значение указано в формате ISO 8601 . Если значение пустое или свойство не присутствует, то трансляция планируется продолжаться бесконечно.

liveStreamingDetails. concurrentViewers

unsigned long
Количество зрителей, которые в настоящее время смотрят трансляцию. Собственность и ее стоимость будут присутствовать, если у трансляции есть нынешние зрители, а владелец трансляции не скрывал 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
Локализованное видео описание.

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

Методы

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

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

Videos