ChannelSections

Eine channelSection-Ressource enthält Informationen zu einer Reihe von Videos, die von einem Kanal empfohlen werden. Ein Bereich kann beispielsweise die neuesten Uploads eines Kanals, die beliebtesten Uploads oder Videos aus einer oder mehreren Playlists enthalten.

Pro Kanal können maximal zehn Bereiche erstellt werden.

Methoden

Die API unterstützt die folgenden Methoden für channelSections-Ressourcen:

list
Gibt eine Liste von channelSection Ressourcen zurück, die den Kriterien der API-Anfrage entsprechen. Jetzt ausprobieren
insert
Fügt dem Kanal des authentifizierten Nutzers einen Kanalabschnitt hinzu. Auf einem Kanal können maximal zehn Bereiche erstellt werden. Hier kannst du die Funktion ausprobieren.
Update
Ein Kanalabschnitt wird aktualisiert. Hier kannst du die Funktion ausprobieren.
delete
Löscht einen Kanalabschnitt. Hier kannst du die Funktion ausprobieren.

Ressourcendarstellung

Die folgende JSON-Struktur zeigt das Format einer channelSections-Ressource:

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

Attribute

In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource angezeigt werden:

Attribute
kind string
Identifiziert den Typ der API-Ressource. Der Wert ist youtube#channelSection.
etag etag
Das ETag dieser Ressource.
id string
Die ID, mit der YouTube den Kanalabschnitt eindeutig identifiziert.
snippet object
Das snippet-Objekt enthält grundlegende Details zum Kanalabschnitt, z. B. Typ und Titel.
snippet.type string
Der Typ des Kanalabschnitts.

Gültige Werte für dieses Attribut sind:
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
snippet.channelId string
Die ID, mit der YouTube den Kanal eindeutig identifiziert, auf dem der Kanalabschnitt veröffentlicht wurde.
snippet.title string
Der Titel des Abschnitts. Du kannst nur den Titel eines Kanalabschnitts festlegen, dessen snippet.type-Wert entweder multiplePlaylists oder multipleChannels ist. Du musst einen Titel angeben, wenn du einen dieser Abschnittstypen hinzufügst oder aktualisierst. Wenn du einen Titel für andere Arten von Kanalabschnitten angibst, wird der Wert ignoriert.

Der Wert dieser Eigenschaft hat eine maximale Länge von 100 Zeichen und kann alle gültigen UTF-8-Zeichen außer < und > enthalten.
snippet.position unsigned integer
Die Position des Abschnitts auf der Kanalseite. Diese Property verwendet einen 0-basierten Index. Der Wert 0 kennzeichnet den ersten Abschnitt des Kanals, der Wert 1 den zweiten Abschnitt und so weiter.

Wenn Sie beim Einfügen eines Kanalabschnitts keinen Wert für diese Eigenschaft angeben, wird der neue Abschnitt standardmäßig zuletzt angezeigt.
contentDetails object
Das contentDetails-Objekt enthält Details zum Inhalt des Kanalbereichs, z. B. eine Liste mit Playlists oder Kanälen.
contentDetails.playlists[] list
Eine Liste mit einer oder mehreren Playlist-IDs in einem Kanalabschnitt. Du musst eine Liste mit Playlist-IDs angeben, wenn das Attribut snippet.type der channelSection-Ressource entweder singlePlaylist oder multiplePlaylists ist. Es sollte auch nicht für andere Arten von Abschnitten angegeben werden. Wenn der Typ singlePlaylist ist, muss in dieser Liste genau eine Playlist-ID angegeben werden.
contentDetails.channels[] list
Eine Liste mit einer oder mehreren Kanal-IDs in einem Kanalabschnitt. Du musst eine Liste mit Kanal-IDs angeben, wenn die snippet.type-Property der channelSection-Ressource multipleChannels ist. Diese Property sollte nicht für andere Bereichstypen angegeben werden. Du kannst deinen eigenen Kanal nicht in die Liste aufnehmen.