Mise en œuvre: canaux

Cette page explique comment utiliser l'API YouTube Data (v3) pour récupérer et mettre à jour les données de votre chaîne. Une ressource channel inclut des ID de playlist qui identifient les vidéos mises en ligne et aimées 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 ressource contentDetails.

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

Appelez la méthode channels.list pour récupérer des informations sur un canal particulier. 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. Cet exemple comporte deux étapes:

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

    Appelez la méthode channels.list, puis définissez la valeur du paramètre part sur brandingSettings et celle 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: Modifiez 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'explorateur d'API 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 terminer la requête dans APIs 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 en fonction de 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 est compatible avec les méthodes channelSections.list, channelSections.insert, channelSections.update et channelSections.delete pour la gestion des sections de la 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, les vidéos les plus populaires ou les vidéos d'une ou plusieurs playlists.

L'exemple ci-dessous permet de récupérer 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 du canal 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 des sections pour 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 en 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 une chaîne cible vers laquelle l'image va être associée, ainsi que des informations sur le temps qui déterminent quand le filigrane s'affiche et pendant combien de temps il est visible.

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

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