Aujourd'hui, nous allons porter une attention particulière sur la gestion de MA propre chaine. Alors pas ma chaine "Sebastien LHUILLIER" mais "ma" chaine en tant que propriétaire. A la lecture de cet article, vous pourrez donc faire les memes actions sur VOTRE propre chaine. Mais à quoi cela pourrait il servir ? La réponse est toute simple : récupérer sur votre page web des informations de votre chaine afin de les afficher sur votre page. Voyons comment ca marche.
Rappel : Vous trouverez l'ID de votre chaine en clique sur le menus "personnel (en haut à droite) => "Votre chaine". Votre chaine apparait à l'écran. Son url es de la forme https://www.youtube.com/channel/[ID DE VOTRE CANAL]?view_as=subscriber. L'Identification de votre chiane apparait dans l'URL. Dans mon exemple ci-dessus, elle apparait en rouge.

Accès à cette API

L'accès à l'API se fait de la manière suivante :

https://www.googleapis.com/youtube/v3/search?key=[VOTRE CLEF API]&channelId=[VOTRE CHAINE]&part=snippet,id&order=[CHOIX DE TRI]&maxResults=[NOMBRE DE RESULTATS MAXIMAL]

Dans cet article, bien que nous allons gérer des données de MA/VOTRE propre chaine, nous allons faire appel à différentes API (exemple : SEARCH) qui, dans leur écriture, ne mentionnent nullement MA chaine mais c'est à vous à mettre les bons paramètres pour accèdeer aux données de votre chaine.
Afin de bien comprendre, mais sans pour autant laisser à l'air libre ma clef API, voici un exemple commenté :
https://www.googleapis.com/youtube/v3/search?key=[VOTRE CLEF API]&channelId=[ID DE VOTRE CHAINE]&part=snippet,id&order=date&maxResults=2

Détaillons l'URL :

    • https://www.googleapis.com/youtube/v3/search : URL de base
    • key=[VOTRE CLEF API] : saisir de votre clef API
    • channelId : Identification de votre canal
    • part : Le paramètre part spécifie une liste séparée par des virgules d'une ou plusieurs propriétés de ressource de recherche que la réponse API inclura. Définissez la valeur du paramètre sur snippet.snippet,id
    • order : Le paramètre order spécifie la méthode qui sera utilisée pour ordonner les réponses retournées. La valeur par défaut est relevance 
      Les paramètres possibles sont:
      • date : Les ressources sont triées par ordre chronologique inverse en fonction de la date de leur création.
      • note : Les ressources sont triées de la note la plus élevée à la note la plus basse.
      • pertinence : Les ressources sont triées en fonction de leur pertinence pour la requête de recherche. Il s'agit de la valeur par défaut de ce paramètre.
      • title : Les ressources sont triées alphabétiquement par titre.
      • videoCount : Les chaînes sont triées par ordre décroissant de leur nombre de vidéos téléchargées.
      • viewCount : Les ressources sont triées du plus grand au plus petit nombre de vues. Pour les diffusions en direct, les vidéos sont triées par nombre de téléspectateurs simultanés pendant que les diffusions sont en cours.

J'aurais tendance à dire que tout ce que nous avons vu dans cet article jusque là sont des "paramètres de base" de la récupération des données de MA chaine, de VOTRE chaine. Toutefois,la documentation explique que beaucoup d'autres paramètres existent pour affiner vos recherches. Sans vouloir ici faire un inventaire à la Prévert, sachez que des paramètres restrictifs (l'id du canal, le type du canal, le type d'événement dans le cas de brodcast...) et, comme d'habitude, afind e préparer vos requetes, je ne peux que vous conseiller d'utiliser l'option "Essayer" via le bouton éponyme sur la page de la documentation.

 

Quelques exemples

Liste les publications de ma/votre chaine

https://www.googleapis.com/youtube/v3/search?key=[VOTRE CLEF API]&channelId=[ID DE VOTRE CANAL]&part=snippet,id&order=date&maxResults=20

Récupére les information d'un canal (dont le mien)

https://www.googleapis.com/youtube/v3/channels?part=snippet,statistics,contentDetails&id=[ID DE VOTRE CANAL]&key=[VOTRE CLEF API]

Faire une recherche sur ma chaine

https://www.googleapis.com/youtube/v3/search?part=snippet&channelId=[ID DE VOTRE CANAL]&maxResults=50&q=aimant&relevanceLanguage=fr&key=[VOTRE CLEF API]

Audits de ma chaine

https://www.googleapis.com/youtube/v3/channels?part=snippet&id=[ID DE VOTRE CANAL]&key=[VOTRE CLEF API]

Historique des actions d'un utilisateur

https://www.googleapis.com/youtube/v3/activities?part=snippet&channelId=[ID DE VOTRE CANAL]&key=[VOTRE CLEF API]

Flux RSS de ma chaine

https://www.youtube.com/xml/feeds/videos.xml?channel_id=[CHANNEL_ID]

Récupérer l'ensemble de vos playlists

https://www.googleapis.com/youtube/v3/playlists?part=contentDetails&channelId=[ID DE VOTRE CANAL]&key=[VOTRE CLEF API]

Historique d'un/de votre chaine

https://www.googleapis.com/youtube/v3/activities?part=snippet%2CcontentDetails&channelId=[ID DE VOTRE CANAL]+&key=[VOTRE CLEF API]

 

Mon Github

slhuilli1's GitHub repositories