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

Встроен в strAImer: модуль ставится вместе с приложением, скачивать ничего не нужно. Он есть в списке Каталог модулей → Встроенные.

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

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

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

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

Аккаунт бота

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

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

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

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

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

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

Вход бота — не экономия, а условие: без него приложение на YouTube молчит. Это стоит прочитать дважды. Таймеры, ответы команд и ИИ-агент — это автоматические сообщения, а автоматическое сообщение без входа бота не отправляется вовсе: причина уходит в консоль логов и больше никуда. Исключение — ваши собственные сообщения, набранные руками в тайле чата: они уходят независимо от того, настроен бот или нет, лишь бы шёл эфир.

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

Обоим случаям нужен идущий эфир. Когда ничего не транслируется, писать некуда, и сообщение отклоняется именно по этой причине.

Если страница пишет «Google отклонил ключи приложения»

Этот красный значок не то же самое, что истёкший вход: Google больше не принимает ключи, с которыми входит само приложение, и повторный вход не помогает. Страница объясняет это с кодом: «Google больше не принимает ключи, с которыми strAImer входит в аккаунт (код: {code}). Пока strAImer не обновлён, повторный вход не поможет: обновите его и войдите заново. Если версия уже последняя, напишите нам: Помощь и обратная связь → Написать разработчику.» Значит, обновите приложение и нажмите «Авторизовать через браузер»; если версия уже последняя, напишите через «Помощь и обратная связь → Написать разработчику» и приведите код.

До тех пор открытая трансляция по-прежнему находится и её чат читается, если приложение уже знает ваш канал. Не работают отправка от вашего имени, трансляции, доступные только по ссылке, и модерация не через бота.

Суперчаты, стикеры и спонсорства

Они приходят только во время идущего эфира, из чата, который читает модуль.

• Суперчаты и суперстикеры приходят донатами, в той валюте, которой заплатил зритель, и пересчитываются в базовую валюту как любой другой донат. В списках, где выбирают, какие донаты учитывать, например «Учитывать донаты» у сбора средств, они значатся источником YouTube Super Chat: если сбор не видит суперчаты, проверьте, что этот источник там отмечен.
• Если приложение не распознало валюту, написанную в суперчате, сумма приходит с неизвестной валютой, в консоли логов появляется строка «Superchat currency not recognised», а сбор средств не может её пересчитать, поэтому шкала от неё не двигается.
• Спонсорства, в том числе подаренные, приходят подписками, а не донатами, поэтому денежную цель они не двигают.

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

• Вставить токен, ключ доступа или ключ обновления некуда. «Авторизовать через браузер» — единственный вход, ею же обновляется и просроченный.
• В поле «Имя аккаунта (логин)» ничего не вписать. Чтобы подключить другой канал, войдите под аккаунтом, которому он принадлежит.
• Списка прав по функциям на странице нет — YouTube выдаёт свой набор при входе, а страница сообщает только, подключён аккаунт или нет.
• Ключи приложения, которые отклонил Google, на этой странице не заменить: полей для них нет.
• Полей Google Client ID и Google Client Secret здесь нет — как говорит сам модуль, «вход пройдёт через само приложение strAImer, ключи не нужны».
• Кнопки сохранения на странице нет: всё записывается по итогу входа в браузере.
• Выбрать трансляцию здесь нельзя, и ничто на странице её не начинает. Поля для адреса эфира или ссылки на видео тут тоже нет.
• Страница не отключает аккаунт и не удаляет подключение, а также не выключает модуль.
• Канал и аккаунт бота настраиваются порознь: один вход не заполняет другой, и окна у них разные — канал входит через браузер, бот внутри приложения.
• Канал бота нельзя вписать руками. Он выбирается из списка, который показывает окно входа, и в списке только каналы того аккаунта, под которым вы вошли.
• Ничто на странице не предупредит, что автоматические сообщения отклоняются. Значок канала остаётся зелёным: он сообщает о подключении канала, а не бота. Почему YouTube замолчал, написано только в консоли логов.