done または failed になるまでポーリングしてください。
始める前に
- Vozo で YouTube チャンネルを接続して認可してください。接続の有効期限が切れている場合は、エクスポートを作成する前に再認可してください。
- Vozo API へのアクセス権、アカウントで有効化された YouTube エクスポート機能、そして Studio プラン以上が必要です。
- 元の Vozo タスクは同じユーザーに属し、完了している必要があります。その動画ファイルが引き続き利用可能である必要もあります。
- YouTube への公開は、アカウントの 24 時間あたりのエクスポート上限とシステム上限の両方の対象となります。
Authorization: Bearer <api_key>ヘッダーで API キーを使用してください。
ワークフロー
1
動画カテゴリを取得
接続済みチャンネルの地域で有効な
category_id を取得するには、List categories を呼び出します。返されるのは割り当て可能なカテゴリのみです。2
エクスポートを作成
完了した元タスク、タイトル、カテゴリ、公開設定を指定して Create export task を呼び出します。返された
task_id は保持してください。これは元の Vozo タスクではなく、YouTube エクスポート を識別します。3
エクスポートタスクをポーリング
エクスポートタスク ID を使用して Get export task を呼び出します。
status が done になったら、studio_url を使用して YouTube Studio で動画を開きます。failed の場合は、error_code を確認してください。元タスクとモード
翻訳＆吹き替え と ビジュアル翻訳 では、元タスクに編集可能なプロジェクトがある場合、
source_mode が必須です。編集不可の元タスクでは、これを省略すると initial_output が選択されます。generate_new と use_existing には関連する編集可能プロジェクトが必要で、use_existing には既存のエクスポート済み動画も必要です。initial_output には元タスクの動画出力が必要です。
エクスポートステータス
これらのエンドポイントは YouTube 接続の作成や認可を行いません。エクスポート API を使用する前に、その設定を Vozo で完了してください。
よくある API エラー
その他の失敗については、レスポンスの
code、message、および任意の errors フィールドを確認してください。公開タスクは作成後に failed になる場合もあります。その結果については error_code を照会してください。