Code erreur 2 YouTube : paramètre non valide, que faire ?

Bénin

Le code erreur 2 dans YouTube correspond à une valeur de paramètre non valide transmise au lecteur vidéo intégré. Ce code apparaît principalement lorsqu'une vidéo est intégrée dans un site web avec un identifiant de vidéo malformé ou une URL d'intégration incorrecte.

Que signifie le code 2 ?

Le code 2 est un code d'erreur du lecteur YouTube intégré (YouTube IFrame Player API). Selon la documentation officielle de Google, il signifie que la requête contient une valeur de paramètre non valide. Ce code apparaît notamment lorsque l'identifiant de vidéo (videoId) ne comporte pas exactement 11 caractères, contient des caractères spéciaux (!, *, espaces) ou est autrement malformé. Les utilisateurs le voient sous forme du message «Cette vidéo n'est pas disponible. Code d'erreur : 2».

Causes probables

  • Identifiant de vidéo YouTube (videoId) malformé ou ne comportant pas exactement 11 caractères.
  • Caractères spéciaux (!, *, espaces) présents dans l'identifiant de vidéo.
  • Vidéo intégrée via URL directe plutôt que via le code d'intégration officiel fourni par YouTube.
  • Paramètre null ou vide transmis au lecteur intégré lors du chargement de la page.

Comment résoudre le code 2

  1. Pour un utilisateur voyant l'erreur sur un site web. Le problème vient du site web qui intègre la vidéo, pas de votre appareil ni de votre connexion. Recharger la page ou effacer le cache ne résoudra pas l'erreur. Signalez le problème au propriétaire ou à l'administrateur du site.
  2. Pour un développeur : vérifier le videoId. Vérifiez que le videoId dans l'URL d'intégration comporte exactement 11 caractères alphanumériques et ne contient aucun caractère spécial. Comparez l'identifiant avec celui visible dans l'URL de la vidéo sur youtube.com.
  3. Utiliser le code d'intégration officiel YouTube. Sur YouTube.com, ouvrez la vidéo souhaitée, cliquez sur «Partager», puis sur «Intégrer». Copiez le code iframe généré par YouTube et utilisez-le tel quel dans votre page. Ce code garantit un videoId valide.

Quand faire appel à un professionnel

Le code 2 YouTube n'est pas une erreur matérielle : c'est une erreur de configuration dans la façon dont la vidéo est intégrée dans une page web. Si vous êtes utilisateur, signalez l'erreur au propriétaire du site. Si vous êtes développeur et que l'erreur persiste malgré un videoId valide, consultez la documentation officielle de l'API YouTube IFrame.

Questions fréquentes

Le code 2 YouTube signifie-t-il que la vidéo a été supprimée ?
Non. Une vidéo supprimée ou rendue privée affiche le code 100. Le code 2 indique un problème de paramètre non valide dans l'intégration, pas l'absence de la vidéo.
Le code 2 peut-il apparaître uniquement sur mobile ?
Oui. Certaines implémentations fonctionnent sur navigateur de bureau mais échouent sur mobile car le WebView traite différemment certains paramètres. Un videoId ou une URL incorrectement formée peut déclencher le code 2 sur mobile uniquement.
Quels sont les autres codes erreur courants du lecteur YouTube ?
Les codes de l'API YouTube IFrame incluent : 2 (paramètre non valide), 5 (erreur du lecteur HTML5), 100 (vidéo introuvable ou privée), 101 et 150 (intégration non autorisée par le propriétaire).

Autres codes YouTube

4Code d'erreur 4 YouTube : vidéo non disponible, causes et solutions 0Code d'erreur 0 YouTube : vidéo non disponible, causes et solutions 2-ARVHA-0000Code erreur 2-ARVHA-0000 YouTube Nintendo Switch : solution officielle Nintendo

Source : Documentation YouTube IFrame Player API : Error Codes · relevé le 12/07/2026.