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