Captions: download

Lädt einen Untertiteltrack herunter. Der Untertiteltrack wird im Originalformat zurückgegeben, sofern in der Anfrage kein Wert für den Parameter tfmt angegeben ist, und in der Originalsprache, sofern in der Anfrage kein Wert für den Parameter tlang angegeben ist.

Auswirkungen auf das Kontingent:Ein Aufruf dieser Methode hat Kontingentkosten von 200 Einheiten.

Gängige Anwendungsfälle

Anfrage

HTTP-Anfrage

GET https://www.googleapis.com/youtube/v3/captions/id

Autorisierung

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

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
Der Parameter id gibt den Untertiteltrack an, der abgerufen 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-Contentpartner 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.
tfmt string
Der Parameter tfmt gibt an, dass der Untertiteltrack in einem bestimmten Format zurückgegeben werden soll. Wenn der Parameter nicht in der Anfrage enthalten ist, wird der Titel im Originalformat zurückgegeben.

Unterstützte Werte:
  • sbv – SubViewer-Untertitel
  • scc – Scenarist Closed Caption-Format
  • srt – SubRip-Untertitel
  • ttml – Untertitel in Timed Text Markup Language
  • vtt – Untertitel für Texttracks in Webvideos
tlang string
Der Parameter tlang gibt an, dass die API-Antwort eine Übersetzung des angegebenen Untertitel-Tracks zurückgeben soll. Der Parameterwert ist ein aus zwei Buchstaben bestehender Sprachcode gemäß ISO 639-1, der die gewünschte Untertitelsprache angibt. Die Übersetzung wird mithilfe von maschinellen Übersetzungsdiensten wie Google Übersetzer erstellt.

Anfragetext

Geben Sie beim Aufruf dieser Methode keinen Anfragetext an.

Antwort

Bei Erfolg gibt diese Methode eine Binärdatei zurück. Der Content-Type-Header für die Antwort lautet application/octet-stream.

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 in der Dokumentation zur Fehlermeldung.

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Die mit der Anfrage verknüpften Berechtigungen reichen nicht aus, um den Untertiteltrack herunterzuladen. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
invalidValue (400) couldNotConvert Die Untertitel-Track-Daten konnten nicht in die gewünschte Sprache und/oder das gewünschte Format konvertiert werden. Prüfe, ob die angeforderten Werte für tfmt und tlang gültig sind und ob die snippet.status des angeforderten Untertitel-Tracks nicht failed ist.
notFound (404) captionNotFound Der Untertiteltrack konnte nicht gefunden werden. Prüfe den Wert des Parameters id der Anfrage, um sicherzustellen, dass er korrekt ist.