Captions: insert

Hier kannst du einen Untertiteltrack hochladen.

Diese Methode unterstützt den Medienupload. Hochgeladene Dateien müssen den folgenden Einschränkungen entsprechen:

  • Maximale Dateigröße:100 MB
  • Zulässige MIME-Typen für Medien:text/xml, application/octet-stream, */*

Auswirkung auf das Kontingent:Ein Aufruf dieser Methode hat Kontingentkosten von 400 Einheiten.

Gängige Anwendungsfälle

Anfrage

HTTP-Anfrage

POST https://www.googleapis.com/upload/youtube/v3/captions

Autorisierung

Für diese Anfrage ist eine Autorisierung mit mindestens einem der folgenden Bereiche erforderlich. Weitere Informationen zu Authentifizierung und Autorisierung finden Sie unter OAuth 2.0-Autorisierung implementieren.

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
part string
Mit dem Parameter part werden die caption-Ressourcenteile angegeben, die in der API-Antwort enthalten sein sollen. Legen Sie den Parameterwert auf snippet fest.

Die folgende Liste enthält die part-Namen, die Sie in den Parameterwert aufnehmen können:
  • id
  • snippet
Optionale Parameter
onBehalfOfContentOwner string
Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden.

Hinweis:Dieser Parameter ist ausschließlich für YouTube-Inhaltspartner gedacht.

Der Parameter onBehalfOfContentOwner gibt an, dass die Autorisierungsdaten der Anfrage einen YouTube CMS-Nutzer identifizieren, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Dieser Parameter richtet sich an YouTube-Contentpartner, die viele verschiedene YouTube-Kanäle haben und verwalten. So können Rechteinhaber sich einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Anmeldedaten angeben zu müssen. Das CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein.
sync boolean
Dieser Parameter wird nicht mehr unterstützt. Der Parameter sync gibt an, ob YouTube die Untertiteldatei automatisch mit dem Audiotrack des Videos synchronisieren soll. Wenn du den Wert auf true setzt, ignoriert YouTube alle Zeitcodes in der hochgeladenen Untertiteldatei und generiert neue Zeitcodes für die Untertitel.

Du solltest den Parameter sync auf true setzen, wenn du ein Transkript hochlädst, das keine Zeitcodes enthält, oder wenn du vermutest, dass die Zeitcodes in deiner Datei falsch sind und YouTube sie korrigieren soll.

Anfragetext

Geben Sie im Anfragetext eine caption-Ressource an. Für diese Ressource gilt:

Sie müssen einen Wert für die folgenden Properties angeben:

  • snippet.videoId
  • snippet.language
  • snippet.name

Sie können Werte für die folgenden Properties festlegen:

  • snippet.videoId
  • snippet.language
  • snippet.name
  • snippet.isDraft

Antwort

Bei Erfolg gibt diese Methode eine caption-Ressource im Antworttext zurück.

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 findest du unter YouTube Data API – Fehler.

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) contentRequired Die Anfrage enthält nicht den Inhalt des Untertitel-Tracks.
conflict (409) captionExists Für das angegebene Video gibt es bereits einen Untertiteltrack mit den angegebenen snippet.language und snippet.name. Ein Video kann mehrere Tracks für dieselbe Sprache haben, aber jeder Track muss einen anderen Namen haben.

Es gibt mehrere Möglichkeiten, den Fehler zu beheben. Sie können den vorhandenen Titel löschen und dann einen neuen einfügen oder den Namen des neuen Titels ändern, bevor Sie ihn einfügen.
forbidden (403) forbidden Die mit der Anfrage verknüpften Berechtigungen reichen nicht aus, um den Untertiteltrack hochzuladen. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
invalidValue (400) invalidMetadata Die Anfrage enthält ungültige Metadatenwerte, die das Erstellen des Tracks verhindern. Prüfen Sie, ob in der Anfrage gültige Werte für die Properties snippet.language, snippet.name und snippet.videoId angegeben sind. Die Property snippet.isDraft kann auch enthalten sein, ist aber nicht erforderlich.
notFound (404) videoNotFound Das mit dem Parameter videoId angegebene Video konnte nicht gefunden werden.
invalidValue (400) nameTooLong Die in der Anfrage angegebene snippet.name ist zu lang. Er darf höchstens 150 Zeichen lang sein.

Testen!

Verwenden Sie die APIs Explorer, um diese API aufzurufen und die API-Anfrage und ‑Antwort zu sehen.