ChannelSections

Eine channelSection-Ressource enthält Informationen zu einer Reihe von Videos, die auf dem Kanal vorgestellt werden. Ein Abschnitt könnte beispielsweise die neueste Uploads, beliebteste Uploads oder Videos aus einer oder mehreren Playlists.

Für einen Kanal können maximal 10 Regale 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 testen
insert
Hiermit wird dem Kanal des authentifizierten Nutzers ein Kanalabschnitt hinzugefügt. Für einen Kanal können maximal 10 Regale erstellt werden. Hier kannst du die Funktion ausprobieren.
Update
Aktualisiert einen Kanalabschnitt. 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, die YouTube zur eindeutigen Identifizierung des Kanalabschnitts verwendet.
snippet object
Das snippet-Objekt enthält grundlegende Details zum Kanalabschnitt, z. B. Typ und Titel.
snippet.type string
Der Typ des Kanalbereichs.

Gültige Werte für diese Property sind:
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
snippet.channelId string
Die ID, die YouTube zur eindeutigen Identifizierung des Kanals verwendet, auf dem der Kanalabschnitt veröffentlicht wurde.
snippet.title string
Der Titel des Abschnitts. Du kannst nur den Titel eines Kanalabschnitts festlegen, der für snippet.type den Wert multiplePlaylists oder multipleChannels hat. Außerdem musst du beim Einfügen oder Aktualisieren dieser Abschnittstypen einen Titel angeben. Wenn du einen Titel für andere Arten von Kanalabschnitten angibst, wird der Wert ignoriert.

Der Wert dieser Property darf maximal 100 Zeichen lang sein und darf alle gültigen UTF-8-Zeichen außer < und < enthalten.
snippet.position unsigned integer
Die Position des Abschnitts auf der Kanalseite. Diese Eigenschaft verwendet einen 0-basierten Index. Der Wert 0 gibt den ersten Abschnitt im Kanal an, ein Wert von 1 den zweiten Abschnitt usw.

Wenn du beim Einfügen eines Kanalbereichs keinen Wert für diese Property angibst, wird der neue Bereich standardmäßig als letzter angezeigt.
contentDetails object
Das contentDetails-Objekt enthält Details zum Inhalt des Kanalabschnitts, z. B. eine Liste der Playlists oder Kanäle, die in dem Abschnitt vorkommen.
contentDetails.playlists[] list
Eine Liste mit mindestens einer Playlist-ID, die in einem Kanalabschnitt empfohlen wird. Du musst eine Liste mit Playlist-IDs angeben, wenn das Attribut snippet.type der Ressource channelSection entweder singlePlaylist oder multiplePlaylists ist. Dieses Attribut sollte nicht für andere Abschnittstypen 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, die in einem Kanalabschnitt vorkommen. Du musst eine Liste mit Kanal-IDs angeben, wenn das Attribut snippet.type der Ressource channelSection den Wert multipleChannels hat. Dieses Attribut sollte nicht für andere Abschnittstypen angegeben werden. Du kannst deinen eigenen Kanal nicht in die Liste aufnehmen.