ChannelSections

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

Une chaîne peut créer jusqu'à 10 étagères.

Méthodes

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

liste
Renvoie une liste de ressources channelSection correspondant aux critères de la requête de l'API. Essayer maintenant
insérer
Ajoute une section "Canal" à la chaîne de l'utilisateur authentifié. Une chaîne peut créer jusqu'à 10 étagères. 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 sera youtube#channelSection.
etag etag
Etag de cette ressource.
id string
ID utilisé par YouTube pour identifier la section de chaîne de manière unique.
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 du canal.

Les valeurs acceptées pour cette propriété sont: <ph type="x-smartling-placeholder">
    </ph>
  • 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 snippet.type est multiplePlaylists ou multipleChannels. 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, cette 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 &lt; et &lt;.
snippet.position unsigned integer
Position de la section sur la page de la 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, et ainsi de suite.

Si vous ne spécifiez pas de valeur pour cette propriété lorsque vous insérez une section de chaîne, la nouvelle section est affichée en dernier par défaut.
contentDetails object
L'objet contentDetails contient des informations sur le contenu de la section de chaîne, telles qu'une liste de playlists ou de chaînes présentées dans la section.
contentDetails.playlists[] list
Liste d'un ou de plusieurs ID de playlists présentés 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, 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 ne doit spécifier qu'un seul ID de playlist.
contentDetails.channels[] list
Liste d'un ou de plusieurs ID de chaîne présentés 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. 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.