PlaylistItems: delete

Löscht ein Playlist-Element.

Kontingentauswirkung: Ein Aufruf dieser Methode hat Kontingentkosten von 50 Einheiten.

Gängige Anwendungsfälle

Anfragen

HTTP-Anfrage

DELETE https://www.googleapis.com/youtube/v3/playlistItems

Autorisierung

Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).

Bereich
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parameter

In der folgenden Tabelle sind die Parameter aufgeführt, die von dieser Abfrage unterstützt werden. Alle aufgeführten Parameter sind Abfrageparameter.

Parameter
Erforderliche Parameter
id string
Der Parameter id gibt die Element-ID der YouTube-Playlist für das Playlist-Element an, das gelöscht wird. In einer playlistItem-Ressource gibt die id-Eigenschaft die ID des Playlist-Elements an.
Optionale Parameter
onBehalfOfContentOwner string
Hinweis:Der Parameter onBehalfOfContentOwner ist ausschließlich für YouTube-Contentpartner gedacht und kann nur in einer entsprechend autorisierten Anfrage verwendet werden.

Dieser Parameter wurde für YouTube-Contentpartner entwickelt, die viele verschiedene YouTube-Kanäle haben und verwalten. Nutzer, die mit dem Rechteinhaber verbunden sind, können sich einmal authentifizieren und dann auf alle Video- und Kanaldaten des Rechteinhabers zugreifen und diese verwalten, ohne für jeden einzelnen Kanal Anmeldedaten zur Authentifizierung angeben zu müssen.

Wenn der Parameter vorhanden ist, identifiziert sein Wert einen Rechteinhaber und anhand der Autorisierungsdaten der Anfrage wird ein YouTube-Nutzer identifiziert, der berechtigt ist, im Namen dieses Rechteinhabers zu handeln. Das Konto, mit dem sich der Nutzer authentifiziert, muss in den Einstellungen von YouTube Studio mit dem angegebenen Rechteinhaber verknüpft sein.

Anfragetext

Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode ein HTTP-204-Antwortcode (No Content) zurückgegeben.

Fehler

In der folgenden Tabelle finden Sie Fehlermeldungen, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben könnte. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) playlistItemsNotAccessible Die Anfrage ist nicht berechtigt, das angegebene Playlist-Element zu löschen.
notFound (404) playlistItemNotFound Das Playlist-Element, das mit dem id-Parameter der Anfrage identifiziert wurde, wurde nicht gefunden.
invalidValue (400) playlistOperationUnsupported Die API unterstützt das Löschen von Videos aus der angegebenen Playlist nicht. So kannst du beispielsweise kein Video aus der Playlist „Hochgeladene Videos“ löschen.

Jetzt testen

Verwenden Sie APIs Explorer, um diese API aufzurufen und die API-Anfrage und -Antwort anzusehen.