YouTube API - YouTube API

В Интерфейс программирования приложений YouTube (YouTube API) позволяет разработчикам получать доступ к статистике видео и Каналы YouTube данные через два типа вызовов, ОТДЫХ и XML-RPC. Google описывает ресурсы API YouTube как «API и инструменты, которые позволяют вам использовать YouTube на своей веб-странице, в приложении или устройстве».[1]

Игроки и API игроков

В разделе «Проигрыватели» и «API-интерфейсы проигрывателей» указаны способы, с помощью которых вы можете разрешить пользователям просматривать видео YouTube в вашем приложении и управлять воспроизведением. Благодаря встроенному проигрывателю YouTube вы можете интегрировать воспроизведение видео YouTube прямо на свою веб-страницу или в приложение. Вы можете использовать параметры проигрывателя для настройки внешнего вида проигрывателя, а также можете использовать API проигрывателя для управления проигрывателем прямо со своей веб-страницы или приложения.[2]

API и инструменты проигрывателя

Android

  • Player API
  • Пример приложения Player API
  • Справочник по API проигрывателя
  • Пример приложения YouTube Direct

Минимальная версия, поддерживаемая Android для последних версий API, в настоящее время - 2.2. На устройстве Android также должно быть установлено приложение YouTube версии 4.2.16. С этого момента, используя веб-ключ, можно использовать API Googles на телефоне Android с поддержкой разработчика.[3]

iOS

  • Player IFrame API
  • Пример приложения YouTube Direct

Использование версий API для iOS очень похоже на объяснение для Android. Однако это связано с использованием Google Cloud Console. Оттуда вы можете управлять API и настраивать API для работы с вашими видео. Вам также понадобятся идентификатор клиента и секрет клиента; которые можно загрузить с сайта API Google. После этого выполняется простой процесс запуска образца, и API должны быть должным образом интегрированы.[4]

Другие API включают ресурсы, которые можно внедрить на сторонний веб-сайт. Это обычные интегрированные API-интерфейсы социальных сетей, с которыми мы регулярно сталкиваемся, например кнопка «Нравится» в Facebook или кнопка «Подписаться» в Twitter. API виджетов YouTube включают:

  • Кнопка подписки
  • Загрузить виджет
  • Демо Player API
  • Игровая площадка для кода API игрока

API данных и аналитики

В разделе Data and Analytics APIs кратко описаны API, которые позволяют вашему приложению получать доступ к функциям и данным, обычно доступным на веб-сайте YouTube.[5]

YouTube API V3

API данных YouTube (v3) позволяет включать функции YouTube в собственное приложение. Вы можете использовать API для получения результатов поиска, а также для извлечения, вставки, обновления и удаления ресурсов, таких как видео или плейлисты.

В сочетании с API YouTube Player и YouTube Analytics API позволяет вашему приложению предоставлять полноценные возможности YouTube, включая поиск и обнаружение, создание контента, воспроизведение видео, управление аккаунтом и статистику просмотров.

youtube.activities.insertПубликует бюллетень для определенного канала. (Пользователь, отправляющий запрос, должен иметь полномочия действовать от имени канала.)

Примечание. Несмотря на то, что ресурс активности может содержать информацию о таких действиях, как оценка пользователем видео или отметка видео как избранного, для создания этих ресурсов действий необходимо использовать другие методы API. Например, вы могли бы использовать метод API videos.rate () для оценки видео и метод playlistItems.insert (), чтобы отметить видео как избранное.

youtube.activities.listВозвращает список событий активности канала, соответствующих критериям запроса. Например, вы можете получать события, связанные с определенным каналом, события, связанные с подписками пользователя и друзьями в Google+, или фид главной страницы YouTube, который настраивается для каждого пользователя.
youtube.channelBanners.insertЗагружает изображение баннера канала на YouTube. Этот метод представляет собой первые два шага в трехэтапном процессе обновления изображения баннера для канала:

- Вызовите метод channelBanners.insert, чтобы загрузить двоичные данные изображения на YouTube. Изображение должно иметь соотношение сторон 16: 9 и быть не менее 2120x1192 пикселей. - Извлеките значение свойства url из ответа, возвращаемого API для шага 1. - Вызовите метод channels.update, чтобы обновить настройки брендинга канала. Задайте для свойства brandingSettings.image.bannerExternalUrl значение URL-адреса, полученного на шаге 2.

