Метаданные YouTube

Что возвращает и чего не возвращает oEmbed

oEmbed — небольшой открытый стандарт, с помощью которого сайты описывают ссылку, чтобы другой сайт мог встроить её. Для видео YouTube он возвращает название, имя канала и его URL, готовый плеер <iframe> и одну миниатюру — изображение hqdefault размером 480 × 360. Этого достаточно, чтобы создать карточку ссылки или проверить, какому каналу она принадлежит.

Он не содержит числа просмотров, даты загрузки, длительности, тегов или описания. Эти данные предоставляет YouTube Data API, для которого нужен API key; если требуется только описание, извлекатель описания читает его из общедоступной страницы просмотра.

Если запрос не удался

Приватное, удалённое или неправильно указанное видео ничего не возвращает. То же происходит с видео, владелец которого запретил встраивание, поскольку oEmbed описывает только видео, которые можно встроить на других сайтах. Непубличные видео обычно работают: их может посмотреть любой, у кого есть ссылка. Если ссылка нормально воспроизводится на YouTube, но не работает здесь, вероятнее всего, причина в ограничениях на встраивание; тогда генератор встраивания создаст плеер, который также покажет ошибку на других сайтах.

Как пользоваться

1. Вставьте общедоступный URL YouTube или идентификатор видео.
2. Выберите «Прочитать метаданные».
3. Просмотрите название, канал, миниатюру, идентификатор видео и ссылки.

Конфиденциальность и ограничения

URL отправляется в API TOEA и общедоступную конечную точку метаданных YouTube. TOEA не сохраняет его, не выполняет вход в YouTube и не раскрывает сведения о закрытых видео.