done oder failed ist.
Bevor Sie beginnen
- Verbinden und autorisieren Sie Ihren YouTube-Kanal in Vozo. Wenn die Verbindung abgelaufen ist, autorisieren Sie sie erneut, bevor Sie einen Export erstellen.
- Sie benötigen Zugriff auf die Vozo-API, einen für Ihr Konto aktivierten YouTube-Export und einen Studio-Plan oder höher.
- Die Vozo-Quell-Task muss demselben Benutzer gehören und abgeschlossen sein. Ihre Videodatei muss noch verfügbar sein.
- Die Veröffentlichung auf YouTube unterliegt sowohl dem 24-Stunden-Exportkontingent Ihres Kontos als auch einem Systemkontingent.
- Verwenden Sie einen API-Schlüssel im Header
Authorization: Bearer <api_key>.
Workflow
1
Videokategorien abrufen
Rufen Sie Kategorien auflisten auf, um eine für die Region Ihres verbundenen Kanals gültige
category_id zu erhalten. Es werden nur zuweisbare Kategorien zurückgegeben.2
Einen Export erstellen
Rufen Sie Export-Task erstellen mit der abgeschlossenen Quell-Task, dem Titel, der Kategorie und der Datenschutzeinstellung auf. Bewahren Sie die zurückgegebene
task_id auf: Sie identifiziert den YouTube-Export, nicht die ursprüngliche Vozo-Task.3
Die Export-Task abfragen
Rufen Sie Export-Task abrufen mit der Export-Task-ID auf. Sobald
status done ist, verwenden Sie studio_url, um das Video in YouTube Studio zu öffnen. Wenn der Status failed ist, prüfen Sie error_code.Quell-Tasks und Modi
Für Übersetzen & Synchronisieren und Visuelle Übersetzung ist
source_mode erforderlich, wenn die Quell-Task ein bearbeitbares Projekt hat. Bei einer nicht bearbeitbaren Quell-Task wird durch Weglassen initial_output ausgewählt. generate_new und use_existing erfordern das zugehörige bearbeitbare Projekt; use_existing erfordert außerdem ein bereits exportiertes Video. initial_output erfordert eine Videoausgabe aus der Quell-Task.
Exportstatus
Diese Endpunkte erstellen oder autorisieren keine YouTube-Verbindung. Schließen Sie diese Einrichtung in Vozo ab, bevor Sie die Export-API verwenden.
Häufige API-Fehler
Bei anderen Fehlern prüfen Sie die Felder
code, message und optional errors in der Antwort. Eine Veröffentlichungs-Task kann auch nach ihrer Erstellung den Status failed erreichen; fragen Sie für diesen Fall ihren error_code ab.