PlaylistItems

Eine playlistItem-Ressource identifiziert eine andere Ressource, z. B. ein Video, das in einer Playlist enthalten ist. Außerdem enthält die Ressource playlistItem Details zur enthaltenen Ressource, die sich speziell darauf beziehen, wie diese Ressource in der Playlist verwendet wird.

YouTube verwendet auch eine Playlist, um die Liste der hochgeladenen Videos eines Kanals zu identifizieren. Jedes playlistItem in dieser Liste steht für ein hochgeladenes Video. Sie können die Playlist-ID für diese Liste aus der channel-Ressource für einen bestimmten Kanal abrufen. Anschließend können Sie die Methode playlistItems.list für die Liste verwenden.

Methoden

Die API unterstützt die folgenden Methoden für playlistItems-Ressourcen:

list

Gibt eine Sammlung von Playlist-Elementen zurück, die den Parametern der API-Anfrage entsprechen. Sie können alle Playlist-Elemente in einer bestimmten Playlist oder ein oder mehrere Playlist-Elemente anhand ihrer eindeutigen IDs abrufen. Hier kannst du die Funktion ausprobieren.

insert

Fügt einer Playlist eine Ressource hinzu. Hier kannst du die Funktion ausprobieren.

Aktualisierung

Ändert ein Playlist-Element. Sie könnten beispielsweise die Position des Elements in der Playlist ändern. Hier kannst du die Funktion ausprobieren.

Delete

Löscht ein Playlist-Element. Hier kannst du die Funktion ausprobieren.

Ressourcendarstellung

Die folgende JSON-Struktur zeigt das Format einer playlistItems-Ressource:

{
  "kind": "youtube#playlistItem",
  "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,
    "videoOwnerChannelTitle": string,
    "videoOwnerChannelId": string,
    "playlistId": string,
    "position": unsigned integer,
    "resourceId": {
      "kind": string,
      "videoId": string,
    }
  },
  "contentDetails": {
    "videoId": string,
    "startAt": string,
    "endAt": string,
    "note": string,
    "videoPublishedAt": datetime
  },
  "status": {
    "privacyStatus": string
  }
}

Attribute

In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource enthalten sind: