strAImer strAImer
Войти

YouTube — подключение канала

С чем сюда приходят

Что это за страница

Страница подключает канал YouTube к приложению — как сказано в её описании, «Настройте интеграцию с YouTube для получения сообщений чата и управления трансляциями». Видов у неё два: сам канал и отдельный аккаунт, с которого отвечает бот.

Как это настроить

  1. Откройте «Подключения → Каналы» и зайдите на страницу YouTube. В заголовке написано «Канал YouTube (Чтение событий, трансляция)».
  2. «Статус подключения» показывает, как обстоят дела: «Не подключено» или «Подключено как {username}», когда канал на месте. Подсказка рядом называет, что именно запрашивается: «Требуется авторизация для проверки активных трансляций и отправки сообщений в чат YouTube».
  3. Нажмите «Авторизовать через браузер». На странице одна кнопка и ни одного поля для токена — вход открывается в вашем обычном браузере и заканчивается там же.
  4. Войдите в аккаунт Google, которому принадлежит канал, и согласитесь с правами. Не снимайте ни одной галочки. Google перечисляет права по отдельности и разрешает снимать их поштучно, и снятая галочка — самая частая причина, по которой YouTube оказывается подключённым и молчащим: без права видеть ваши трансляции приложение не узнает, что вы в эфире, а чат, который оно не нашло, читать неоткуда. С 0.9.2 приложение такой вход отклоняет и говорит об этом прямо на той же странице; до неё подключение просто зеленело, и ничего не приходило. При успехе страница в браузере скажет «Авторизация успешна!» — «Аккаунт {username} успешно подключен к YouTube», а ниже: «Вы можете закрыть это окно. Оно закроется автоматически».
  5. Страница модуля сообщит «Конфигурация YouTube успешно сохранена!» и через мгновение закроется сама. В поле «Имя аккаунта (логин)» появится подключённый канал; поле только для чтения.
  6. Чат приходит вместе с трансляцией: модуль читает живой чат идущего эфира. Когда эфира нет, читать нечего. Открытый эфир подхватывается за минуту, скрытый может ждать до получаса: на странице канала его не видно, и приложение спрашивает о нём Google — редко, чтобы уложиться в общий для всех пользователей strAImer лимит запросов. Нажмите «Авторизовать через браузер», и эфир найдётся сразу.
  7. Если вход со временем перестал работать, откройте эту страницу и нажмите «Авторизовать через браузер» ещё раз — та же кнопка его и обновляет. Понять это можно по значку статуса: он снова показывает «Не подключено».
  8. Стрелка слева вверху, «Назад», уводит со страницы.

Аккаунт бота

Та же страница в разделе «Подключения → Боты» озаглавлена «Аккаунт Бота YouTube (Ответы в чат)», и устроена она иначе, чем страница канала выше: кнопка одна, а не две.

  1. Нажмите «Подключить бота». В приложении откроется окно: «войдите в аккаунт Google бота, затем выберите канал YouTube, от имени которого он пишет. Один аккаунт может содержать несколько каналов, и приложение не может определить, какой из них вы имеете в виду».
  2. Войдите под тем аккаунтом, с которого должен отвечать бот, а не под аккаунтом канала.
  3. Выберите канал на следующей странице. Именно его имя зрители увидят автором сообщений бота.

После подключения подпись кнопки меняется на «Войти снова или сменить канал», а строка под ней объясняет, зачем этот вход нужен: «Бот пишет так же, как браузер, поэтому его ответы и модерация не расходуют общий лимит запросов YouTube». Той же кнопкой бота переводят на другой канал того же аккаунта.

Сделайте бота модератором своего канала. Без этого YouTube откажет в банах, тайм-аутах и удалении сообщений, что бы ни делало приложение: модерация — право, которое выдаёт площадка, а не настройка здесь.

Если сохранённый вход перестал работать, страница скажет об этом: «Сохранённый вход перестал работать, поэтому бот не пишет. Нажмите кнопку, чтобы войти снова». Входы устаревают — это обычный способ обновить его.

Чего ждать, пока собственный путь бота ненадёжен. Если сообщение не удаётся отправить через вход бота, приложение его не теряет: оно уходит официальным путём от имени вашего канала. Зрители видят сообщение от вас, а не от бота. Это осознанная временная мера: молчание означало бы, что на YouTube замолкают и таймеры, и ответы на команды, и агент. Каждый такой случай приложение пишет предупреждением в лог, так что бот, вдруг заговоривший вашим именем, — признак того, что его вход пора обновить.

Чего здесь нельзя