Captions: download

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

Kontingentauswirkung: Ein Aufruf dieser Methode hat Kontingentkosten von 200 Einheiten.

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).

Bereich
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-Track-ID, wie sie durch das Attribut 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-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.
tfmt string
Der Parameter tfmt gibt an, dass der Untertiteltrack in einem bestimmten Format zurückgegeben werden soll. Ist der Parameter nicht in der Anfrage enthalten, wird der Titel im ursprünglichen Format zurückgegeben.

Unterstützte Werte sind:
  • sbv – SubViewer-Untertitel
  • scc: Untertitelformat für Scenarist
  • srt – SubRip-Untertitel
  • ttml: Untertitel in Timed Text Markup Language
  • vtt – Untertitel für Webvideo-Text-Tracks
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 Sprache der Untertitel angibt. Die Übersetzung wird mithilfe maschineller Übersetzungen wie Google Übersetzer generiert.

Anfragetext

Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Binärdatei zurückgegeben. Der Content-Type-Header für die Antwort ist application/octet-stream.

Fehler

In der folgenden Tabelle sind Fehlermeldungen aufgeführt, 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 Die mit der Anfrage verknüpften Berechtigungen reichen nicht aus, um den Untertiteltrack herunterzuladen. Möglicherweise wurde die Anfrage nicht ordnungsgemäß autorisiert oder in der Videobestellung wurden keine Beiträge Dritter für diese Untertitel aktiviert.
invalidValue (400) couldNotConvert Die Daten des Untertiteltracks konnten nicht in die angeforderte Sprache und/oder das angeforderte Format konvertiert werden. Prüfe, ob die angeforderten tfmt- und tlang-Werte gültig sind und dass die snippet.status des angeforderten Untertitel-Tracks nicht failed ist.
notFound (404) captionNotFound Der Untertitel-Track wurde nicht gefunden. 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.