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. Standardmäßig sind Playlists öffentlich für andere Nutzer sichtbar, aber Playlists können öffentlich oder privat sein.

YouTube verwendet auch Playlists, um bestimmte Videosammlungen für einen Kanal zu identifizieren. Beispiele:

• Hochgeladene Videos
• Positiv bewertete Videos

Genauer gesagt sind diese Listen einem Kanal zugeordnet. Dieser Kanal ist eine Sammlung von Videos, Playlists und anderen YouTube-Informationen einer Person, einer Gruppe oder eines Unternehmens. Du kannst die Playlist-IDs für jede dieser Listen aus der 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 aus den Listen hinzufügen oder 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, deren Inhaber der authentifizierte Nutzer ist, oder eine oder mehrere Playlists anhand ihrer eindeutigen IDs abrufen. Hier kannst du die Funktion ausprobieren.

Einfügen

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
  },
  "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, der die Playlist veröffentlicht hat, eindeutig identifiziert.
snippet.title	string Der Titel der Playlist.
snippet.description	string Die Beschreibung der Playlist.
snippet.thumbnails	object Eine Karte mit Thumbnails, die mit der Playlist verknüpft sind. Für jedes Objekt auf der Karte ist der Schlüssel der Name der Miniaturansicht und der Wert 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 der Miniaturansicht mit einer höheren Auflösung. Bei einem Video (oder einer Ressource, die sich auf ein Video bezieht) ist dieses Bild 320 Pixel breit und 180 Pixel hoch. Bei einem Kanal ist dieses Bild 240 Pixel breit und 240 Pixel hoch. high: Eine hochauflösende Version der Miniaturansicht. Bei einem Video (oder einer Ressource, die sich auf ein Video bezieht) ist dieses Bild 480 Pixel breit und 360 Pixel hoch. Bei einem Kanal ist dieses Bild 800 Pixel breit und 800 Pixel hoch. standard: Eine noch höhere Auflösung der Miniaturansicht als die 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: Die Version mit der höchsten Auflösung der Miniaturansicht. 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 Bild-URL.
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. Der Playlist zugeordnete 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 in der playlists.list-Anfrage der Parameter hl verwendet wurde, um eine Sprache anzugeben, 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 ein hl-Parameterwert nicht angegeben ist oder ein Wert angegeben ist, aber keine lokalisierten Metadaten für die angegebene Sprache verfügbar sind. Die Property enthält einen schreibgeschützten Wert. Mit dem Objekt localizations 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 Beschreibung der Playlist.
status	object Das status-Objekt enthält Statusinformationen für die Playlist.
status.privacyStatus	string Der Datenschutzstatus der Playlist. Für diese Property sind folgende Werte gültig: 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, mit denen du die Playlist in einem eingebetteten Player wiedergeben kannst.
player.embedHtml	string Ein <iframe>-Tag, das einen Player einbettet, der die Playlist wiedergibt.
localizations	object Das Objekt localizations enthält die Übersetzungen der Metadaten der Playlist.
localizations.(key)	object Die Sprache des lokalisierten Texts, der dem Schlüssel/Wert-Paar zugeordnet ist. Der Wert ist ein String mit einem BCP-47-Sprachcode.
localizations.(key).title	string Der lokalisierte Titel der Playlist.
localizations.(key).description	string Die lokalisierte Beschreibung der Playlist.