Captions: download

Lädt einen Untertiteltrack herunter. Der Untertiteltrack wird im Originalformat zurückgegeben, es sei denn, in der Anfrage wird ein Wert für den Parameter tfmt angegeben. Er wird auch in der Originalsprache zurückgegeben, es sei denn, in der Anfrage wird ein Wert für den Parameter tlang angegeben.

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

Für diese Methode muss der Nutzer die Berechtigung haben, das Video zu bearbeiten.

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

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 Untertiteltrack an, der abgerufen wird. Der Wert ist eine Untertiteltrack-ID, wie sie durch das Attribut id 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-Content-Partner vorgesehen.

Der onBehalfOfContentOwner Parameter gibt an, dass die Autorisierungsdaten 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. So können sich Rechteinhaber einmal authentifizieren und auf alle Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Authentifizierungsdaten 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
Mit dem Parameter tfmt wird angegeben, dass der Untertiteltrack in einem bestimmten Format zurückgegeben werden soll. Wenn der Parameter nicht in der Anfrage enthalten ist, wird der Track im Originalformat zurückgegeben.

Unterstützte Werte:
  • sbv – SubViewer-Untertitel
  • scc – Scenarist Closed Caption-Format
  • srt – SubRip-Untertitel
  • ttml – Timed Text Markup Language-Untertitel
  • vtt – Web Video Text Tracks-Untertitel
tlang string
Mit dem Parameter tlang wird angegeben, dass die API-Antwort eine Übersetzung des angegebenen Untertiteltracks zurückgeben soll. Der Parameterwert ist ein zweistelliger ISO 639-1-Sprachcode, der die gewünschte Untertitelsprache angibt. Die Übersetzung wird mithilfe der maschinellen Übersetzung, z. B. Google Übersetzer, generiert.

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 ist 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 zu Fehlermeldungen.

Fehlertyp Fehlerdetail 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 Untertiteltrack-Daten konnten nicht in die angeforderte Sprache und/oder das angeforderte Format konvertiert werden. Prüfen Sie, ob die angeforderten Werte für tfmt und tlang gültig sind und ob der snippet.status des angeforderten Untertiteltracks nicht failed ist.
notFound (404) captionNotFound Der Untertiteltrack wurde nicht gefunden. Prüfen Sie den Wert des Parameters id der Anfrage, um sicherzustellen, dass er korrekt ist.

Testen!

Mit dem APIs Explorer können Sie diese API aufrufen und die API-Anfrage und -Antwort ansehen.