Löscht ein YouTube-Video.
Kontingentauswirkung: Ein Aufruf dieser Methode hat Kontingentkosten von 50 Einheiten.
Gängige Anwendungsfälle
Anfragen
HTTP-Anfrage
DELETE https://www.googleapis.com/youtube/v3/videos
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 YouTube-Video-ID für die Ressource an, die gelöscht wird. In einer video -Ressource gibt die id -Eigenschaft die Video-ID an. |
|
Optionale Parameter | ||
onBehalfOfContentOwner |
string Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden. Hinweis: Dieser Parameter ist ausschließlich für YouTube-Contentpartner vorgesehen. Der Parameter onBehalfOfContentOwner gibt an, dass durch die Autorisierungsanmeldedaten der Anfrage ein YouTube CMS-Nutzer identifiziert wird, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Dieser Parameter ist für YouTube-Content-Partner vorgesehen, die viele verschiedene YouTube-Kanäle besitzen und verwalten. Rechteinhaber können sich nur einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Authentifizierungsdaten angeben zu müssen. Das eigentliche CMS-Konto, bei dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-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) |
forbidden |
Das Video, das du löschen möchtest, kann nicht gelöscht werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert. |
notFound (404) |
videoNotFound |
Das Video, das du löschen möchtest, kann nicht gefunden werden. Prüfen Sie, ob der Wert des id -Parameters der Anfrage korrekt ist. |
Jetzt testen
Verwenden Sie APIs Explorer, um diese API aufzurufen und die API-Anfrage und -Antwort anzusehen.