youtube.channelSections.deleteУдаляет раздел канала.
youtube.channelSections.insertДобавляет channelSection для канала аутентифицированного пользователя.
youtube.channelSections.listВозвращает ресурсы channelSection, соответствующие критериям запроса API.
youtube.channelSections.updateОбновите раздел channel.
youtube.channels.listВозвращает коллекцию из нуля или более ресурсов канала, соответствующих критериям запроса.
youtube.channels.updateОбновляет метаданные канала.
youtube.guideCategories.listВозвращает список категорий, которые могут быть связаны с каналами YouTube.
youtube.i18nLanguages.listВозвращает список поддерживаемых языков.
youtube.i18nRegions.listВозвращает список поддерживаемых регионов.
youtube.liveBroadcasts.bindПривязывает трансляцию YouTube к потоку или удаляет существующую привязку между трансляцией и потоком. Трансляция может быть привязана только к одному видеопотоку.
youtube.liveBroadcasts.controlУправляет настройками рекламного листа, который может отображаться в широковещательном потоке.
youtube.liveBroadcasts.deleteУдаляет трансляцию.
youtube.liveBroadcasts.insertСоздает трансляцию.
youtube.liveBroadcasts.listВозвращает список трансляций YouTube, соответствующих параметрам запроса API.
youtube.liveBroadcasts.transitionИзменяет статус прямой трансляции YouTube и инициирует любые процессы, связанные с новым статусом. Например, когда вы переводите статус трансляции в режим тестирования, YouTube начинает передавать видео в поток монитора этой трансляции. Перед вызовом этого метода вы должны подтвердить, что значение свойства status.streamStatus для потока, привязанного к вашей трансляции, активно.
youtube.liveBroadcasts.updateОбновляет трансляцию. Например, вы можете изменить настройки трансляции, определенные в объекте contentDetails ресурса liveBroadcast.
youtube.liveStreams.deleteУдаляет видеопоток.
youtube.liveStreams.insertСоздает видеопоток. Поток позволяет вам отправить ваше видео на YouTube, который затем может транслировать видео вашей аудитории.
youtube.liveStreams.listВозвращает список видеопотоков, соответствующих параметрам запроса API.
youtube.liveStreams.updateОбновляет видеопоток. Если свойства, которые вы хотите изменить, не могут быть обновлены, вам необходимо создать новый поток с соответствующими настройками.
youtube.playlistItems.deleteУдаляет элемент списка воспроизведения.
youtube.playlistItems.insertДобавляет ресурс в список воспроизведения.
youtube.playlistItems.listВозвращает коллекцию элементов списка воспроизведения, соответствующих параметрам запроса API. Вы можете получить все элементы списка воспроизведения в указанном списке воспроизведения или получить один или несколько элементов списка воспроизведения по их уникальным идентификаторам.
youtube.playlistItems.updateИзменяет элемент списка воспроизведения. Например, вы можете обновить позицию элемента в списке воспроизведения.
youtube.playlists.deleteУдаляет плейлист.
youtube.playlists.insertСоздает список воспроизведения.
youtube.playlists.listВозвращает коллекцию плейлистов, соответствующих параметрам запроса API. Например, вы можете получить все списки воспроизведения, принадлежащие аутентифицированному пользователю, или один или несколько списков воспроизведения по их уникальным идентификаторам.
youtube.playlists.updateИзменяет список воспроизведения. Например, вы можете изменить название, описание или статус конфиденциальности плейлиста.
youtube.search.listВозвращает коллекцию результатов поиска, соответствующих параметрам запроса, указанным в запросе API. По умолчанию набор результатов поиска идентифицирует совпадающие ресурсы видео, канала и списка воспроизведения, но вы также можете настроить запросы для извлечения только определенного типа ресурса.
youtube.subscriptions.deleteУдаляет подписку.
youtube.subscriptions.insertДобавляет подписку на канал аутентифицированного пользователя.
youtube.subscriptions.listВозвращает ресурсы подписки, соответствующие критериям запроса API.
youtube.thumbnails.setЗагружает пользовательский эскиз видео на YouTube и устанавливает его для видео.
youtube.videoCategories.listВозвращает список категорий, которые могут быть связаны с видео YouTube.
youtube.videos.deleteУдаляет видео с YouTube.
youtube.videos.getRatingПолучает оценки, которые авторизованный пользователь дал списку указанных видео.
youtube.videos.insertЗагружает видео на YouTube и дополнительно устанавливает метаданные видео.
youtube.videos.listВозвращает список видео, соответствующих параметрам запроса API.
youtube.videos.rateДобавьте оценку «нравится» или «не нравится» видео или удалите оценку для видео.
youtube.videos.updateОбновляет метаданные видео.
youtube.watermarks.setЗагружает изображение водяного знака на YouTube и устанавливает его для канала.
youtube.watermarks.unsetУдаляет водяной знак.

