Получение ключа YouTube API

Чату YouTube в Astral Overlay нужен ваш собственный ключ YouTube Data API v3. Для панели Twitch эта настройка не нужна.

1. Откройте Google Cloud

Откройте Google Cloud Console и войдите в аккаунт Google. Создайте проект через верхний переключатель проектов или выберите уже используемый для этой интеграции.

Имя вроде Astral Overlay Chat поможет узнать проект позже. Он должен оставаться выбранным на следующих шагах.

2. Включите YouTube Data API v3

Откройте страницу YouTube Data API v3 в библиотеке API и нажмите Enable.

Если API уже включён, переходите к учётным данным. Включение другого API, связанного с YouTube, не заменяет этот шаг.

3. Создайте ключ API

Откройте APIs & Services > Credentials, затем Create credentials > API key.

Выберите YouTube Data API v3, если диалог спрашивает, к какому API разрешён доступ. Скопируйте ключ и дайте ему узнаваемое имя.

Нужен именно ключ API, а не идентификатор клиента OAuth или учётные данные сервисного аккаунта. Текущая настройка чата принимает строку ключа.

Если интерфейс консоли отличается, прочитайте инструкции Google по учётным данным YouTube.

4. Установите совместимые ограничения

Откройте настройки ключа на странице Credentials:

В API restrictions выберите Restrict key и только YouTube Data API v3.
В Application restrictions значение None подходит текущему клиенту Windows, если вы не поддерживаете ограничение по внешнему IP.
Сохраните настройки.

Astral Overlay отправляет запросы прямо с вашего компьютера. Ограничение Websites, даже для этого сайта документации, не подходит. Ограничения Android и iOS также не подходят.

Для более строгого доступа можно разрешить публичный IP компьютера через IP addresses. Его нужно обновлять при изменении подключения или VPN. Не вводите 127.0.0.1 или частный адрес домашней сети.

Значение None означает, что ключ не привязан к определённому компьютеру. Сохраните ограничение API только на YouTube и держите ключ в секрете. В справке Google об ограничениях описаны варианты.

5. Вставьте ключ в Astral Overlay

Откройте Экраны > Добавить чат и выберите YouTube.
Вставьте ссылку на видео трансляции в поле видео.
Вставьте ключ в поле ключа API.
Добавьте панель чата.

Используйте URL видео трансляции, а не страницу канала. Astral Overlay скрывает ключ и сохраняет новый ключ при добавлении чата. В карточке также можно забыть сохранённый ключ.

Если подключение не удаётся

Сообщение или симптом	Что проверить
API не включён	Включите YouTube Data API v3 в проекте, которому принадлежит ключ.
Неверный ключ	Скопируйте ключ снова; не вставляйте ID клиента или проекта.
Ограничения блокируют приложение	Проверьте ограничение на API YouTube и не отклоняют ли этот компьютер ограничения сайта или внешнего IP.
Квота исчерпана	Посмотрите квоты API проекта. Создание нового ключа в том же проекте не обновляет квоту проекта.
Нет чата трансляции	Убедитесь, что видео идёт в прямом эфире и чат доступен.

Запросы YouTube API расходуют квоту проекта. Документация Google о квотах объясняет стоимость запросов и ежедневный сброс; фактическую квоту смотрите в консоли.

Не публикуйте ключ на снимках экрана, в исходном коде или запросах поддержки. При утечке замените его в Google Cloud и обновите в Astral Overlay.

Вернуться к чатам Twitch и YouTube.