ChannelSections

Eine channelSection-Ressource enthält Informationen zu einer Gruppe von Videos, die ein Kanal ausgewählt hat. Ein Abschnitt kann beispielsweise die neuesten Uploads eines Kanals, die beliebtesten Uploads oder Videos aus einer oder mehreren Playlists enthalten.

Für einen 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 API-Anfragekriterien entsprechen. Jetzt ausprobieren.
Einfügen
Fügt dem Kanal des authentifizierten Nutzers einen Kanalabschnitt hinzu. Ein Kanal kann maximal 10 Regale erstellen. Hier kannst du die Funktion ausprobieren.
Aktualisieren
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 verwendet, um den Kanalabschnitt eindeutig zu identifizieren.
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 diese Property sind:
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
snippet.channelId string
Die ID, mit der YouTube den Kanal, der den Kanalabschnitt veröffentlicht hat, eindeutig identifiziert.
snippet.title string
Der Titel des Abschnitts Du kannst nur den Titel eines Kanalabschnitts mit dem snippet.type-Wert multiplePlaylists oder multipleChannels festlegen. Du musst einen Titel angeben, wenn du einen dieser Abschnittstypen einfügst oder aktualisierst. Wenn du einen Titel für andere Arten von Kanalabschnitten angibst, wird der Wert ignoriert.

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

Wenn Sie beim Einfügen eines Kanalabschnitts keinen Wert für diese Property angeben, wird standardmäßig der neue Bereich zuletzt angezeigt.
contentDetails object
Das Objekt contentDetails enthält Details zum Inhalt des Kanalabschnitts, z. B. eine Liste von Playlists oder Kanälen, die in diesem Abschnitt vorgestellt werden.
contentDetails.playlists[] list
Eine Liste mit einer oder mehreren Playlist-IDs, die in einem Kanalabschnitt enthalten sind. Du musst eine Liste mit Playlist-IDs angeben, wenn die snippet.type-Property der channelSection-Ressource entweder singlePlaylist oder multiplePlaylists ist. Diese Property sollte 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, die in einem Kanalabschnitt enthalten sind. Du musst eine Liste mit Kanal-IDs angeben, wenn die Property snippet.type der channelSection-Ressource multipleChannels ist. Diese Property sollte nicht für andere Arten von Bereichen angegeben werden. Dein eigener Kanal kann nicht in die Liste aufgenommen werden.