Playlists

Eine playlist-Ressource stellt eine YouTube-Playlist dar. Eine Playlist ist eine Sammlung von Videos, die nacheinander abgespielt und mit anderen Nutzern geteilt werden können. Playlists sind standardmäßig öffentlich sichtbar, können aber auch öffentlich oder privat sein.

YouTube verwendet Playlists auch, um spezielle Sammlungen von Videos für einen Kanal zu identifizieren, z. B.:

  • hochgeladene Videos
  • Videos, die positiv bewertet wurden (mit „Mag ich“ markiert)
Diese Listen sind mit einem Kanal verknüpft, der eine Sammlung von Videos, Playlists und anderen YouTube-Informationen einer Person, Gruppe oder eines Unternehmens ist. Du kannst die Playlist-IDs für jede dieser Listen über die channel resource für einen bestimmten Kanal abrufen.

 Anschließend können Sie mit der Methode playlistItems.list eine dieser Listen abrufen. Sie können auch Elemente zu diesen Listen 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. Sie können beispielsweise alle Playlists abrufen, die dem authentifizierten Nutzer gehören, oder eine oder mehrere Playlists anhand ihrer eindeutigen IDs abrufen. Hier kannst du die Funktion ausprobieren.
insert
Erstellt eine Playlist. Hier kannst du die Funktion ausprobieren.
Aktualisieren
Ändert eine Playlist. Du kannst beispielsweise 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,
    "podcastStatus": enum
  },
  "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 enthalten sind:

Attribute
kind string
Gibt den Typ der API-Ressource an. Der Wert ist youtube#playlist.
etag etag
Das ETag dieser Ressource.
id string
Die ID, die YouTube verwendet, um die Playlist eindeutig zu identifizieren.
snippet object
Das snippet-Objekt enthält grundlegende Details zur Playlist, z. B. den Titel und die Beschreibung.
snippet.publishedAt datetime
Datum und Uhrzeit der Erstellung der Playlist. Der Wert wird im ISO 8601-Format angegeben.
snippet.channelId string
Die ID, die YouTube verwendet, um den Kanal, auf dem die Playlist veröffentlicht wurde, eindeutig zu identifizieren.
snippet.title string
Der Titel der Playlist.
snippet.description string
Die Beschreibung der Playlist.
snippet.thumbnails object
Eine Karte mit Miniaturansichten, die mit der Playlist verknüpft sind. Für jedes Objekt auf der Karte ist der Schlüssel der Name des Vorschaubilds und der Wert ein Objekt, das weitere Informationen zum Vorschaubild enthält.
snippet.thumbnails.(key) object
Gültige Schlüsselwerte sind:
  • default: Das Standard-Thumbnail-Bild. Die Standard-Miniaturansicht für ein Video oder eine Ressource, die auf ein Video verweist, z. B. ein Playlistenelement oder ein Suchergebnis, ist 120 Pixel breit und 90 Pixel hoch. Das Standard-Thumbnail für einen Channel ist 88 Pixel breit und 88 Pixel hoch.
  • medium – Eine Version des Thumbnails mit höherer Auflösung. Bei einem Video (oder einer Ressource, die auf ein Video verweist) ist dieses Bild 320 Pixel breit und 180 Pixel hoch. Für einen Kanal ist dieses Bild 240 Pixel breit und 240 Pixel hoch.
  • high – Eine Version des Thumbnail-Bilds mit hoher Auflösung. Bei einem Video (oder einer Ressource, die auf ein Video verweist) ist dieses Bild 480 Pixel breit und 360 Pixel hoch. Für einen Kanal ist dieses Bild 800 Pixel breit und 800 Pixel hoch.
  • standard: Eine noch höher aufgelöste Version des Thumbnail-Bilds als das Bild mit der Auflösung high. Dieses Bild ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, z. B. Playlist-Elemente oder Suchergebnisse. Dieses Bild ist 640 Pixel breit und 480 Pixel hoch.
  • maxres: Die Version des Thumbnail-Bilds mit der höchsten Auflösung. Diese Bildgröße ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, z. B. Playlist-Elemente oder Suchergebnisse. Dieses Bild ist 1.280 Pixel breit und 720 Pixel hoch.
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
Dieses Attribut wird nicht mehr unterstützt.

Keyword-Tags, die mit der Playlist verknüpft sind.
snippet.defaultLanguage string
Die Sprache des Texts in den Attributen snippet.title und snippet.description der playlist-Ressource.
snippet.localized object
Das snippet.localized-Objekt enthält entweder einen lokalisierten Titel und eine lokalisierte Beschreibung für die Playlist oder den Titel in der Standardsprache für die Metadaten der Playlist.
  • Lokalisierter Text wird im Ressourcenausschnitt zurückgegeben, wenn in der playlists.list-Anfrage mit dem Parameter hl eine Sprache angegeben wurde, für die lokalisierter Text zurückgegeben werden soll und lokalisierter Text in dieser Sprache verfügbar ist.
  • Metadaten für die Standardsprache werden zurückgegeben, wenn kein hl-Parameterwert angegeben ist oder ein Wert angegeben ist, aber keine lokalisierten Metadaten für die angegebene Sprache verfügbar sind.
Das Attribut enthält einen schreibgeschützten Wert. Mit dem localizations-Objekt können Sie lokalisierte Titel hinzufügen, aktualisieren oder löschen.
snippet.localized.title string
Der lokalisierte Playlist-Titel.
snippet.localized.description string
Die lokalisierte Playlist-Beschreibung.
status object
Das status-Objekt enthält Statusinformationen für die Playlist.
status.privacyStatus string
Der Datenschutzstatus der Playlist.

Gültige Werte für dieses Attribut sind:
  • private
  • public
  • unlisted
status.podcastStatus string
Der Podcast-Status der Playlist. Wenn der Wert enabled ist, wird die Playlist als Podcast-Show gekennzeichnet. Damit der Podcast-Status einer Playlist auf enabled gesetzt werden kann, muss die Playlist ein Playlist-Bild haben.

Gültige Werte für diese Property sind:
  • enabled
  • disabled
  • unspecified
contentDetails object
Das contentDetails-Objekt enthält Informationen zum Inhalt der Playlist, 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 Sie zum Abspielen der Playlist in einem eingebetteten Player benötigen.
player.embedHtml string
Ein <iframe>-Tag, das einen Player einbettet, der die Playlist abspielt.
localizations object
Das localizations-Objekt enthält Übersetzungen der Metadaten der Playlist.
localizations.(key) object
Die Sprache des lokalisierten Texts, der dem Schlüsselwert zugeordnet ist. Der Wert ist ein String, der einen BCP-47-Sprachcode enthält.
localizations.(key).title string
Der lokalisierte Playlist-Titel.
localizations.(key).description string
Die lokalisierte Playlist-Beschreibung.