Captions: delete

Löscht einen angegebenen Untertiteltrack.

Auswirkung auf das Kontingent:Ein Aufruf dieser Methode hat Kontingentkosten in Höhe von 50 Einheiten.

Gängige Anwendungsfälle

Anfrage

HTTP-Anfrage

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

Autorisierung

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

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

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 Mit dem Parameter id wird der Untertiteltrack angegeben, der gelöscht wird. Der Wert ist die ID eines Untertitel-Tracks, die durch das id-Attribut in einer caption-Ressource angegeben wird.
Optionale Parameter
onBehalfOfContentOwner	string Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden. Hinweis:Dieser Parameter ist ausschließlich für YouTube-Inhaltspartner gedacht. Der Parameter onBehalfOfContentOwner gibt an, dass die Autorisierungsdaten der Anfrage einen YouTube CMS-Nutzer identifizieren, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Dieser Parameter richtet sich an YouTube-Contentpartner, die viele verschiedene YouTube-Kanäle haben und verwalten. So können Rechteinhaber sich einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Anmeldedaten angeben zu müssen. Das CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein.

Anfragetext

Geben Sie beim Aufruf 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 findest du unter YouTube Data API – Fehler.

Fehlertyp	Fehlerdetails	Beschreibung
forbidden (403)	forbidden	Die mit der Anfrage verknüpften Berechtigungen reichen nicht aus, um den Untertiteltrack zu löschen. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
notFound (404)	captionNotFound	Der Untertiteltrack konnte nicht gefunden werden. Prüfe den Wert des Parameters id der Anfrage, um sicherzustellen, dass er korrekt ist.

Testen!

Verwenden Sie die APIs Explorer, um diese API aufzurufen und die API-Anfrage und ‑Antwort zu sehen.