Nous allons voir aujourd'hui, dans notre voyage dans les API de Youtube, l'une d'entre elle très pratique mais très inutile en tant que telle. Elle sert à récupérer l'enemble des rubriques dans lesquelles les videos peuvent être classées.

L'appel de l'API

L'appel de l'API est super simple et se crée de la manière suivante :

https://www.googleapis.com/youtube/v3/guideCategories?part=snippet&regionCode=FR&key=votre code API

L'API vous retourne une chaine JSON, retour classique de l'API Youtube (on commence à connaitre avec tous mes articles) qu'il ne reste plus qu'a parser.
Je souhaite toutefois attirer votre attention sur un point particulier, que nous avons déjà vu sur un précédent article, que Youtube, à des fins de facilités je suppose, considère ces catégories comme des canaux (channels). Et vous vous rappelez de mes précédents articles, cela a aussi été le cas pour d'autres précédentes, où Youtube considère les lives à venir comme un seul canal que l'ont peut interroger. On pourrait même conclure, le tout en prenant des pincettes, qu'un canal n'est pas une chaine Youtube, mais peut l'être puisqu'un canal (channel) est un flux d'un ensemble de vidéos, qu'elle soient accessibles ou lives programmés.
Mais à ce stade, je considère que la définition que je viens de faire d'un canal est sûrement encore incomplète !

Les retours

Lors de l'appel de l'API, cette dernière vous retourne une liste de vidéos.

Pour chacun des résultats retournés, vous l'API vous stipule :

• kind : type du résultat retourné
• etag : partie du protocole de communication HTTP utilisée pour la validation du cache
• id : identification (non documentée dans la documentation officielle)

Ensuite, un sous ensemble snippet se trouve à la suite de ce résultat. Le snippet retourné est constitué de :

• title : titre de la catégorie dans laquelle se trouve la vidéo. (En anglais)
• channelId : identification du canal où la vidéo est stockée.

Voila, un petit article bien court mais essentiel dans la compréhension des API.