Implementierung: Untertitel

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:

Die folgenden zusätzlichen Optionen stehen beim Hochladen eines Untertiteltracks zur Verfügung:

  • Wenn du den Parameter sync auf true 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 auf true 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 Ressource caption auf true 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: