はじめに
動画を取り込む場合、CSV マニフェストファイルを使用して、追加のメタデータ（動画のタイトル、説明、フライト時間、ラベル、カスタムメタデータを含む）だけでなく、サムネイルファイルやクローズドキャプションファイルも指定できます。FTP または Aspera でコンテンツを取り込む場合は、CSV マニフェストファイルを使用できます。
制限事項
注:このトピックは OIS v2.5 に適用されます。
メタデータファイルの CSV 形式がサポートされる機能は、XML 形式よりも少なくなります。CSV 形式では、動画に関連付けるサムネイル（プレビュー画像）とカスタムメタデータを指定できます。XML 形式では、これらの機能と、既存の広告セットの定義の名前の関連付けがサポートされています。
メタデータの処理
metadata取り込み時にビデオに含めると、次の 2 つの方法のいずれかで Video Cloud ビデオフィールドにマッピングされます。
- デフォルトでは、
metadata各キー/値のペアは tag の形で:meta::key::value。たとえば、<ooyala:metadata name="category">cooking</ooyala:metadata>タグが生成されます。meta::category::cooking custom_fieldsメタデータの保存に使う場合は、ブライトコーブサポートがアカウントの設定を変更してそのようにすることができます。次の点に注意してください。- メタデータキーに対応する名前を持つカスタムフィールドを作成する必要があります。
- カスタムフィールドの数は既定で 10 に制限されています。そのため、メタデータを格納するためにそれ以上のカスタムフィールドが必要な場合は、サポートから追加のカスタムフィールドを要求する必要があります。
- 各メタデータ項目に対応するカスタム項目がアカウントに存在しない場合、メタデータ操作全体が失敗します。
CSV マニフェスト列の見出し
次のフィールドは、CSV ファイルの最初の行（列見出し）で、実際のデータフィールドは後続の行に続く（ビデオごとに 1 行）。
注:これらの列は任意の順序で指定でき、データ行のデータが見出しと正確に一致する限り、不要な列は省略できます。
| 列見出し | 説明 | 必須/オプション |
|---|---|---|
| 動画 | ビデオのファイル名またはビデオが配置されている URL。URLには次のものを含めることができます http：// または https：//。 | 必須 |
| タイトル | ビデオの名前またはタイトル。 | オプショナル |
| サムネイル | サムネイルのファイル名またはサムネイルが配置されている URL。 | オプショナル |
| content_type | コンテンツタイプ（ビデオまたはリモートアセット）。ビデオ列で指定されたファイル名がビデオが配置されているURLであり、リモートアセットを定義する場合は、content_type列の値を変更します（から 動画、デフォルト）から content_type = remoteeasset。 | 必須（リモートアセットのみ） |
| 説明 | ビデオの説明。 | オプショナル |
| hosted_at | ビデオを埋め込む永続的な URL。の値にマップします hosted_at リモートアセットのプロパティ。
注:リモートアセットが作成された後、さまざまな CDN への伝播が 60 秒以上遅れることがあります。リモートアセットの作成後にあまりにも早く要求すると、結果は CDN によってキャッシュされ、クリアには数分かかる場合があります。ベストプラクティス:作成後 30 秒または 60 秒待って、 Backlot API でクエリを実行します。 [GET] /v2/assets/asset_id ルートを設定し、リモートアセットの埋め込みコード（コンテンツIDまたはアセットID）を取得した後、アセットの埋め込みに進みます。 |
オプショナル |
| flight_start_time | アセットを再生できる開始時間（UTC）。例： 2011-06-01T00：00：00Z | 必須（場合のみ） flight_end_time指定） |
| flight_end_time | アセットを再生できる終了時間（UTC）。例： 2011-07-01T00：00：00Z | オプショナル |
| 期間InMs | （OS v2.5のみ）ビデオの長さを表す時間（ミリ秒単位）。必要な場合 content_type = remoteeasset。 | 必須（リモートアセットのみ） |
| ラベル | カンマで区切られた 1 つ以上のラベル。例は次のとおりです。 / sports、/ sports / jogging。 | オプショナル |
| メタデータ | ビデオのカスタムメタデータ。メタデータのタイプごとに 1 つの列を設定できます。を参照してくださいメタデータの処理上記のセクションで、メタデータがVideoCloudビデオフィールドにどのようにマッピングされるかを確認してください。 | オプショナル |
| 埋め込みコード | (予約済み)。動画アセットの Backlot 内のコンテンツ ID。 | 予約済み |
| id | 作成したアセットの外部 ID プロパティにマップします。コンテンツ ID の代わりに使用できるカスタム識別子です。 | オプショナル |
| 字幕 | クローズドキャプションファイルを指定します (DFXP ファイルでのみサポート)。次のいずれかの操作を行います。
|
オプショナル |
| subTitle：lang | (オプション)-クローズドキャプションファイルの言語。2 文字の言語コード。/td > | オプショナル |
| subTitle：frameRate | （オプション）-クローズドキャプションファイルのフレームレート。単位はフレーム/秒 (FPS) です。デフォルトは 30 です。古いクローズドキャプションファイルは 24 である可能性があります。 | オプショナル |
| profileguid | 処理プロファイルの ID。トランスコーディング中にマスタービデオを変換する必要がある形式を定義するエンコードのグループです。デフォルトの Video Cloud 取り込みプロファイルを使用しない場合は、使用するプロファイルの ID を含める必要があります。「取り込みプロファイルの管理」を参照してください。 | オプショナル |
CSV マニフェストファイルの例 (OIS v2.5)
video,title,description,labels,hosted_at,id,thumbnail,subTitle,flight_start_time,flight_end_time,profileguid
test.mp4,Test CSV,This is an example,"test,example,csv",http://www.ooyala.com,my_test_guid_csv,my_thumbnail.jpg,my_caption.dfxp,2016-01-01T15:15:00-07:00,2022-01-01T16:00:00-07:00,57d5a5a10f654fe79ef954dc8d29a108
CSV マニフェストファイルの作成
CSV メタデータファイルを生成するときは、次の点に注意してください。
- データフィールドのテキスト値にカンマ (,) が含まれている場合は、フィールドを二重引用符 (「) で囲む必要があります。
- データフィールドのテキスト値に二重引用符（「）が含まれている場合は、フィールドを二重引用符で囲み、テキストフィールドの二重引用符を2番目の引用符でエスケープする必要があります（例：「She say,「" Hae a nice day.「"」)
Excel から CSV メタデータファイルを作成している場合は、自動的にエスケープ処理が行われます。
CSVメタデータファイルを作成するには、次の手順に従います。
- 1 つ以上の動画をアップロードします。
- Microsoft Excel などのスプレッドシートプログラムを開きます。
- 最初の行に列見出しを追加します。
- ビデオごとに行を追加します。
- ファイルを CSV 形式で保存します。たとえば、[ ファイル]メニューから [ 名前を付けて保存] を選択します。プロンプトが表示されたら、カンマ区切り値のファイルタイプを選択します。
- 選択したアップロード方法で、動画をアップロードした時にCSVファイルをアップロードします。FTPまたは Aspera を参照してください。