Obtener una clave de YouTube

El chat de YouTube en Astral Overlay requiere tu propia clave de YouTube Data API v3. Los paneles de Twitch no necesitan esta configuración.

1. Abrir Google Cloud

Abre la consola de Google Cloud e inicia sesión con tu cuenta de Google. Usa el selector de proyectos superior para crear un proyecto o elegir uno que ya utilices para esta integración.

Un nombre como Astral Overlay Chat ayuda a reconocerlo. Mantén seleccionado ese proyecto durante los pasos siguientes.

2. Activar YouTube Data API v3

Abre la página de YouTube Data API v3 en la biblioteca de APIs y elige Habilitar.

Si ya está habilitada, continúa a la página de credenciales. Habilitar otra API relacionada con YouTube no sustituye este paso.

3. Crear una clave API

Abre APIs y servicios > Credenciales y elige Crear credenciales > Clave de API.

Selecciona YouTube Data API v3 si el diálogo pregunta a qué API puede acceder la clave. Copia la clave y dale un nombre reconocible.

Elige una clave API, no un ID de cliente OAuth ni credenciales de cuenta de servicio. La configuración actual de Astral Overlay acepta la cadena de la clave.

Consulta las instrucciones de credenciales de YouTube de Google si cambia la distribución de la consola.

4. Establecer restricciones compatibles

Abre los ajustes de la clave en Credenciales:

En Restricciones de API, elige Restringir clave y selecciona solo YouTube Data API v3.
En Restricciones de aplicaciones, Ninguna es la opción práctica para el cliente Windows actual, salvo que mantengas una restricción por IP externa.
Guarda los ajustes.

Astral Overlay realiza peticiones directamente desde tu ordenador. Una restricción de Sitios web, incluso para esta documentación, no corresponde a ese cliente. Las restricciones de Android e iOS tampoco son adecuadas.

Para limitar más el acceso, una restricción de Direcciones IP puede permitir la IP pública de Internet de tu ordenador. Debe actualizarse si cambia tu conexión o VPN. No introduzcas 127.0.0.1 ni una dirección privada de tu red doméstica.

Dejar las restricciones de aplicación en Ninguna significa que la clave no queda vinculada a un ordenador concreto. Mantén la restricción API exclusiva para YouTube y guarda la clave en privado. La referencia de restricciones de Google explica las opciones.

5. Pegarla en Astral Overlay

Abre Pantallas > Añadir chat y elige YouTube.
Pega el enlace del vídeo en directo en el campo de vídeo.
Pega la clave en el campo de clave API.
Añade el panel de chat.

Usa la URL del vídeo en directo, no la página del canal. Astral Overlay oculta la clave en la interfaz y guarda una nueva clave al añadir el chat. La tarjeta también permite olvidar una clave guardada.

Si no conecta

Mensaje o síntoma	Qué comprobar
API no habilitada	Habilita YouTube Data API v3 en el proyecto propietario de la clave.
Clave no válida	Copia otra vez la clave API; no pegues un ID de cliente o de proyecto.
Las restricciones bloquean la aplicación	Revisa la restricción de la API de YouTube y si las restricciones web o de IP externa rechazan este ordenador.
Cuota agotada	Revisa las cuotas API del proyecto. Crear otra clave en el mismo proyecto no renueva su cuota.
Sin chat en directo	Comprueba que el vídeo está en directo y que su chat está disponible.

Las peticiones de YouTube consumen la cuota del proyecto. La documentación de cuotas de Google explica los costes y el reinicio diario; consulta la consola para ver la asignación real de tu proyecto.

No publiques la clave en capturas, código fuente ni solicitudes de ayuda. Si se expone, sustitúyela en Google Cloud y actualízala en Astral Overlay.

Volver al chat de Twitch y YouTube.