ChannelSections

Une ressource channelSection contient des informations sur un ensemble de vidéos qu'une chaîne a choisi de présenter. Par exemple, une section peut présenter les dernières mises en ligne d'une chaîne, les vidéos les plus populaires, ou les vidéos d'une ou plusieurs playlists.

Vous ne pouvez pas créer plus de 10 sections par chaîne.

Méthodes

L'API est compatible avec les méthodes suivantes pour les ressources channelSections:

liste
Renvoie une liste de ressources channelSection correspondant aux critères de requête API. Essayer maintenant
insérer
Ajoute une section de canal à la chaîne de l'utilisateur authentifié. Vous pouvez créer jusqu'à 10 sections par chaîne. Essayer
mise à jour
Modifie une section de chaîne. Essayer
supprimer
Supprime une section de chaîne. Essayer

Représentation des ressources

La structure JSON suivante montre le format d'une ressource channelSections:

{
  "kind": "youtube#channelSection",
  "etag": etag,
  "id": string,
  "snippet": {
    "type": string,
    "channelId": string,
    "title": string,
    "position": unsigned integer
  },
  "contentDetails": {
    "playlists": [
      string
    ],
    "channels": [
      string
    ]
  }
}

Propriétés

Le tableau suivant définit les propriétés qui apparaissent dans cette ressource:

Propriétés
kind string
Identifie le type de ressource d'API. La valeur est youtube#channelSection.
etag etag
Etag de cette ressource.
id string
ID utilisé par YouTube pour identifier de façon unique la section de la chaîne.
snippet object
L'objet snippet contient des informations de base sur la section de la chaîne, telles que son type et son titre.
snippet.type string
Type de la section de la chaîne.

Les valeurs valides pour cette propriété sont les suivantes :
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
snippet.channelId string
ID utilisé par YouTube pour identifier de façon unique la chaîne qui a publié la section de chaîne.
snippet.title string
Titre de la section. Vous ne pouvez définir que le titre d'une section de chaîne dont la valeur pour snippet.type est multiplePlaylists ou multipleChannels. En réalité, vous devez spécifier un titre lorsque vous insérez ou mettez à jour l'un de ces types de sections. Si vous spécifiez un titre pour d'autres types de sections de chaîne, la valeur sera ignorée.

La valeur de cette propriété ne doit pas dépasser 100 caractères et peut contenir tous les caractères UTF-8 valides, à l'exception de < et >.
snippet.position unsigned integer
Position de la section sur la page de la chaîne. Cette propriété utilise un index basé sur 0. La valeur 0 identifie la première section qui apparaît sur la chaîne, la valeur 1 identifie la deuxième section, et ainsi de suite.

Si vous ne spécifiez pas de valeur pour cette propriété lorsque vous insérez une section de canal, le comportement par défaut consiste à afficher la nouvelle section en dernier.
contentDetails object
L'objet contentDetails contient des informations sur le contenu de la section, comme une liste des playlists ou des chaînes présentées dans la section.
contentDetails.playlists[] list
Liste d'un ou de plusieurs ID de playlist figurant dans une section de chaîne. Vous devez spécifier une liste d'ID de playlists si la propriété snippet.type de la ressource channelSection est singlePlaylist ou multiplePlaylists. Cette propriété ne doit pas être spécifiée pour les autres types de sections. Si le type est singlePlaylist, cette liste ne doit contenir qu'un seul ID de playlist.
contentDetails.channels[] list
Liste d'un ou de plusieurs ID de chaînes figurant dans une section de chaîne. Vous devez spécifier une liste d'ID de canaux si la propriété snippet.type de la ressource channelSection est multipleChannels. De plus, cette propriété ne doit pas être spécifiée pour les autres types de sections. Vous ne pouvez pas y inclure votre propre chaîne.