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