Уведомления YouTube

Зачем это нужно

Оно ничего не теряет, если человек посмотрит его только вечером, и именно поэтому здесь выгоднее анонс, который выходит всегда, чем тот, который иногда удаётся. В итоге важна непрерывная дорожка: каждое видео твоего канала появляется в Discord, с названием, превью и кнопкой, ведущей прямо туда. Тот, кто пролистает канал позже, увидит работу нескольких месяцев подряд. Вручную такой ряд не складывается никогда, потому что рано или поздно одного не хватит, и эту дырку уже никто не заполнит.

Как это выглядит в жизни

Вписываешь ты канал YouTube, и надёжнее всего идентификатор, начинающийся с UC; сгодятся и @псевдоним, и адрес канала, бот разберёт оба сам. Дальше ты решаешь две вещи по отдельности: сообщать ли о новых видео и сообщать ли о трансляциях, у каждой свой целевой канал. Оставишь канал для трансляций пустым, и всё придёт в одно место. Сообщение твоё: свой заголовок, своё описание, нижняя строка, цвет и подстановки вроде {channel}, {video_title}, {url} и {publish_date}, причём дата выводится в формате выбранного языка сервера. Можно добавить две кнопки: одна открывает видео, другая открывает канал сразу с предложением подписаться. На самом первом проходе бот молча запоминает твоё свежее видео, чтобы полканала не вывалилось в Discord разом.

Команды этого модуля

• /social

Что можно настроить

• Канал YouTube
• Сообщать о новых видео
• Сообщать о трансляциях
• Discord-канал для новых видео
• Discord-канал для трансляций
• Упоминание роли
• Текст над встраиванием
• Заголовок эмбеда
• Описание эмбеда
• Подвал
• Цвет эмбеда
• Показывать миниатюру
• Большое превью (видео)
• Показывать отметку времени

На что обратить внимание

Одну вещь стоит сказать прямо, пока ты не начал удивляться: новые видео бот берёт из открытой ленты твоего канала, и больше ему для этого ничего не нужно. Трансляции он распознаёт только тогда, когда на стороне сервера сохранён ключ YouTube. Его ставит тот, кто держит установку, в панели поля для этого нет. Без ключа переключатель трансляций работает вхолостую, и /social status пишет ровно это. Второй подводный камень касается границы площадок: без Premium бот обслуживает лишь одну из двух. Если ты настроил Twitch и YouTube разом, побеждает Twitch, а YouTube молчит. Снаружи это выглядит как поломка, но граница проведена именно так. Что до указания канала: @псевдоним сначала нужно разобрать, и это может сорваться, если YouTube отдаст страницу иначе, чем ожидалось; идентификатор UC, напротив, держит всегда. Дважды, кстати, ничего не объявляется: эфир, который уже вышел как сообщение о трансляции, не вернётся потом как новое видео.

Как работает модуль

ID канала (UC…, самый надёжный вариант), @handle или URL канала. Бот автоматически определяет ID канала по handle.

Для надёжного определения трансляций нужен ключ YouTube API (вводится оператором на сервере). Уведомления о новых видео работают без ключа.

Пусто = тот же канал, что для новых видео.

Произвольный текст над эмбедом. Плейсхолдеры см. ниже.

Плейсхолдеры: {channel} {video_title} {title} {publish_date}

Настройка в три шага

1. Включи модуль «YouTube» в панели и впиши идентификатор канала (UC…), @псевдоним или адрес канала.
2. Реши, сообщать ли о новых видео, сообщать ли о трансляциях или об обоих сразу.
3. Выбери целевой канал для новых видео; канал для трансляций заполняй, только если он должен быть другим.
4. Настрой упоминание и оформление, затем разок выполни /social test → YouTube Video.

Частые вопросы

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

С Premium да, оба сразу. Без Premium бот обслуживает лишь одну площадку: если настроены обе, приоритет у Twitch, а YouTube молчит. Так что если одна сторона сообщает, а вторая никогда, дело в этом, а не в неверной настройке.

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

Кнопка «Подписаться на канал» ведёт на твой канал и сразу открывает там запрос на подписку. Она включается отдельно от кнопки на видео. Обе они обычные кнопки-ссылки: внутри Discord ничего не происходит, когда по ним нажимают.

Нужен ли мне ключ API YouTube?

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

Работают ли Twitch и YouTube одновременно?

С Premium да, оба сразу. Без Premium бот обслуживает лишь одну площадку: если настроены обе, приоритет у Twitch, а YouTube молчит. Так что если одна сторона сообщает, а вторая никогда, дело в этом, а не в неверной настройке.

Почему видео пришло только через несколько минут после загрузки?

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

Зачем вторая кнопка под сообщением?

Кнопка «Подписаться на канал» ведёт на твой канал и сразу открывает там запрос на подписку. Она включается отдельно от кнопки на видео. Обе они обычные кнопки-ссылки: внутри Discord ничего не происходит, когда по ним нажимают.