Qu’est-ce qu’un code d’intégration ?

Un code d’integration est un court fragment HTML qu’un propriétaire de site colle dans une page pour qu’une vidéo YouTube s’y lise directement, au lieu d’être accessible uniquement via un lien. YouTube le génère sous la forme d’un élément <iframe> qui pointe vers une URL /embed/ spéciale de la vidéo.

Ce que contient un code d’intégration

Au minimum, il contient une URL source avec l’ID de la vidéo, une largeur et une hauteur (ou à la place un conteneur responsive) et un attribut title pour l’accessibilité. Des paramètres optionnels contrôlent la lecture automatique, l’heure de départ, la visibilité des contrôles et plus encore.

Comment en obtenir un

Vous pouvez copier la version proposée par YouTube dans le panneau Partager sous une vidéo, ou utiliser le générateur de code d’intégration de ce site pour ajouter un formatage responsive, un mode confidentialité, des horaires de départ et d’autres options que le panneau standard de YouTube ne propose pas toutes ensemble.

Comment un code d’intégration est construit

Un code d’intégration n’est pas une chaîne fixe, il est assemblé à partir de quelques éléments interchangeables. Le domaine (youtube.com ou la version respectueuse de la vie privée youtube-nocookie.com) détermine le comportement des cookies. Le chemin porte soit un identifiant de vidéo unique, soit, pour une playlist, le chemin videoseries avec un paramètre list. Les paramètres de requête comme start, autoplay et controls se placent après un point d’interrogation et modifient la lecture. Enfin, le balisage environnant, attributs width/height fixes ou div conteneur responsive, détermine comment le lecteur s’affiche sur la page. Comprendre ces éléments séparables facilite grandement la lecture, et la modification manuelle, d’un code d’intégration que vous n’avez pas généré vous-même.

Un exemple concret

Supposons que vous souhaitiez afficher une démonstration produit sur une page d’atterrissage, respectueuse de la vie privée, démarrant après 15 secondes pour passer une introduction, sans lecture automatique. Le code d’intégration obtenu combine un domaine youtube-nocookie.com, un paramètre start=15 et un conteneur responsive :

<div style="position:relative;width:100%;padding-bottom:56.25%;height:0;overflow:hidden;">
  <iframe src="https://www.youtube-nocookie.com/embed/VIDEO_ID?start=15" style="position:absolute;top:0;left:0;width:100%;height:100%;border:0;" title="Démonstration produit" allowfullscreen loading="lazy"></iframe>
</div>

Chaque élément de ce fragment correspond à un choix précis : le domaine pour la confidentialité, start=15 pour passer l’introduction, et le conteneur pour le formatage responsive.

Code d’intégration contre simple lien

Il vaut la peine de clarifier ce qu’un code d’intégration n’est pas. Un lien YouTube ordinaire (une URL watch ou youtu.be) est destiné à être partagé et cliqué ; collé en texte brut sur une page, il reste simplement une URL, ou se transforme automatiquement en intégration sur des plateformes comme WordPress qui prennent en charge oEmbed. Un code d’intégration, en revanche, est du HTML explicite que vous contrôlez directement, offrant des options de taille, de confidentialité et de lecture qu’un simple lien n’expose pas. Les notions connexes à connaître sont l’élément iframe dont dépend le code et la distinction entre l’URL d’intégration et l’URL de visionnage.

Questions fréquentes