Playlists

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
Genauer gesagt sind diese Listen mit einem Kanal verknüpft. Dabei handelt es sich um eine Sammlung der Videos, Playlists und anderen YouTube-Informationen einer Person, Gruppe oder eines Unternehmens. Du kannst die Playlist-IDs für jede dieser Listen im 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:
  • default: Das Standard-Thumbnail. Das Standard-Thumbnail für ein Video – oder eine Ressource, die auf ein Video verweist, z. B. ein Playlist-Element oder ein Suchergebnis – ist 120 Pixel breit und 90 Pixel hoch. Das Standard-Thumbnail für einen Kanal 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 sich auf ein Video bezieht) ist dieses Bild 320 Pixel breit und 180 Pixel hoch. Dieses Bild eines Kanals ist 240 Pixel breit und 240 Pixel hoch.
  • high: Eine Version des Thumbnails mit hoher Auflösung. Bei einem Video (oder einer Ressource, die sich auf ein Video bezieht) ist dieses Bild 480 Pixel breit und 360 Pixel hoch. Dieses Bild eines Kanals ist 800 Pixel breit und 800 Pixel hoch.
  • standard: Das Thumbnail-Bild hat eine höhere Auflösung als das Bild mit einer Auflösung von 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: Das Thumbnail-Bild mit der höchsten Auflösung. Diese Bildgröße ist für einige Videos und andere Ressourcen verfügbar, die sich auf Videos beziehen, wie 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
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.
  • Lokalisierter Text wird im Ressourcen-Snippet zurückgegeben, wenn bei 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 oder ein Wert angegeben ist, aber für die angegebene Sprache keine lokalisierten Metadaten verfügbar sind.
Die Eigenschaft enthält einen schreibgeschützten Wert. Mit dem 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:
  • private
  • public
  • unlisted
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.