In den folgenden Beispielen wird gezeigt, wie Sie mit der YouTube Data API (Version 3) Funktionen im Zusammenhang mit Untertiteln ausführen.
Liste mit Untertiteln für ein Video abrufen
Mit der Methode captions.list
kannst du eine Liste von Untertiteln abrufen, die für ein bestimmtes Video verfügbar sind. Legen Sie den Parameterwert videoId
auf die YouTube-Video-ID fest, die das Video, für das Sie Untertitel abrufen, eindeutig identifiziert. Ihre Anfrage muss mit OAuth 2.0 autorisiert werden.
Mit der folgenden Anfrage wird eine Liste mit Untertiteln für ein Video im YouTube-Kanal von Google Stories abgerufen:
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.list? part=snippet &videoId=PRU2ShMzQRg
Codebeispiele finden Sie in der Dokumentation zur Methode captions.list
.
Untertitel-Track erstellen
Diese Abfrage kann nicht mit APIs Explorer getestet werden, da APIs Explorer keine Möglichkeit zum Hochladen von Dateien unterstützt, was für diese Methode erforderlich ist.
Du kannst die API-Methode captions.insert
verwenden, um einen neuen Untertiteltrack für ein Video hochzuladen. Beim Hochladen eines Tracks müssen Sie einen Wert für die folgenden caption
-Ressourcenattribute angeben:
snippet.videoId
: Damit wird das Video identifiziert, dem der Untertiteltrack hinzugefügt wird.snippet.language
: Die Sprache des Untertiteltracks.snippet.name
: Der Name des Untertiteltracks.
Die folgenden zusätzlichen Optionen stehen beim Hochladen eines Untertiteltracks zur Verfügung:
-
Wenn du den Parameter
sync
auftrue
setzt, ignoriert YouTube alle Timecodes, die sich in der hochgeladenen Untertiteldatei befinden, und generiert neue Timecodes für die Untertitel.Du solltest den Parameter
sync
auftrue
setzen, wenn du ein Transkript ohne Zeitcodes hochlädst oder wenn du vermutest, dass die Timecodes in deiner Datei falsch sind und wenn YouTube versuchen soll, sie zu beheben. -
Wenn du die Eigenschaft
snippet.isDraft
der Ressourcecaption
auftrue
setzt, ist der Titel nicht öffentlich sichtbar.
Codebeispiele finden Sie in der Dokumentation zur Methode captions.insert
.
Untertiteltrack herunterladen
Diese Abfrage kann nicht mit APIs Explorer getestet werden, da APIs Explorer keine Möglichkeit zum Herunterladen von Dateien unterstützt.
Rufe die Methode captions.download
auf, um einen bestimmten Untertiteltrack herunterzuladen. Setze den Wert des Parameters id
auf die ID des YouTube-Untertiteltracks, der den heruntergeladenen Untertiteltrack eindeutig identifiziert. Ihre Anfrage muss mit OAuth 2.0 autorisiert werden.
Die API v3 unterstützt die folgenden Optionen:
-
Wenn du angeben möchtest, dass ein Untertiteltrack in einem bestimmten Format zurückgegeben werden soll, setze den Parameterwert
tfmt
auf das gewünschte Format. In der Parameterdefinition werden unterstützte Werte aufgeführt. -
Wenn du eine Übersetzung eines Untertiteltracks abrufen möchtest, setze den Parameterwert
tlang
auf einen aus zwei Buchstaben bestehenden ISO 639-1-Sprachcode, der die gewünschte Untertitelsprache angibt. Die Übersetzung wird mithilfe von maschineller Übersetzung wie Google Übersetzer generiert.
Codebeispiele finden Sie in der Dokumentation zur Methode captions.download
.
Untertiteltrack aktualisieren
Die API unterstützt die Möglichkeit, den Entwurfsstatus eines Untertitel-Tracks zu ändern, einen neuen Untertitel-Track für eine Datei hochzuladen oder beides.
Mit APIs Explorer können Sie testen, wie sich der Entwurfsstatus eines Titels ändern lässt. Sie können den APIs Explorer jedoch nicht zum Aktualisieren der eigentlichen Untertitel verwenden, da das Tool das Hochladen von Dateien nicht unterstützt.
Mit der folgenden Anfrage wird eine Liste mit Untertiteln für ein Video im YouTube-Kanal von Google Stories abgerufen:
Durch die Anfrage wird der Entwurfsstatus eines Untertitel-Tracks auf true
aktualisiert. Der Track ist daher nicht öffentlich sichtbar. Zum Abschließen der Anfrage im APIs Explorer musst du den Wert der Eigenschaft id
festlegen, um einen Untertitel-Track zu identifizieren.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.update? part=snippet
Codebeispiele finden Sie in der Dokumentation zur Methode captions.update
.
Untertiteltrack löschen
In diesem Beispiel wird gezeigt, wie ein Untertiteltrack gelöscht wird. Das Beispiel umfasst die folgenden Schritte:
-
Schritt 1: ID des Untertitel-Tracks abrufen
Führe die oben beschriebenen Schritte aus, um eine Liste der Untertitel für ein Video abzurufen. Die Liste könnte verwendet werden, um eine Liste von Untertiteln anzuzeigen, wobei die ID der einzelnen Titel als Schlüssel verwendet wird.
-
Schritt 2: Titel löschen
Rufen Sie die Methode
captions.delete
auf, um ein bestimmtes Video zu löschen. In der Anfrage gibt der Parameterid
die ID des Untertitel-Tracks an, den du löschst. Die Anfrage muss mit OAuth 2.0 autorisiert werden. Wenn du diese Abfrage im APIs Explorer testest, musst du für den Parameterwertid
eine gültige Untertitel-ID ersetzen.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.delete? id=CAPTION_TRACK_ID