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