(以下內容均翻譯自英文版文件,最新資訊及內容敬請切換至英文語系參考原文)
後設資料是可為影片提供的附加資訊,可根據各種屬性對影片進行分類、管理和搜索。
關於Metadata
簡短說明
short_description
欄位是一個字符串,用於提供簡明的影片摘要。它應限制在 100 個字元以內,包括字母、數字、空格、標點符號和特殊符號。該欄位通常用於提供影片的快速概述。
詳細說明
long_description
欄位是一個字符串,用於提供更詳細的影片描述。它不應超過 200 個字元,包含字母、數字、空格、標點符號和特殊符號。該欄位可用於提供額外的上下文、背景資訊或其他相關細節。
標籤
labels
欄位是一個對象數組,用以補充影片的後設資料。每個標籤對象都包含一個 name
欄位,這是一個指定標籤名稱的字符串。標籤的作用是根據影片的屬性對其進行分類和組織管理,幫助搜索和篩選操作。每個標籤的最大長度為 20 個字元,一個影片最多可分配 20 個標籤。
以下是一個使用表格展示Metadata的範例:
欄位 | 類型 | 描述 | 限制 |
short_description | string | 影片摘要(不超過 100 個字元) | 最多 100 個字元(含空格和符號) |
long_description | string | 更詳細的影片介紹 | 最多 200 個字元(含空格和符號) |
labels | array | 用於分類的補充後設資料對象 | 最多 20 個標籤,每個標籤不超過 20 個字元 |
通過有效利用後設資料,VOD 平台可以提高內容的可發現性和組織性,改善整體的用戶體驗。
更新Metadata
要編輯特定影片的Metadata,您可以使用以下 API:
PUT /bv/cms/v1/vods/{id}
您必須提供 id
參數來指定要更新的影片。您需要將包含已修改屬性的 metadata
對象與請求一起提交。
以下是請求內容的範例:
"metadata":{ "short_description":"Updated short description", "long_description":"Updated long description", "labels":[ { "name":"Updated label 1" }, { "name":"Updated label 2" } ] }