Qu’est-ce que l’API YouTube ?

L’API YouTube est une famille d’interfaces que Google publie pour les développeurs : la Data API pour lire les informations de vidéo, de chaîne et de playlist, et l’IFrame Player API pour contrôler un lecteur intégré avec JavaScript (lire, mettre en pause, avancer, et écouter des événements).

En avez-vous besoin pour une simple intégration ?

Non. Une intégration simple, du type de celles produites par le générateur de code d’intégration de ce site, n’a besoin de rien de plus qu’une <iframe> standard et ne nécessite ni clé API, ni projet Google Cloud, ni JavaScript.

Quand elle devient utile

L’IFrame Player API mérite d’être envisagée dès que vous avez besoin d’un comportement personnalisé, comme un bouton de lecture piloté par JavaScript, le suivi de la progression de visionnage dans des outils d’analyse, ou la synchronisation de plusieurs lecteurs intégrés ensemble.

Les deux API qui composent « l’API YouTube »

Ce que l’on entend habituellement par « l’API YouTube » recouvre en réalité deux choses liées mais distinctes. La YouTube Data API permet à une développeuse de lire par programmation (et, avec les bonnes permissions, d’écrire) des informations sur les vidéos, chaînes, playlists et commentaires, utile pour construire par exemple un outil de recherche vidéo personnalisé ou un tableau de bord de chaîne. La YouTube IFrame Player API est différente : elle permet à une développeuse de contrôler un lecteur déjà intégré avec JavaScript, lire, mettre en pause, avancer, ajuster le volume, et écouter des événements comme « vidéo terminée », sans avoir besoin du système d’authentification ou de quota de la Data API.

Un exemple concret de quand chaque API est réellement nécessaire

Un site qui affiche simplement une vidéo fixe sur une page n’a besoin d’aucune des deux API ; un code d’intégration standard, comme ceux produits par notre générateur de code d’intégration, suffit à lui seul. Un site qui a besoin d’un bouton personnalisé « tout lire » contrôlant ensemble plusieurs lecteurs intégrés, ou qui veut enregistrer des événements d’analyse quand un visiteur termine réellement de regarder une vidéo, se tournerait spécifiquement vers l’IFrame Player API. Un site construisant une bibliothèque vidéo consultable puisant des métadonnées de nombreuses chaînes utiliserait plutôt, ou en complément, la Data API.

API YouTube contre simple intégration

La distinction pratique est contrôle contre simplicité. Une intégration simple, sans API, est un unique fragment HTML sans dépendance JavaScript, sans clé API, et sans quota d’utilisation à gérer, ce qui explique pourquoi elle reste le bon choix pour l’écrasante majorité des sites qui veulent simplement afficher une vidéo. Se tourner vers l’une ou l’autre API YouTube n’a de sens que lorsque les besoins d’un projet dépassent réellement ce que des paramètres de chaîne de requête sur une URL d’intégration standard peuvent accomplir, comme un contrôle de lecture personnalisé piloté par code ou une récupération de métadonnées en masse.

Si vous n’êtes pas sûr de la catégorie dans laquelle se situe votre projet, le point de départ le plus sûr est une intégration simple ; vous pourrez toujours ajouter un contrôle piloté par API plus tard si un besoin spécifique se présente.

Questions fréquentes