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 :
|
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. |