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 chaîne. Une ressource channel inclut les ID de playlist qui identifient les vidéos mises en ligne et les vidéos "J'aime" d'une chaîne. Pour extraire 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 un canal

Appelez la méthode channels.list pour récupérer des informations sur un canal spécifique. Il existe plusieurs façons d'identifier la chaîne:

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

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

  • Étape 1: Récupérez 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: Mettez à 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 de chaîne YouTube unique de la chaîne. 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 API Explorer ci-dessous crée une ressource channel avec les paramètres de branding 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'explorateur d'API, 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 la chaîne

L'API prend en charge 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 sélectionné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 de 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 est l'ID de chaîne de la chaîne 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 du 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é.

Importer et définir une image en filigrane pour une chaîne

Vous pouvez appeler la méthode watermarks.set pour importer une image de filigrane et la définir pour une chaîne. L'image s'affiche ensuite pendant la lecture des vidéos de la chaîne spécifiée. Vous pouvez également spécifier un canal cible auquel l'image sera associée, ainsi que des informations de timing qui déterminent quand le filigrane s'affiche et pendant combien de temps.

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

Malheureusement, cette requête ne peut pas être testée à l'aide d'APIs Explorer, car il n'est pas possible d'importer des fichiers multimédias avec cette fonctionnalité, ce qui est obligatoire pour cette méthode.