Настройка и особенности провайдера YouTube

Документ актуален для InstantVideo любой версии
Настройка и особенности провайдера YouTube

Провайдер YouTube в движке может:

  • Конвертировать и хранить на своих серверах;
  • Парсить видео по критериям — по поисковому запросу, из канала пользователя и из плейлистов.

Настройка провайдера для конвертации и хранения

Провайдер может работать в двух режимах: простой парсинг видео и конвертация/хранение/воспроизведение. Работа провайдера YouTube основана на API V3.

Для обоих типов работы необходимы следующие действия:

  1. Перейдите в консоль разработчика Google;
  2. Выберите существующий или создайте новый проект;
  3. Убедитесь, что API данных YouTube V3 включен;
  4. В боковой панели слева, выберите учетные данные.

Для работы простого парсинга видео необходимо:

  1. Необходимо получить только API key. Для этого в блоке "Учетные данные" нажмите "Создать учетные данные " и в появившемся меню нажмите "Ключ API".
  2. Ключ создан. Появится блок Ключ создан. Из него нужно скопировать поле Ваш ключ API и вставить в соответствующее поле формы настроек провайдера YouTube в админке.
  3. Созданный ключ появится в списке ключей ниже. Его можно отредактировать, где можно ограничения, такие как ip адрес вашего сервера или же подсеть, откуда будут приходить запросы.

Для конвертации и хранения на YouTube необходимо:

  1. Необходимо получить Client ID и Client secret. Для этого в блоке "Учетные данные" нажмите "Создать учетные данные " и в появившемся меню нажмите "Идентификатор клиента OAuth";
  2. Выберите тип приложения "Веб-приложение" и нажмите "Создать";
  3. У вас появится блок Клиент OAuth. Из него в соответствующие поля формы настроек провайдера YouTube вам нужно будет скопировать Client ID (Ваш идентификатор клиента) и Client secret (Ваш секрет клиента);
  4. После того, как вы в форме настроек провайдера YouTube, заполнили поля из п.3 вам необходимо сохранить эти настройки, после чего заново открыть их и получить токен доступа (для InstantVideo 1.X) или нажать на ссылку "Получить токен доступа" (для InstantVideo2);
  5. На сайте youtube.com создайте канал.

Теперь вы настроили интеграцию с YouTube и нужно проверить работоспособность. Для этого, в админке перейдите в раздел "Массовый импорт" (для InstantVideo 1.X) или выберите добавление массовым импортом на сайте (для InstantVideo 2.X) или же просто на сайте попробуйте импортировать ролик по ссылке с YouTube.

Если импорт прошел успешно, то на этом настройка завершена. Если возникли ошибки при импорте, то необходимо перейти в админку - компоненты - видео каталог и нажать на иконку списка логов (или нажать на меню "Логи" для InstantVideo2). В большинстве случаев там будет текст ошибки. Нужно внимательно прочитать этот текст, при необходимости перевести на русский, чтобы вам было понятнее.

Расшифровка опций настроек провайдера YouTube

  • "В какую категорию Youtube загружать ролики" — к этой категории будут привязаны ролики, которые вы будете загружать на YouTube. Актуальна, если вы используете конвертацию и хранение роликов на их серверах;
  • "Доступ ролика на YouTube" — можно указать либо доступ по ссылке, либо открытый. В первом случае ролик не будет виден в общем списке канала. так же опция актуальна, если вы используете конвертацию и хранение роликов на серверах YouTube;
  • "Какой плеер использовать для воспроизведения роликов youtube" — эта опция обусловлена тем, что в "своих плеерах", зачастую не будут засчитываться просмотры на youtube.com. Однако, например в плеере Uppod есть возможность в настройках стилей включить опцию, чтобы просмотры считались;
  • "Скрывать лого youtube в плеере" — При скрытии лого, просмотры ролика на youtube не учитываются. Работает только для плеера youtube. Лого скроется на панели плеера, при полноэкранном режиме справа внизу лого будет всегда;
  • "Выполнять запросы от имени посетителя" — в каждый запрос к api будет вместо серверного ip подставляться ip посетителя сайта, полезно для уменьшения квот. Обратите внимание, что если эта опция включена, то в консоли Google ограничение по ip должно отсутствовать;
  • "Синхронизировать с аккаунтом" — актуальна при конвертации и хранении на YouTube. Редактирование данных ролика (название, описание и теги) будет так же отражаться на соответствующем ролика на youtube.com. Кроме этого, если вы удалите ролик со своего сайта, он так же удалится на YouTube.

Скрыть логотип YouTube при воспроизведении в своих плеерах можно только настройкой скинов плеера, например в Uppod можно сделать нижнюю панель плеера больше и она перекроет логотип, однако в полноэкранном режиме логотип будет все равно виден. Так же можно уменьшить "навязчивость" логотипа YouTube, выбрав в проигрывание в плеере YouTube и не выключив опцию " Скрывать лого youtube в плеере". В этом случае в нижней панели логотип будет виден, а при полноэкранном режиме не будет. Автоскрытие панели управления плеером сведет на нет для пользователя напоминание о YouTube.

Видео настройки YouTube Data API