Nous continuons notre tour des API Youtube, en nous intéressant aujourd'hui aux vidéos en direct.
Effectivement, YouTube propose une plate-forme de streaming plutôt intéressante, relativement simple à utiliser pour les youtubeurs, et qui nous donne des informations assez intéressantes concernant les directs (lives). Attention toutefois, tout ce que nous allons voir aujourd'hui n'est accessible qu'à un moment donné, puisque c'est un direct. (J'en ai fait l'amer expérience à interroger une API sur un live venant de se terminer, el temps de lancer ma requête HTTP).
Je tiens à remercier, pour cette vidéo, la youtubeuse Pinkgeek, qui, au moment où j'écris ces quelques lignes, est en live. Certes son charme n'est pas désagréable, mais c'est le seul LIVE que j'ai trouvé facilement sur YouTube. Je profite de ce petit article pour spécifier une trouvaille que je viens de faire : pour rechercher (et donc trouver!) un live vidéo, il suffit de se rendre à l'adresse www.youtube.com/live, adresse dédiée aux lives!
Nous allons donc voir, au cours de cet article, comment trouver des informations sur une vidéo diffusée en direct, grâce aux API YouTube. Pour ceci, nous allons nous intéresser plus particulièrement à la propriété captions, dont vous pourrez, trouver facilement la documentation sur YouTube à l'adresse https://developers.google.com/youtube/v3/docs/captions, notament sur toutes les informations sur cette activité. Pour les anglophobes, je rappelle qu'un live tout simplement et la diffusion en direct d'une vidéo. Les lives se font essentiellement, sur Youtube, au travers de webcam mais d'autres technologies et d'autres plateformes co-existent pour cette pratique vidéaste.

Alors que peut-on faire avec la propriété captions ?

Une ressource caption, représente un ensemble de propriétés de la vidéo. Que l'on soit bien d'accord, les informations retournées ne sont pas les sous-titres eux-mêmes, mais plutôt des métadonnées sur ces derniers.

Au risque de vous décevoir, nous n'allons pas voir grand-chose cette semaine, puisque cette propriété caption ne retourne pas beaucoup d'informations. Parmi les méthodes, autre que l'insertion de sous-titres, que nous ne verrons pas nous pouvons aussi faire des mises à jour et des suppression de données via l'API. Mais nous allons nous intéresser aujourd'hui plus particulièrement au fait de lister des sous-titres.

Pour faire cette action, nous allons comme un autre habitude lancer une requête cURL dans laquelle nous passons l'identifiant de la vidéo, et la propriété part sur laquelle je ne reviendrai pas (nous l'avons déjà vu) et bien entendu votre clé privée. URL et ainsi formée :

https://www.googleapis.com/youtube/v3/captions?part=snippet&videoId=gyI14l2kCTw&key=VOTRE_CLEF_API Si nous lançons cette adresse dans un navigateur web, nous pouvons nous rendre compte que nous retournons un ensemble de données sous la forme d'un fichier, JSON plutôt bien fourni en renseignements ou plutôt sur la vidéo en question.

Je ne vais pas. Détailler, comme à mon habitude, l'ensemble des propriétés renvoyées, la doc est d'ailleurs faite à cet effet.

Un peu de lecture documentaire Alors oui, je sais cette semaine. On article est un peu court mais je pense qu'il fallait absolument que on parle de cette propriété caption. Nous continuons à la semaine prochaine avec une autre propriété de YouTube.