YouTube · Руководство по настройке
Как создать ключ данных YouTube API
StreamBruh использует ваш ключ YouTube Data API v3 для общедоступного поиска видео и проверки загрузки канала. Облачные квоты Google и ограничения ключей API могут повлиять на эти запланированные проверки.
Пошаговая настройка
Создайте или выберите облачный проект Google.
Войдите в Google Cloud Console с учетной записью Google. Создайте проект для этих уведомлений или выберите проект, которым вы управляете. Убедитесь, что предполагаемый проект активен в заголовке консоли.
Включить YouTube Data API v3
В APIs & Services → Library найдите YouTube Data API v3 и включите его для этого проекта. Создание ключа само по себе не активирует API.
Создайте ключ API.
Откройте APIs & Services → Учетные данные, выберите Создать учетные данные → Ключ API и скопируйте сгенерированный ключ. Ограничьте доступ API к YouTube Data API v3. Держите ключ подальше от общедоступных страниц и системы контроля версий.
StreamBruh вызывает Google со своего сервера, а не из браузера посетителя. Ограничение веб-сайта или реферера HTTP заблокирует эти запросы к серверу. Если поддержка StreamBruh подтверждает стабильный общедоступный исходящий IP-адрес для VPS, вы можете дополнительно ограничить ключ этим IP-адресом; в противном случае сохраните ограничение YouTube API и отслеживайте использование.
Сохраните ключ в StreamBruh.
Откройте «Бот и интеграции», вставьте ключ в YouTube API Key и сохраните. Сохраненный ключ маскируется. Оставьте поле пустым при последующих изменениях, если вы хотите сохранить существующий ключ.
Выберите поисковые запросы или каналы
Уведомление о поиске YouTube следует за новыми общедоступными видео, соответствующими поисковому запросу; его языковая настройка является предпочтением релевантности, а не гарантией, а заблокированные слова, разделенные запятыми, исключают заголовки, содержащие эти термины. Уведомление о канале принимает ссылку YouTube @handle, ссылку на идентификатор канала, дескриптор или идентификатор канала, поддерживаемые формой.
Выберите канал назначения Discord, настройте сообщение и сохраните. Проверки проводятся по графику. Поисковые запросы и проверки каналов используют квоту YouTube API с разной скоростью; результаты также зависят от доступности YouTube.
Проверьте настройки
- YouTube Data API v3 включен в том же проекте, что и ключ.
- Ограничение ключа API включает YouTube Data API v3, а его клиентское ограничение разрешает VPS.
- Ссылка на канал разрешается или конфигурация поиска сохраняется, и бот может отправлять сообщения на выбранный канал Discord.
Устранение неполадок
Ключ API отклонен
Подтвердите, что ключ принадлежит выбранному проекту, YouTube Data API v3 включен, а его ограничения разрешают запросы с VPS. Ограничения реферера браузера не соответствуют вызовам на стороне сервера.
Квота исчерпана
Просмотрите использование и квоту данных YouTube API в Google Cloud Console. Сократите количество ненужных поисков или запросите продление квоты через Google, если это соответствует критериям; повторите попытку после того, как квота станет доступной.
Видео не опубликовано
Проверьте, соответствует ли новое общедоступное видео запросу или каналу с момента последней проверки, исключают ли заблокированные слова его заголовок и остается ли канал Discord доступным для отправки. Плановые проверки не происходят мгновенно.