Les paramètres d’intégration YouTube sont les options de la chaîne de requête qui contrôlent précisément l’apparence et le comportement d’une vidéo intégrée. Ce guide passe en revue douze des plus utiles, un par un, avec un exemple concret pour chacun, afin que vous voyiez précisément ce que chacun modifie.
Comment les paramètres s’ajoutent à une URL d’intégration
Chaque paramètre est ajouté à l’URL d’intégration sous forme de paire clé-valeur, reliée par une esperluette : https://www.youtube-nocookie.com/embed/VIDEO_ID?param1=value1¶m2=value2. Vous pouvez en combiner autant que vous le souhaitez. Les paramètres de type booléen utilisent généralement 1 pour « activé » et 0 pour « désactivé », et omettre entièrement un paramètre revient au comportement par défaut de YouTube pour celui-ci.
1. autoplay
Démarre la vidéo dès le chargement du lecteur, sans que le visiteur n’appuie sur lecture.
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1La plupart des navigateurs bloquent la lecture automatique avec le son tant que le visiteur n’a pas déjà interagi avec votre site, c’est pourquoi autoplay est presque toujours associé à mute.
2. mute
Démarre le lecteur en muet, ce qui est ce qui permet à autoplay de fonctionner de manière fiable sur tous les navigateurs.
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1&mute=13. start
Démarre la lecture à un nombre précis de secondes dans la vidéo, plutôt que depuis le début.
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=90Quatre-vingt-dix secondes dans cet exemple signifient que le lecteur s’ouvre directement à 1:30.
4. end
Arrête la lecture à un nombre précis de secondes, utile pour ne montrer qu’un extrait pertinent d’une vidéo plus longue.
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=30&end=90Combiné avec start, cela ne lit que la fenêtre de 30 à 90 secondes, puis s’arrête.
5. loop
Relance automatiquement la vidéo une fois terminée. Pour une seule vidéo (et non une playlist), vous devez également ajouter un paramètre playlist réglé sur le même ID de vidéo, sinon la boucle ne fonctionnera pas, silencieusement.
https://www.youtube-nocookie.com/embed/VIDEO_ID?loop=1&playlist=VIDEO_ID6. controls
Affiche ou masque la barre de contrôle du lecteur (lecture/pause, volume, progression, plein écran).
https://www.youtube-nocookie.com/embed/VIDEO_ID?controls=0Régler ceci sur 0 est courant pour une vidéo de type arrière-plan où l’on ne souhaite pas de contrôles de lecture visibles.
7. rel
Contrôle quelles vidéos connexes sont suggérées une fois la lecture terminée. Régler ceci sur 0 limite les suggestions aux vidéos de la même chaîne plutôt qu’au bassin de recommandations plus large de YouTube.
https://www.youtube-nocookie.com/embed/VIDEO_ID?rel=08. list (et le chemin videoseries)
Charge une playlist entière au lieu d’une seule vidéo. Cela se combine avec le chemin /embed/videoseries plutôt qu’avec un ID de vidéo unique.
https://www.youtube-nocookie.com/embed/videoseries?list=PLAYLIST_ID9. index
Utilisé aux côtés d’une playlist pour choisir sur quel élément démarrer, en comptant à partir de 0 pour la première vidéo.
https://www.youtube-nocookie.com/embed/videoseries?list=PLAYLIST_ID&index=2Cet exemple démarre sur la troisième vidéo de la playlist.
10. hl
Définit la langue des propres éléments d’interface du lecteur (et non l’audio ou les sous-titres de la vidéo), à l’aide d’un code de langue standard.
https://www.youtube-nocookie.com/embed/VIDEO_ID?hl=de11. cc_load_policy
Force l’affichage des sous-titres par défaut lorsqu’il est réglé sur 1, utile pour les intégrations axées sur l’accessibilité ou les vidéos en lecture automatique muette où les sous-titres portent le sens.
https://www.youtube-nocookie.com/embed/VIDEO_ID?cc_load_policy=112. color
Définit la couleur de la barre de progression du lecteur, acceptant soit red soit white comme valeurs.
https://www.youtube-nocookie.com/embed/VIDEO_ID?color=whiteCombiner plusieurs paramètres
Les paramètres s’empilent librement. Un extrait d’arrière-plan respectueux de la vie privée, responsive, en lecture automatique, qui boucle silencieusement et masque les contrôles pourrait ressembler à ceci :
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1&mute=1&controls=0&loop=1&playlist=VIDEO_ID&rel=0Tableau de référence
| Paramètre | Valeurs | Ce qu’il fait |
|---|---|---|
| autoplay | 0 / 1 | Démarre la lecture automatiquement |
| mute | 0 / 1 | Démarre en muet, requis pour une lecture automatique fiable |
| start | secondes | Point de départ de la lecture |
| end | secondes | Point d’arrêt de la lecture |
| loop | 0 / 1 | Relance la vidéo (nécessite le paramètre playlist pour une seule vidéo) |
| controls | 0 / 1 | Affiche ou masque la barre de contrôle |
| rel | 0 / 1 | Limite les suggestions en fin de vidéo à la même chaîne |
| list | ID de playlist | Charge une playlist complète via /embed/videoseries |
| index | nombre | Quel élément de la playlist lancer en premier |
| hl | code de langue | Langue de l’interface du lecteur |
| cc_load_policy | 0 / 1 | Force l’affichage des sous-titres par défaut |
| color | red / white | Couleur de la barre de progression |
Lectures connexes
Pour l’aspect mise en page de l’intégration, consultez notre guide sur les intégrations YouTube responsives. Pour la confidentialité, voir intégrer des vidéos YouTube sans cookies. Pour le dépannage, voir vidéo YouTube qui ne s’intègre pas : 8 solutions.
Paramètres fréquemment confondus entre eux
Certains de ces douze paramètres sont assez souvent mélangés pour mériter une comparaison directe. autoplay et loop se ressemblent mais font des choses différentes : autoplay contrôle si la lecture démarre au chargement, loop contrôle si elle redémarre une fois terminée, et ils sont couramment utilisés ensemble mais restent des réglages indépendants. start et index sont également faciles à confondre : start est un décalage temporel en secondes au sein d’une seule vidéo, tandis qu’index est une position au sein d’une playlist, comptée en éléments plutôt qu’en temps. Il est important de bien les associer, car les mélanger (par exemple, essayer d’utiliser index sur l’intégration d’une seule vidéo) n’a tout simplement aucun effet plutôt que de produire une erreur.
Paramètres à la prise en charge limitée ou incohérente
Tous les paramètres ne se comportent pas de manière identique dans tous les contextes. modestbranding, qui réduit la présence du logo de YouTube, a eu des effets incohérents selon les versions du lecteur et est généralement considéré comme un réglage à effort raisonnable plutôt que garanti. De même, certains paramètres liés à l’affichage peuvent se comporter légèrement différemment selon qu’un visiteur est connecté à un compte Google dans son navigateur, car les préférences au niveau du compte peuvent interagir avec les réglages par défaut du lecteur. Les paramètres de contrôle de lecture évoqués plus haut, start, end, autoplay, mute, loop et controls, sont les plus systématiquement fiables sur tous les navigateurs et états de compte, ce qui explique pourquoi ce sont ceux autour desquels bâtir votre stratégie d’intégration.
Un exemple concret : construire pas à pas l’intégration d’une page de cours
Imaginez que vous intégrez une vidéo de leçon sur une page de cours et que vous la voulez respectueuse de la vie privée, responsive, démarrant à la marque des deux minutes où le contenu réel de la leçon commence (en sautant une intro de chaîne), avec les sous-titres activés par défaut pour l’accessibilité, et sans lecture automatique puisque le visiteur doit choisir lui-même de la démarrer. En passant en revue les paramètres : respectueux de la vie privée signifie le domaine youtube-nocookie.com ; responsive signifie un conteneur basé sur des pourcentages plutôt que des dimensions fixes ; démarrer à deux minutes signifie start=120 ; sous-titres par défaut signifie cc_load_policy=1 ; et pas de lecture automatique signifie simplement omettre le paramètre autoplay, puisque c’est l’état par défaut. L’URL d’intégration résultante serait :
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=120&cc_load_policy=1&rel=0Cet exemple unique montre comment les paramètres abordés dans ce guide se combinent naturellement pour répondre à un besoin précis et réaliste, plutôt que d’exister comme une liste abstraite.
Tester vos combinaisons de paramètres
Avant de publier une intégration combinant plusieurs paramètres, il vaut la peine de la tester directement plutôt que de supposer que la combinaison fonctionne comme prévu. Collez l’URL d’intégration complète, paramètres compris, directement dans un onglet de navigateur ; le lecteur devrait se comporter exactement comme il le ferait dans l’iframe de votre page, ce qui vous permet de repérer les fautes de frappe dans les noms de paramètres (une erreur courante, car un paramètre mal orthographié est généralement simplement ignoré silencieusement plutôt que signalé comme une erreur) avant qu’elles n’atteignent votre site en ligne.
Paramètres et confidentialité : lesquels interagissent avec le domaine nocookie
Il convient de préciser que chaque paramètre abordé dans ce guide fonctionne de manière identique, que vous utilisiez le domaine d’intégration standard youtube.com ou le domaine renforcé pour la confidentialité youtube-nocookie.com. Le choix du domaine et les paramètres de lecture sont des décisions entièrement indépendantes : passer au domaine renforcé pour la confidentialité ne désactive ni ne modifie aucun des paramètres autoplay, mute, start, end, loop, controls, rel, list, index, hl, cc_load_policy ou color. Il s’agit d’un point de confusion courant qui mérite d’être clarifié directement, car certains propriétaires de sites supposent que le mode confidentialité est une version allégée du lecteur avec moins d’options, alors qu’en pratique il est fonctionnellement identique, seul le comportement des cookies côté Google diffère.
Construire votre propre référentiel de paramètres pour un projet spécifique
Pour un site plus important comportant de nombreuses vidéos intégrées, il vaut la peine de documenter en interne quelle combinaison de ces douze paramètres votre équipe utilise par défaut, plutôt que de réinventer le choix pour chaque nouvelle intégration. Une norme interne simple, par exemple : toujours utiliser le domaine renforcé pour la confidentialité, toujours inclure rel=0, ne pas activer la lecture automatique par défaut sauf si un type de page précis l’exige, et toujours utiliser un conteneur responsive, garde les intégrations cohérentes sur l’ensemble d’un site et permet de repérer bien plus rapidement une intégration mal configurée lors d’une relecture. Considérer cette liste de douze paramètres comme un menu dans lequel puiser des réglages par défaut, plutôt que comme une décision reprise à zéro à chaque fois, porte ses fruits à mesure que le contenu vidéo d’un site grandit.
Un dernier mot pour garder ce référentiel à portée de main
Mettre cette page en favori, ou plus précisément le tableau de référence ci-dessus, est probablement plus utile que d’essayer de mémoriser d’emblée les douze paramètres. En pratique, la plupart des intégrations d’un site typique n’en utilisent que trois ou quatre à la fois (généralement un domaine renforcé pour la confidentialité de manière implicite, rel=0, et parfois start ou autoplay/mute ensemble), donc disposer de la liste complète à consulter pour les cas moins courants, comme les playlists ou les sous-titres, couvre les situations restantes sans avoir besoin de tout mémoriser à l’avance.
Comment la documentation officielle de YouTube se compare à ce guide
YouTube publie sa propre documentation pour développeurs couvrant l’IFrame Player API et les paramètres d’intégration, principalement destinée aux développeurs qui créent des lecteurs personnalisés contrôlés par JavaScript plutôt qu’aux propriétaires de sites qui ajoutent une simple intégration à une page. Ce guide se concentre spécifiquement sur le sous-ensemble de paramètres pertinents pour une intégration iframe standard sans JavaScript personnalisé, ce qui couvre la grande majorité des cas d’usage réels sur les sites web ordinaires. Pour quiconque construit des expériences vidéo plus avancées et contrôlées par programmation (boutons de lecture personnalisés, suivi de la progression de visionnage, lecteurs multi-vidéos synchronisés), la propre documentation de l’IFrame Player API de YouTube est l’étape suivante au-delà de ce qu’une approche par paramètres de chaîne de requête comme celle-ci peut offrir.
Résumé final des douze paramètres
Parmi autoplay, mute, start, end, loop, controls, rel, list, index, hl, cc_load_policy et color, l’enseignement pratique est qu’une petite poignée d’entre eux (choix du domaine confidentialité, rel, et un conteneur responsive) forme un réglage par défaut sensé pour presque toute intégration, tandis que le reste (start/end, loop, format shorts, playlists, sous-titres, langue et couleur) sont des outils situationnels à utiliser uniquement lorsqu’une page précise le justifie réellement, plutôt que d’être ajoutés sans discernement à chaque intégration d’un site.
Créez-en une maintenant
Outil gratuit
Évitez les chaînes de requête manuelles. Collez un lien et activez les options dont vous avez besoin.
Garder ce référentiel à portée de main signifie ne plus jamais avoir à deviner de mémoire un nom de paramètre lorsqu’un nouveau besoin d’intégration se présente.
Questions fréquentes
Tous ces paramètres fonctionnent-ils ensemble sans conflit ?
Oui, ils peuvent généralement être combinés librement. La principale dépendance à retenir est que loop nécessite un paramètre playlist correspondant pour fonctionner sur une seule vidéo.
Existe-t-il des paramètres qui ne fonctionnent plus ?
Quelques paramètres plus anciens mentionnés dans d’anciens tutoriels, comme showinfo, ont été dépréciés par YouTube au fil du temps et n’ont plus d’effet visible.
Dois-je les mémoriser pour les utiliser ?
Non. Notre générateur de code d’intégration gratuit expose les plus utiles sous forme de simples interrupteurs et champs, et construit l’URL pour vous.
Que se passe-t-il si je fais une faute de frappe dans un nom de paramètre ?
Le lecteur de YouTube ignore généralement les paramètres qu’il ne reconnaît pas plutôt que de générer une erreur visible, donc une faute de frappe n’a silencieusement aucun effet, ce qui rend intéressant de tester directement votre URL d’intégration exacte.
Puis-je définir un niveau de volume par défaut avec un paramètre ?
Non, il n’existe pas de paramètre pour un niveau de volume par défaut spécifique ; le lecteur démarre soit en muet (via le paramètre mute), soit au dernier réglage de volume utilisé par le spectateur.
Ces paramètres fonctionnent-ils de la même manière sur mobile ?
Généralement oui, bien que les navigateurs mobiles appliquent leurs propres restrictions supplémentaires de lecture automatique en plus de celles de YouTube, donc la lecture automatique muette est encore plus systématiquement requise sur mobile que sur ordinateur.
Puis-je modifier ces paramètres après qu’une vidéo est déjà intégrée sur ma page ?
Oui, puisque les paramètres résident simplement dans l’URL src de l’iframe, modifier le HTML de votre page et republier prend effet immédiatement pour quiconque charge la page par la suite.
Existe-t-il un nombre maximum de paramètres que je peux combiner ?
Aucune limite pratique ; les URL peuvent contenir de nombreux paramètres, et les douze présentés ici peuvent techniquement tous être combinés sur une seule intégration à la fois, même si toutes les combinaisons n’ont pas nécessairement de sens ensemble.