Diese Seite wurde von der Cloud Translation API übersetzt.

PlaylistItems

Eine playlistItem-Ressource identifiziert eine andere Ressource, z. B. ein Video, die in einer Playlist enthalten ist. Darüber hinaus enthält die Ressource playlistItem Details zur enthaltenen Ressource, die sich speziell darauf beziehen, wie diese Ressource in dieser Playlist verwendet wird.

YouTube verwendet außerdem eine Playlist, um die Liste der hochgeladenen Videos eines Kanals zu ermitteln, wobei jede playlistItem in dieser Liste für ein hochgeladenes Video steht. Du kannst die Playlist-ID für diese Liste aus dem channel resource des jeweiligen Kanals abrufen. Sie können dann 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 API-Anfrageparametern entsprechen. Du kannst 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.
Update: Ändert ein Playlist-Element. Du könntest zum Beispiel die Position des jeweiligen Elements in der Playlist aktualisieren. 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 angezeigt werden:

Attribute
`kind`	`string` Identifiziert den Typ der API-Ressource. Der Wert ist `youtube#playlistItem`.
`etag`	`etag` Das ETag dieser Ressource.
`id`	`string` Die ID, die YouTube verwendet, um das Playlist-Element eindeutig zu identifizieren.
`snippet`	`object` Das `snippet`-Objekt enthält grundlegende Details zum Playlist-Element, z. B. den Titel und die Position in der Playlist.
`snippet.publishedAt`	`datetime` Das Datum und die Uhrzeit, zu der das Element der Playlist hinzugefügt wurde. Der Wert wird im ISO 8601-Format angegeben.
`snippet.channelId`	`string` Die ID, mit der YouTube eindeutig den Nutzer identifiziert, der den Artikel der Playlist hinzugefügt hat.
`snippet.title`	`string` Der Titel des Elements.
`snippet.description`	`string` Die Beschreibung des Elements.
`snippet.thumbnails`	`object` Eine Übersicht mit Thumbnail-Bildern, die mit dem Playlist-Element 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 Playlist-Element gehört.
`snippet.videoOwnerChannelTitle`	`string` Der Kanaltitel des Kanals, auf dem dieses Video hochgeladen wurde.
`snippet.videoOwnerChannelId`	`string` Die Kanal-ID des Kanals, über den das Video hochgeladen wurde.
`snippet.playlistId`	`string` Die ID, mit der YouTube die Playlist, in der sich das Playlist-Element befindet, eindeutig identifiziert.
`snippet.position`	`unsigned integer` Die Reihenfolge, in der das Element in der Playlist angezeigt wird. Der Wert verwendet einen nullbasierten Index. Das erste Element hat also die Position `0`, das zweite Element die Position `1` usw.
`snippet.resourceId`	`object` Das `id`-Objekt enthält Informationen, mit denen die in der Playlist als Playlist-Element enthaltene Ressource eindeutig identifiziert werden kann.
`snippet.resourceId.kind`	`string` Die Art oder der Typ der verweisenden Ressource.
`snippet.resourceId.videoId`	`string` Wenn der Wert der `snippet.resourceId.kind`-Property `youtube#video` ist, ist diese Property vorhanden und ihr Wert enthält die ID, mit der YouTube das Video in der Playlist eindeutig identifiziert.
`contentDetails`	`object` Wenn das enthaltene Element ein YouTube-Video ist, ist das Objekt `contentDetails` in der Ressource enthalten. Das Objekt enthält zusätzliche Informationen zum Video.
`contentDetails.videoId`	`string` Die ID, mit der YouTube ein Video eindeutig identifiziert. Zum Abrufen der Ressource `video` legen Sie den Abfrageparameter `id` in Ihrer API-Anfrage auf diesen Wert fest.
`contentDetails.startAt`	`string` Hinweis:Diese Property wurde eingestellt. Wenn sie festgelegt wurde, wird ihr Wert ignoriert. Die Zeit (in Sekunden ab Beginn des Videos, zu der die Wiedergabe des Videos beginnen soll), gemessen. Der Eigentümer der Playlist kann die Zeiten festlegen, zu denen die Videowiedergabe gestartet und beendet werden soll, wenn das Video im Kontext der Playlist abgespielt wird. Der Standardwert ist `0`.
`contentDetails.endAt`	`string` Hinweis:Diese Eigenschaft wurde eingestellt. Wenn sie konfiguriert ist, wird ihr Wert ignoriert. Die Zeit in Sekunden ab Beginn des Videos, zu der die Wiedergabe des Videos beendet werden soll. Der Eigentümer der Playlist kann die Zeiten festlegen, zu denen die Videowiedergabe gestartet und beendet werden soll, wenn das Video im Kontext der Playlist abgespielt wird. Standardmäßig wird davon ausgegangen, dass `video.endTime` das Ende des Videos ist.
`contentDetails.note`	`string` Eine vom Nutzer erstellte Notiz zu diesem Artikel. Der Attributwert darf maximal 280 Zeichen lang sein.
`contentDetails.videoPublishedAt`	`datetime` Datum und Uhrzeit der Veröffentlichung des Videos auf YouTube. Der Wert wird im ISO 8601-Format angegeben.
`status`	`object` Das Objekt `status` enthält Informationen zum Datenschutzstatus des Playlist-Elements.
`status.privacyStatus`	`string` Datenschutzstatus des Playlist-Elements. Der Kanal, der das Video hochgeladen hat, das das Playlist-Element darstellt, kann diesen Wert mithilfe der Methode `videos.insert` oder `videos.update` festlegen.