Кнопки, виджеты и инструменты

В разделе «Кнопки, виджеты и инструменты» описаны другие инструменты, которые можно использовать для добавления функций YouTube в свое приложение или для тестирования API YouTube.[6]

Как использовать API YouTube

Чтобы использовать API YouTube, разработчик должен получить идентификатор разработчика - это дополнительное свойство, которое привязано к аккаунту разработчика на YouTube. Информация, доступная разработчикам, аналогична информации, которую можно получить, открыв множество RSS-каналы. После интеграции Google и YouTube можно войти в YouTube, используя существующую учетную запись Google. Простое в использовании руководство можно найти в виде видео на YouTube.[7]
С тех пор API были расширены и теперь совместимы со многими мобильными операционными платформами, такими как Android и iOS. Совершенно очевидно, что API Android более полны, при этом ресурсы iOS несколько отсутствуют. Список этих API, доступных для обеих платформ, приведен ниже:

Другие API YouTube (традиционные API) включают:
Analytics API

  • Начиная
  • Примеры кода
  • Справочник по API
  • Образцы запросов
  • Образец заявки

API данных

  • Начиная
  • Образцы запросов
  • Руководства и учебные пособия
  • Справочник по API
  • API Explorer

Преимущества

Большим преимуществом использования API YouTube является то, что сторонние компании могут организовать оплату за клик в сочетании с рекламой ваших видео. Это позволяет пользователю, загрузившему видео, получать деньги за работу, которую он вложил в свои видео.[8]API YouTube также позволяет более тесно интегрировать видеосервис со сторонним веб-сайтом. По сути, это означает, что пользователю не нужно щелкать ссылку, чтобы перейти к видео YouTube. Вместо этого они могут просматривать видео на той же странице, которую они посещают.[9]Еще одно преимущество использования API YouTube состоит в том, что легче выбрать конкретные данные и видео для хранения на стороннем сайте.[10]

Недостатки

В течение периода, включавшего март 2006 г., вызовы API из Flash были отключены из соображений безопасности. Однако с тех пор они были снова включены.[11]
Также есть проблемы на данный момент (октябрь 2014 г.) с ориентацией на Android-устройствах. Даже при добавлении полноэкранного режима в AndroidManifest он по-прежнему не загружается должным образом в правильной полноэкранной ориентации.[12]
YouTube также не позволяет запускать видео, пока устройство Android находится в спящем режиме. Некоторых пользователей это может раздражать. В частности, если пользователь пытается использовать YouTube в качестве замены музыкального проигрывателя.[13]

В целом API YouTube помогает пользователю с определенными фрагментами кода. Если фрагмент кода уже присутствует, каждому пользователю не нужно воссоздавать этот код, поскольку он был предоставлен самим YouTube.[14]

Смотрите также

Рекомендации

  1. ^ «Ресурсы API». YouTube API. Получено 7 октября 2014.
  2. ^ «Игроки и API игроков». Получено 28 ноября 2014.
  3. ^ Фрэнсис, Уильям. «Использование API Google в ваших приложениях для Android». TechRepublic Великобритания. Получено 24 октября 2014.
  4. ^ «YouTube Direct Lite для iOS». GitHub. GitHub Inc. Получено 24 октября 2014.
  5. ^ «API данных и аналитики». Получено 28 ноября 2014.
  6. ^ «Кнопки, виджеты и инструменты». Получено 28 ноября 2014.
  7. ^ «Получение простого ключа API для использования с API YouTube». ZixMp4. Разработчики Google. Получено 25 октября 2014.
  8. ^ Литт, Майкл. «Как получить выгоду от использования YouTube». Видъярд. Видъярд. Получено 24 октября 2014.
  9. ^ Вагнер, Джанет. «Возрастающая важность API в веб-разработке». Тут +. Тут +. Получено 24 октября 2014.
  10. ^ Арно, Кристиан. «Преимущества API социальных сетей». Журнал поисковой системы. Журнал поисковой системы. Получено 27 октября 2014.
  11. ^ "Первый раз с помощью APi YouTube". Получено 2007-03-17.
  12. ^ «Какие преимущества или недостатки, если я использую youtube-API или представляю видео в веб-просмотре». Переполнение стека. Переполнение стека. Получено 24 октября 2014.
  13. ^ bh6712121. «Почему Steam Music не заменяет мой музыкальный проигрыватель». YouTube. bh6712121. Получено 25 октября 2014.
  14. ^ Очиститель, HTML. «Встраивание видео с YouTube». Очиститель HTML. Очиститель HTML. Получено 27 октября 2014.

внешняя ссылка