Captions: download

Lädt einen Untertiteltrack herunter. Der Untertitel-Track wird in seinem Originalformat zurückgegeben, es sei denn, in der Anfrage wird ein Wert für den Parameter tfmt und in der Originalsprache angegeben, sofern in der Anfrage kein Wert für den Parameter tlang angegeben ist.

Auswirkungen auf Kontingente: Bei einem Aufruf dieser Methode fallen Kontingentkosten von 200 Einheiten an.

Gängige Anwendungsfälle

Anfragen

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 abgerufenen Untertiteltrack an. Der Wert ist eine Untertitel-ID, die von der Eigenschaft id in einer caption-Ressource identifiziert 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-Content-Partner vorgesehen.

Der Parameter onBehalfOfContentOwner gibt an, dass die Autorisierungsanmeldedaten der Anfrage einen YouTube CMS-Nutzer identifizieren, 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 einmalig authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Anmeldedaten zur Authentifizierung angeben zu müssen. Das tatsächliche 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 in seinem ursprünglichen Format zurückgegeben.

Unterstützte Werte sind:
  • sbv: Untertitel von SubViewer
  • scc – Untertitelformat für Scenarist
  • srt – Untertiteluntertitel
  • ttml – Untertitel für zeitbasierte Text-Markup-Sprache
  • vtt – Untertitel für Webvideo-Texttracks
tlang string
Der Parameter tlang gibt an, dass die API-Antwort eine Übersetzung des angegebenen Untertiteltracks zurückgeben soll. Der Parameterwert ist ein aus zwei Buchstaben bestehender ISO 639-1-Sprachcode, der die gewünschte Untertitelsprache angibt. Die Übersetzung wird mithilfe von maschineller Übersetzung wie Google Übersetzer generiert.

Anfragetext

Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.

Antwort

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

Fehler

Die folgende Tabelle enthält Fehlermeldungen, die von der API möglicherweise als Antwort auf einen Aufruf dieser Methode zurückgegeben werden. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Die mit der Anfrage verknüpften Berechtigungen reichen zum Herunterladen des Untertitel-Tracks nicht aus. Möglicherweise ist die Anfrage nicht ordnungsgemäß autorisiert oder der Videoauftrag hat keine Untertitelbeiträge von Dritten aktiviert.
invalidValue (400) couldNotConvert Die Untertiteldaten konnten nicht in die angeforderte Sprache und/oder das gewünschte Format konvertiert werden. Achte darauf, dass die angeforderten Werte für tfmt und tlang gültig sind und der Wert für snippet.status des angeforderten Untertiteltracks nicht failed ist.
notFound (404) captionNotFound Der Untertiteltrack wurde nicht gefunden. Prüfen Sie, ob der Wert des id-Parameters korrekt ist.

Testen!

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