Erreur 153 sur une vidéo YouTube intégrée : pourquoi et comment la corriger
L'erreur 153 apparaît quand le lecteur YouTube ne sait pas quel site l'a intégré, faute d'en-tête Referer. La correction pour les sites, les WebView et les apps.
Vous intégrez une vidéo YouTube, le lecteur se charge et, à la place de la vidéo, vous obtenez un cadre noir avec « Error 153. Video player configuration error » (erreur 153, erreur de configuration du lecteur vidéo), souvent avec un lien « Regarder sur YouTube ». La vidéo va bien, le code d'intégration aussi. Ce qui manque, c'est l'information sur qui intègre la vidéo.
La cause : le lecteur ne sait pas quel site l'a intégré
Les conditions de YouTube pour les développeurs sont claires. Leur page
Required
Minimum Functionality indique que tout ce qui utilise le lecteur intégré, y compris l'API IFrame Player, doit
s'identifier via l'en-tête HTTP Referer. Les navigateurs l'envoient normalement d'eux-mêmes ; la page
demande de ne pas utiliser de réglages qui le suppriment et recommande la politique de référent
strict-origin-when-cross-origin.
Quand le lecteur se charge sans Referer, ou avec un Referer qui n'identifie pas de site, il
refuse de lire la vidéo et affiche l'erreur 153. Les développeurs qui l'ont déboguée, comme
Simon Willison, sont remontés
exactement là. La page de Google ne mentionne pas le numéro 153, mais la correction qu'elle décrit est celle qui fait
disparaître l'erreur.
Ce qui supprime le Referer sur un site
- Un en-tête
Referrer-Policyréglé surno-referrerousame-origin. Certains frameworks et configurations de sécurité en ajoutent un par défaut ; chez Willison, c'était leSecurityMiddlewarede Django, qui envoiesame-origin. - Une balise meta dans le
<head>de la page :<meta name="referrer" content="no-referrer">. - Un attribut
referrerpolicysur l'iframe elle-même, parfois ajouté par une extension d'intégration. -
noreferrersur une fenêtre ouverte pour héberger le lecteur, ce que la page de YouTube déconseille.
La correction sur un site
Envoyez la politique recommandée par YouTube, en en-tête :
Referrer-Policy: strict-origin-when-cross-origin ou en balise meta, si vous ne pouvez pas modifier les en-têtes :
<meta name="referrer" content="strict-origin-when-cross-origin">
Vérifiez ensuite que rien de plus spécifique ne la remplace : retirez l'attribut referrerpolicy de
l'iframe, ou donnez-lui la même valeur. Cette politique n'envoie que votre origine (par exemple
https://exemple.fr) aux autres sites, jamais le chemin complet : vous ne sacrifiez rien d'important côté
confidentialité. Willison a aussi constaté que passer l'intégration sur youtube-nocookie.com n'aidait que
parfois ; c'est la correction de la politique qui a réglé le problème.
La correction dans une app (WebView, Electron, Tauri)
Les apps y sont plus exposées, car leurs pages ne viennent pas d'un site web. Une page chargée depuis un fichier local
ou un schéma personnalisé (file://, app://, tauri://localhost) n'a pas d'origine
web à envoyer : le lecteur ne reçoit aucun Referer exploitable. La page de YouTube donne la marche à suivre
par plateforme :
- WebView mobile qui charge du HTML local : définissez le paramètre
baseUrl, qui fixe leReferer. -
SFSafariViewControllersur iOS : il ne peut pas définir deReferer, utilisez plutôt le paramètreorigindu lecteur. - Apps de bureau : ajoutez le
Referercomme en-tête HTTP de la requête, ou configurez la WebView pour qu'elle en envoie un.
Dernière option, quand vous ne contrôlez pas les en-têtes de la WebView : hébergez sur un vrai domaine https
qui vous appartient une petite page qui intègre le lecteur, et affichez cette page dans votre app. Le lecteur voit
alors votre domaine comme l'intégrateur.
Comment nous sommes tombés dessus
Nous développons Webstarted Toolbox, une app de barre des menus construite avec Tauri, et son
widget Media lit des vidéos YouTube. Son interface tourne sur tauri://localhost, qui n'est pas une origine
web valide : une iframe youtube.com/embed directe échouait avec l'erreur 153 à chaque fois. Nous avons
corrigé avec la dernière option : le widget affiche une petite page hébergée sur notre propre domaine https,
qui envoie un Referer correct et intègre le lecteur. La vidéo elle-même est diffusée directement de Google
vers la personne qui regarde ; seule cette petite page passe par notre serveur.
Si vous voulez juste regarder la vidéo
L'erreur vient du site ou de l'app qui a intégré la vidéo, pas de chez vous. Le lien « Regarder sur YouTube » la lit
sur youtube.com. Une exception à vérifier : une extension de navigateur ou un réglage de confidentialité qui supprime le
Referer de toutes les requêtes enlève ce même en-tête, et peut provoquer l'erreur 153 sur des sites bien configurés.
Sources
- YouTube API Services: Required Minimum Functionality (Google for Developers, en anglais).
- Error 153 Video player configuration error on YouTube embeds (Simon Willison, en anglais).
- Referrer-Policy (MDN).