Implémentation: canaux

Cette page explique comment utiliser l'API YouTube Data (v3) pour effectuer des fonctions liées à la récupération et à la mise à jour des données de la chaîne. Une ressource channel inclut des ID de playlist qui identifient les vidéos mises en ligne et les vidéos "J'aime" d'une chaîne. Pour récupérer ces informations lorsque vous appelez la méthode channels.list, assurez-vous que la valeur du paramètre part inclut la partie de la ressource contentDetails.

Récupérer des informations sur une chaîne

Appelez la méthode channels.list pour récupérer des informations sur une chaîne spécifique. Vous pouvez identifier la chaîne de plusieurs manières :

Définir les informations de branding d'une chaîne

Cet exemple met à jour les options de branding d'une chaîne. Il comporte deux étapes :

  • Étape 1 : Récupérer les options de branding de la chaîne

    Appelez la méthode channels.list et définissez la valeur du paramètre part sur brandingSettings et la valeur du paramètre mine sur true.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=brandingSettings
        &mine=true

    Votre application peut afficher les paramètres récupérés, ce qui permet à l'utilisateur de les modifier.

  • Étape 2 : Mettre à jour les options de branding de la chaîne

    Appelez la méthode channels.list et définissez les valeurs suivantes :

    • Définissez la propriété id sur l'ID unique de la chaîne YouTube. L'ID peut être extrait de la réponse de l'API à l'étape 1.
    • Définissez la valeur du paramètre part sur brandingSettings.

    Le lien vers l'API Explorer ci-dessous crée une ressource channel avec les paramètres de marque suivants :

    {
  "id": "CHANNEL_ID",
  "brandingSettings": {
    "channel": {
      "description": "A great channel to be enjoyed by all.",
      "moderateComments": true,
      "showRelatedChannels": true,
      "showBrowseView": true,
      "featuredChannelsTitle": "Featured Channel Stuff",
      "featuredChannelsUrls": [
        "UC_x5XG1OV2P6uZZ5FSM9Ttw",
        "UCBR8-60-B28hp2BmDPdntcQ",
        "UCK8sQmJBp8GCxrOtXWBpyEA"
      ],
      "profileColor": "#006600"
    }
  }
}

    Pour effectuer la requête dans l'API Explorer, vous devez définir la valeur de la propriété id sur l'ID de la chaîne de l'utilisateur authentifié. Vous devez également définir les propriétés de l'image pour qu'elles correspondent à vos paramètres actuels.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?
        part=brandingSettings

Gérer les sections de chaîne

L'API est compatible avec les méthodes channelSections.list, channelSections.insert, channelSections.update et channelSections.delete pour gérer les sections de chaîne. Une section de chaîne est un ensemble de vidéos présentées sur une chaîne. Par exemple, une section peut inclure les dernières vidéos mises en ligne d'une chaîne, ses vidéos les plus populaires ou les vidéos d'une ou plusieurs playlists.

L'exemple ci-dessous récupère les sections de la chaîne YouTube officielle de Google. La requête appelle la méthode channelSections.list et définit la valeur du paramètre channelId sur UCK8sQmJBp8GCxrOtXWBpyEA, qui correspond à l'ID de la chaîne de Google.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list?
part=snippet,contentDetails
&channelId=UCK8sQmJBp8GCxrOtXWBpyEA

Cette requête nécessite une autorisation si, au lieu d'utiliser le paramètre channelId, vous définissez la valeur de paramètre mine sur true. Ce paramètre indique que vous récupérez les sections de la chaîne de l'utilisateur actuellement authentifié.

Mettre en ligne et définir une image de filigrane pour une chaîne

Vous pouvez appeler la méthode watermarks.set pour mettre en ligne une image de filigrane et la définir pour une chaîne. L'image s'affiche ensuite lors de la lecture des vidéos de la chaîne spécifiée. Vous pouvez également spécifier une chaîne cible vers laquelle l'image sera liée, ainsi que des informations de timing qui déterminent quand le filigrane apparaît et combien de temps il est visible.

La méthode watermarks.unset supprime l'image de filigrane d'une chaîne.

Malheureusement, cette requête ne peut pas être testée à l'aide de l'API Explorer, car elle ne permet pas de mettre en ligne des fichiers multimédias, ce qui est une exigence pour cette méthode.