ChannelSections

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

Une chaîne ne peut pas créer plus de 10 étagères.

Méthodes

L'API accepte les méthodes suivantes pour les ressources channelSections:

list
Renvoie une liste de channelSection ressources correspondant aux critères de requête de l'API. Essayer maintenant
insérer
Ajoute une section de chaîne à la chaîne de l'utilisateur authentifié. Une chaîne peut créer jusqu'à 10 étagères. Essayer
mettre à jour
Met à jour une section de la 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 de l'API. La valeur sera youtube#channelSection.
etag etag
ETag de cette ressource.
id string
ID que YouTube utilise pour identifier de manière 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 que YouTube utilise pour identifier la chaîne qui a publié la section de chaîne de manière unique.
snippet.title string
Titre de la section. Vous ne pouvez définir que le titre d'une section de chaîne avec une valeur snippet.type (multiplePlaylists ou multipleChannels) et, en fait, vous devez indiquer 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înes, 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 chaîne Cette propriété utilise un index de base 0. La valeur 0 identifie la première section qui apparaît sur la chaîne, la valeur 1 identifie la deuxième section, etc.

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 de la chaîne, comme une liste de playlists ou de chaînes.
contentDetails.playlists[] list
Liste d'un ou de plusieurs ID de playlist présentés dans une section de chaîne. Vous devez spécifier une liste d'ID de playlist si la propriété snippet.type de la ressource channelSection est singlePlaylist ou multiplePlaylists, et que cette propriété ne doit pas être spécifiée pour d'autres types de sections. Si le type est singlePlaylist, cette liste doit contenir exactement un ID de playlist.
contentDetails.channels[] list
Liste d'un ou de plusieurs ID de chaîne affichés dans une section. Vous devez spécifier une liste d'ID de canaux si la propriété snippet.type de la ressource channelSection est multipleChannels, et que cette propriété ne doit pas être spécifiée pour d'autres types de sections. Vous ne pouvez pas inclure votre propre chaîne dans la liste.