Youtube, API – Requêter l’API youtube d’une playlist

Il y a eu un saut technologique important entre la V2 de l’API youtube et la V3. Cette évolution n’a d’ailleurs à mon sens pas que des raisons technologiques mais aussi lucratives. On perçoit clairement en découvrant la nouvelle interface, la volonté affirmée de Google, propriétaire de YouTube, de monétiser l’audience gigantesque et l’extreme popularité de cette plateforme.

Paradoxalement, Google se montre assez « généreux ». En effet, le seuil à partir duquel vous allez devoir payer votre usage de l’API YouTube est relativement élevé.
Pour information, voici les données affichées concernant les quotas.

Résumé des quotas

  • Quota gratuit 50 000 000 unités/jour
  • Restant 50 000 000 unités/jour 100 % du quota total
  • Limite par utilisateur 3000 requêtes par seconde et par utilisateur

Pour jouer avec l’API V3, le scénario que nous avons retenu est de parcourir une playlist afin de récupérer l’ensemble des videos de cette playlist.

Utiliser l’API V3

Le premier pré-requis est de vous procurer une clé API. Cette clé vous l’obtiendrait en vous connectant à la console de Google à cette adresse :https://console.developers.google.com/

La clé API YouTube sera de cette forme XQzwSyBRlqCrc89cMeChqoKF6lxBB9dKAeqH4og. Bien évidemment, cette clé n’est donnée qu’à titre d’exemple.

Une fois, cette clé obtenue, vous avez tout le loisir de passer des requêtes directement dans votre navigateur favori.

Un flux au format json d’une playlist issu de l’API YouTube. Il vous suffit de connaitre l’ID de la playlist. L’ID de playlist est de ce type ALeL9jWxKt-lWw9Xk6wYcLrW98QagUs7vz
Youtube, API - Requêter l'API youtube d'une playlist

La console pour obtenir le clé d’API
Youtube, API - Requêter l'API youtube d'une playlist

Un dashboard de l’utilisation de vos quotas d’API
Youtube, API - Requêter l'API youtube d'une playlist

Les fameux quotas
Youtube, API - Requêter l'API youtube d'une playlist

L’écran qui résume les éléments pour obtenir ou l’authentification ou la clé d’API.’
Youtube, API - Requêter l'API youtube d'une playlist

Quelques requêtes sur l’API V3

Pour mémoire, on parcourt une playlist qui nous procure les IDs des videos. Puis une deuxième requête sur l’API à l’aide des IDs nous permet d’avoir les détails de chaque video publié dans la playlist.

Pour retourner les IDs des videos d’une playlist
https://www.googleapis.com/youtube/v3/playlistItems?part=contentDetails&maxResults=50&playlistId={YOUR_ID_PLAYLIST}&key={YOUR_API_KEY}

Youtube, API - Requêter l'API youtube d'une playlist

Pour retourner le détail d’une vidéo sur la base de l’ID QTQfGd3G6dg
Sur cette requête, on appelle que le strict minimum, si vous souhaitez récupérer tous les détails concernant la video, il vous faudra passer étendre le critère &part= comme suit

&part=snippet,contentDetails,statistics,status

https://www.googleapis.com/youtube/v3/videos?key={YOUR_API_KEY}&part=snippet&id={ID_VID}

Youtube, API - Requêter l'API youtube d'une playlist

Source : https://developers.google.com/youtube/v3/getting-started

Conclusions : Il est bien évidemment grand temps de passer à l’API V3 et d’abandonner la version 3 annoncer comme « deprecated » tout en sachant que ce qui est aujourd’hui gratuit sera payant demain quant on voit la quantité de webservices que Google met à disposition.

En savoir plus