聯繫支持
系統狀況
簡介
提取視頻時，您可以使用CSV清單文件來指定其他元數據（包括視頻標題，說明，飛行時間，標籤和自定義元數據）以及縮略圖文件和隱藏式字幕文件。通過FTP或Aspera提取內容時，可以使用CSV清單文件。
限制
注意：本主題適用於 OIS v2.5。
元數據文件的CSV格式支持的功能少於XML格式。CSV格式允許您指定縮略圖（預覽圖像）和自定義元數據以與視頻相關聯。XML格式支持這些功能以及現有廣告集定義名稱的關聯。
中繼資料的處理
如果您在內嵌視訊時加入影片，則會以下列兩種方式之一對應至 Video Cloud 視訊欄位：metadata
- 默認情況下，每個
metadata鍵/值對被添加為標籤的形式：meta::key::value。例如，<ooyala:metadata name="category">cooking</ooyala:metadata>會產生標籤meta::category::cooking - 如果您寧願使用
custom_fields儲存中繼資料，Brightcove 支援可以變更您帳戶上的設定來執行此動作。請注意下列事項：- 您將需要建立自訂欄位，其名稱對應於您的中繼資料金鑰。
- 根據預設，自訂欄位的數量限制為 10 個，因此如果您需要更多的時間來容納您的中繼資料，您將需要向支援請求額外的自訂欄位。
- 如果您的帳戶中不存在與每個中繼資料項目對應的自訂欄位，則整個中繼資料作業將會失敗。
CSV 資訊清單資料欄標題
以下字段是CSV文件的第一行（列標題），隨後的行（每個視頻一行）後面是實際的數據字段。
注意：您可以按任何順序指定這些列，並且可以省略不需要的列，只要數據行中的數據與標題完全匹配即可。
| 列標題 | 描述 | 必要/選擇性 |
|---|---|---|
| video | 視頻的文件名或視頻所在的URL。URL 可以包含http://或https://。 | 必需的 |
| title | 影片的名稱或標題。 | 可選的 |
| thumbnail | 縮略圖的文件名或縮略圖所在的URL。 | 可選的 |
| content_type | 內容類型（視頻或遠程資產）。如果在video列中指定的文件名是視頻所在的URL，並且要定義遠程資產，請更改content_type列的值（從video，默認）content_type=remoteasset。 | 必要 (僅限遠端資產) |
| description | 影片說明。 | 可選的 |
| 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 | 可選的 |
| durationInMs | （僅限OS v2.5）表示視頻長度的持續時間（以毫秒為單位）。何時需要content_type=remoteasset。 | 必要 (僅適用於遠端資產) |
| labels | 一個或多個標籤，用逗號分隔。例如：/sports,/sports/jogging。 | 可選的 |
| metadata | 視訊的自訂中繼資料。您可以為每種類型的元數據創建一列。見元數據的處理部分，以了解元數據如何映射到“視頻雲”視頻字段。 | 可選的 |
| embed_code | （保留）。視頻資產背景中的Content ID。 | 保留的 |
| id | 映射到創建的資產的外部ID屬性：您定義的自定義標識符，可以用來代替內容ID。 | 可選的 |
| subTitle | 指定一個隱藏字幕文件（僅支持DFXP文件）。下列其中一項：
看到攝取隱藏式字幕文件。 |
可選的 |
| subTitle:lang | （可選）-隱藏字幕文件的語言。兩字母的語言代碼。/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元數據文件時，請牢記以下幾點：
- 如果數據字段中的文本值帶有逗號（，），則必須將該字段括在雙引號（“）中。
- 如果數據字段中的文本值中包含雙引號（“），則必須將該字段括在雙引號中，並在文本字段中用第二個引號將雙引號字符轉義（例如，“她說，”美好的一天。””” ）
如果要通過Excel創建CSV元數據文件，它將自動處理轉義。
要創建CSV元數據文件：