Eine playlist
-Ressource steht für eine YouTube-Playlist. Eine Playlist ist eine Sammlung von Videos, die nacheinander angesehen und mit anderen Nutzern geteilt werden können. Playlists sind standardmäßig für andere Nutzer sichtbar. Playlists können jedoch öffentlich oder privat sein.
YouTube verwendet Playlists außerdem, um spezielle Videosammlungen für einen Kanal zu identifizieren. Beispiele:
- hochgeladene Videos
- positiv bewertete Videos mit „Mag ich“-Bewertungen
channel resource
eines bestimmten Kanals abrufen.Anschließend können Sie diese Listen mit der Methode
playlistItems.list
abrufen. Sie können den Listen auch Elemente hinzufügen oder daraus entfernen, indem Sie die Methoden playlistItems.insert
und playlistItems.delete
aufrufen.
Methoden
Die API unterstützt die folgenden Methoden für playlists
-Ressourcen:
- list
- Gibt eine Sammlung von Playlists zurück, die den API-Anfrageparametern entsprechen. Du kannst beispielsweise alle Playlists abrufen, die dem authentifizierten Nutzer gehören, oder eine oder mehrere Playlists anhand ihrer eindeutigen IDs. Hier kannst du die Funktion ausprobieren.
- insert
- Erstellt eine Playlist Hier kannst du die Funktion ausprobieren.
- Update
- Ändert eine Playlist. Beispielsweise kannst du den Titel, die Beschreibung oder den Datenschutzstatus einer Playlist ändern. Hier kannst du die Funktion ausprobieren.
- delete
- Löscht eine Playlist. Hier kannst du die Funktion ausprobieren.
Ressourcendarstellung
Die folgende JSON-Struktur zeigt das Format einer playlists
-Ressource:
{ "kind": "youtube#playlist", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "defaultLanguage": string, "localized": { "title": string, "description": string } }, "status": { "privacyStatus": string }, "contentDetails": { "itemCount": unsigned integer }, "player": { "embedHtml": string }, "localizations": { (key): { "title": string, "description": 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#playlist . |
etag |
etag Das ETag dieser Ressource. |
id |
string Die ID, mit der YouTube die Playlist eindeutig identifiziert. |
snippet |
object Das snippet -Objekt enthält grundlegende Details zur Playlist, z. B. Titel und Beschreibung. |
snippet.publishedAt |
datetime Datum und Uhrzeit der Erstellung der Playlist. Der Wert wird im ISO 8601-Format angegeben. |
snippet.channelId |
string Die ID, mit der YouTube den Kanal eindeutig identifiziert, auf dem die Playlist veröffentlicht wurde. |
snippet.title |
string Der Titel der Playlist. |
snippet.description |
string Die Beschreibung der Playlist. |
snippet.thumbnails |
object Eine Karte mit Thumbnail-Bildern, die mit der Playlist verknüpft sind. Bei jedem Objekt auf der Karte ist der Schlüssel der Name der Miniaturansicht. Der Wert ist ein Objekt, das weitere Informationen zur Miniaturansicht enthält. |
snippet.thumbnails.(key) |
object Gültige Schlüssel/Wert-Paare sind:
|
snippet.thumbnails.(key).url |
string Die URL des Bildes. |
snippet.thumbnails.(key).width |
unsigned integer Die Breite des Bildes. |
snippet.thumbnails.(key).height |
unsigned integer Die Höhe des Bildes. |
snippet.channelTitle |
string Der Kanaltitel des Kanals, zu dem das Video gehört. |
snippet.tags[] |
list Diese Property wurde eingestellt. Mit der Playlist verknüpfte Keyword-Tags. |
snippet.defaultLanguage |
string Die Sprache des Textes in den Attributen snippet.title und snippet.description der Ressource playlist . |
snippet.localized |
object Das snippet.localized -Objekt enthält entweder einen lokalisierten Titel und eine Beschreibung für die Playlist oder den Titel in der Standardsprache für die Metadaten der Playlist.
localizations -Objekt kannst du lokalisierte Titel hinzufügen, aktualisieren oder löschen. |
snippet.localized.title |
string Der lokalisierte Titel der Playlist. |
snippet.localized.description |
string Die lokalisierte Playlist-Beschreibung. |
status |
object Das Objekt status enthält Statusinformationen für die Playlist. |
status.privacyStatus |
string Der Datenschutzstatus der Playlist. Gültige Werte für diese Property:
|
contentDetails |
object Das contentDetails -Objekt enthält Informationen zum Playlist-Inhalt, einschließlich der Anzahl der Videos in der Playlist. |
contentDetails.itemCount |
unsigned integer Die Anzahl der Videos in der Playlist. |
player |
object Das player -Objekt enthält Informationen, die du zum Abspielen der Playlist in einem eingebetteten Player verwenden würdest. |
player.embedHtml |
string Ein <iframe> -Tag, das einen Player einbettet, der die Playlist wiedergibt. |
localizations |
object Das localizations -Objekt enthält Übersetzungen der Metadaten der Playlist. |
localizations.(key) |
object Die Sprache des lokalisierten Textes, der mit dem Schlüssel/Wert-Paar verknüpft ist. Der Wert ist ein String, der einen BCP-47-Sprachcode enthält. |
localizations.(key).title |
string Der lokalisierte Titel der Playlist. |
localizations.(key).description |
string Die lokalisierte Playlist-Beschreibung. |