Error 153 al insertar un video de YouTube: por qué pasa y cómo arreglarlo
El error 153 aparece cuando el reproductor de YouTube no sabe qué sitio lo insertó porque falta el header Referer. El arreglo para sitios web, WebViews y apps.
Insertás un video de YouTube, el reproductor carga y, en lugar del video, aparece un recuadro negro con el error 153 («Video player configuration error», o su traducción), muchas veces con un link para mirarlo en YouTube. El video está bien y el código de inserción también. Lo que falta es un dato: quién lo está insertando.
La causa: el reproductor no sabe qué sitio lo insertó
Las condiciones para desarrolladores de YouTube son explícitas. Su página
Required
Minimum Functionality dice que todo lo que use el reproductor insertado, incluida la IFrame
Player API, tiene que identificarse con el header HTTP Referer. Los
navegadores lo mandan solos; la página pide no usar ajustes que lo supriman y recomienda la
política strict-origin-when-cross-origin.
Cuando el reproductor carga sin Referer, o con uno que no identifica un sitio, se
niega a reproducir y muestra el error 153. Quienes lo depuraron, como
Simon Willison,
llegaron justo a eso. La página de Google no menciona el número 153, pero el arreglo que describe
es el que hace desaparecer el error.
Qué le saca el Referer a un sitio web
- Un header
Referrer-Policyenno-referrerosame-origin. Algunos frameworks y configuraciones de seguridad lo agregan por defecto; en el caso de Willison era elSecurityMiddlewarede Django, que mandasame-origin. - Una meta etiqueta en el head de la página:
<meta name="referrer" content="no-referrer">. - Un atributo
referrerpolicyen el propio iframe, que a veces agrega un plugin de inserción. -
noreferreren una ventana que abrís para alojar el reproductor, algo que la página de YouTube pide no usar.
El arreglo en un sitio web
Mandá la política que recomienda YouTube, como header:
Referrer-Policy: strict-origin-when-cross-origin o como meta etiqueta, si no podés tocar los headers:
<meta name="referrer" content="strict-origin-when-cross-origin">
Después fijate que nada más específico la pise: sacá el atributo referrerpolicy
del iframe, o ponele el mismo valor. Esa política les manda a otros sitios sólo tu origen (por
ejemplo https://example.com), nunca la ruta completa, así que no perdés privacidad
que importe. Willison también probó cambiar la inserción a youtube-nocookie.com y
le sirvió sólo a veces; lo que lo resolvió fue corregir la política.
El arreglo dentro de una app (WebView, Electron, Tauri)
Las apps se lo cruzan más seguido, porque sus páginas no vienen de un sitio web. Una página
cargada desde un archivo local o un esquema propio (file://, app://,
tauri://localhost) no tiene un origen web para mandar, así que el reproductor no
recibe un Referer que le sirva. La página de YouTube dice qué hacer en cada caso:
- WebView móvil que carga HTML local: definí el parámetro
baseUrl, que fija elReferer. -
SFSafariViewControlleren iOS: no permite fijar elReferer, así que usá el parámetroorigindel reproductor. - Apps de escritorio: agregá el
Referercomo header HTTP en el pedido, o configurá el WebView para que lo mande.
Una última opción, cuando no controlás los headers del WebView: alojá una página mínima en un
dominio https tuyo que inserte el reproductor, y mostrá esa página dentro de
tu app. Así el reproductor ve tu dominio como el que lo insertó.
Cómo nos pasó a nosotros
Hacemos Webstarted Toolbox, una app de barra de menú hecha con
Tauri, y su widget Media reproduce videos de YouTube. Su interfaz corre en
tauri://localhost, que no es un origen web válido, así que un iframe directo a
youtube.com/embed fallaba con el error 153 siempre. Lo resolvimos con la última
opción: el widget muestra una página chica que alojamos en nuestro propio dominio
https, que manda un Referer correcto e inserta el reproductor. El video
sigue viajando directo de Google a quien lo mira; por nuestro servidor pasa sólo esa página.
Si sólo querés ver el video
El error es del sitio o la app que insertó el video, no tuyo. El link para verlo en YouTube lo
reproduce en youtube.com. Una excepción para revisar: una extensión o un ajuste de privacidad del
navegador que saca el Referer de todos los pedidos elimina ese mismo header, y puede
provocar el error 153 en sitios bien configurados.
Fuentes
- YouTube API Services: Required Minimum Functionality (Google for Developers, en inglés).
- Error 153 Video player configuration error on YouTube embeds (Simon Willison, en inglés).
- Referrer-Policy (MDN).