PlaylistItems: delete

Löscht ein Playlistelement.

Auswirkungen auf das Kontingent:Ein Aufruf dieser Methode kostet 50 Kontingenteinheiten.

Gängige Anwendungsfälle

Anfrage

HTTP-Anfrage

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

Autorisierung

Für diese Anfrage ist eine Autorisierung mit mindestens einem der folgenden Bereiche erforderlich. Weitere Informationen zur Authentifizierung und Autorisierung finden Sie unter OAuth 2.0-Autorisierung implementieren.

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 YouTube-Playlistelement-ID für das zu löschende Playlistelement an. In einer playlistItem-Ressource gibt die Property id die ID des Playlistelements an.
Optionale Parameter
onBehalfOfContentOwner string
Hinweis: Der onBehalfOfContentOwner Parameter ist ausschließlich für YouTube-Contentpartner vorgesehen und kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden.

Dieser Parameter ist für YouTube-Contentpartner gedacht, die viele verschiedene YouTube-Kanäle besitzen und verwalten. Er ermöglicht es Nutzern, die mit dem Rechteinhaber verbunden sind, sich einmal zu authentifizieren und dann auf alle Video- und Kanaldaten des Rechteinhabers zuzugreifen und diese zu verwalten, ohne für jeden einzelnen Kanal Authentifizierungsdaten angeben zu müssen.

Wenn der Parameter vorhanden ist, gibt sein Wert einen Rechteinhaber an und die Autorisierungsdaten der Anfrage geben einen YouTube-Nutzer an, der berechtigt ist, im Namen dieses Rechteinhabers zu handeln. Das Konto, mit dem sich der Nutzer authentifiziert, muss in den YouTube Studio-Einstellungen mit dem angegebenen Contentinhaber verknüpft sein.

Anfragetext

Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.

Antwort

Bei Erfolg gibt diese Methode den HTTP-Statuscode 204 No Content zurück.

Fehler

In der folgenden Tabelle sind die Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben kann. Weitere Informationen finden Sie unter YouTube Data API – Fehler.

Fehlertyp Fehlerdetail Beschreibung
forbidden (403) playlistItemsNotAccessible Die Anfrage ist nicht ordnungsgemäß autorisiert, um das angegebene Playlistelement zu löschen.
notFound (404) playlistItemNotFound Das mit dem Parameter id der Anfrage identifizierte Playlistelement wurde nicht gefunden.
invalidValue (400) playlistOperationUnsupported Die API unterstützt das Löschen von Videos aus der angegebenen Playlist nicht. Sie können beispielsweise kein Video aus der Playlist „Hochgeladene Videos“ löschen.

Testen!

Mit dem APIs Explorer können Sie diese API aufrufen und die API-Anfrage und -Antwort ansehen.