samedi, 02 mai 2020 11:40

API Youtube (N°7) : Les sous-titres de MES vidéos

Écrit par

Aujourd'hui, nous continuons notre travail sur la plate-forme YouTube, en nous intéressant plus particulièrement au sous-titres de nos vidéos.

Dans toute la démonstration que je vais faire dans cet article, il faut bien avoir en compte l'idée suivante : il n'est possible d'intervenir avec cette fonction/API que je vous présente, uniquement sur des vidéos qui vous appartiennent.
Nous allons voir aujourd'hui la gestion des sous-titres, en aucun cas nous pouvons chercher et récupérer des sous-titres d'une vidéo de nous appartenant pas. 
Dans tous les tests effectués, car oui j'ai testé, les API de YouTube sur des vidéos ne m'aappartenant pas, me retourne un message d'erreur.
 

Récupérons les sous-titres de mes viéos Youtube

Dans cette démonstration, gestion des sous-titres, que on appelle caption en anglais , il faut bien séparer deux étapes consécutives pour mener à bien ce travail. En effet, la gestion des sous-titres repose dans un premier temps sur l'identification du sous-titre que l'on veut récupérer, c'est-à-dire rechercher son identifiant. C'est identifiant correspondant grosso-modo à la clé primaire d'une base de données : il permet d'identifier de manière unique et sans ambiguité un sous-titre. Puis, dans un second temps, on obtient ces sous-titres en spécifiant le format de sortie désiré, ainsi que, bien entendu, le résultat que nous venons de récupérer dans la première phase. On obtient donc 2 actions à effectuer :
1. Récupérer l'identifiant du sous-titre
2. À partir de cet identifiant, récupérer les données de sous-titres. En d'autres termes le contenu du sous-titre.
 Pour le premier cas, voici la ligne de commande à lancer :
https://www.googleapis.com/youtube/v3/captions?part=snippet&videoId=[ID_de_votre_video]&key=[votre_clef_API]
Enfin pour le deuxième cas, que je ne peux pas lancer personnellement car les sous-titres étant des données privées, et ne possédant aucune vidéo sous-titrée sur les chaines, je souligne bien le fait que je n'ai pas pu effectuer ce test. Si vous y voyez un problème sur cette ligne de commande n'hésitez pas à m'en faire part.
https://www.googleapis.com/youtube/v3/captions?id=8yMV7mc691ajCze115cxb5goeKsI0BJn&tfmt=[Format]
 En regardant la documentation de l'API, nous voyons que le paramètre tfmt peut prendre plusieurs valeurs : 
  • sbv – SubViewer subtitle
  • scc – Scenarist Closed Caption format
  • srt – SubRip subtitle
  • ttml – Timed Text Markup Language caption
  • vtt – Web Video Text Tracks caption

Ces différentes valeurs retournent des sous-titres dans des formats différents. A vous de choisirt le format qui vous interesse.

Nous continuerons la semaine prochaine notre voyage au travers des API de YouTube
Lu 448 fois Dernière modification le samedi, 02 mai 2020 12:56