當將帶有浮水印的圖片、字幕檔案或其它素材等輔助媒體資源上傳至ApsaraVideo for VOD後,可以通過本介面依據這些輔助媒體的唯一識別碼(ID),批次更新它們的標題、描述、標籤及分類等資訊。
介面說明
一次最多支援修改 20 個輔助媒資的資訊。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
vod:UpdateAttachedMediaInfos |
update |
*全部資源
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| UpdateContent |
string |
是 |
更新內容。一次最多支援修改 20 個輔助媒資資訊。參數結構請參考下表更新內容 UpdateContent。 說明
|
[{"MediaId":"bbc65bba53f6ed90de118a7849****","Title":"標題1","Description":"描述1","Tags":"標籤1,標籤2"},{"MediaId":"f45cf4eba5cb90233389558c39****","Title2":"標題","Description2":"描述","Tags":"標籤3,標籤4"}] |
更新內容 UpdateContent
UpdateContent 的取值需要轉為 String 後作為傳入參數。
| 名稱 | 類型 | 是否必需 | 描述 |
| MediaId | String | 是 | 輔助媒資 ID。調用 CreateUploadAttachedMedia 介面後會返回。 |
| Title | String | 否 | 標題。長度不超過 128 個位元組。UTF-8 編碼。 |
| Description | String | 否 | 描述。長度不超過 1024 個位元組。UTF-8 編碼。 |
| Tags | String | 否 | 標籤。單個標籤不超過 32 位元組。最多不超過 16 個標籤。多個標籤之間使用半形逗號(,)分隔。UTF8 編碼。 |
| CateIds | String | 否 | 分類別識別碼。多個 ID 之間使用半形逗號(,)分隔。可通過以下方式擷取: 登入點播控制台,選擇組態管理 > 媒資管理配置 > 分類管理,查看分類別識別碼。 調用 AddCategory 介面建立分類時會返回。 調用 GetCategories 介面查詢分類時會返回。 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回結果。 |
||
| RequestId |
string |
請求 ID。 |
25818875-5F78-4DF6-D7393642CA58**** |
| NonExistMediaIds |
array |
不存在的輔助媒資 ID 列表。 |
|
|
string |
不存在的輔助媒資 ID 列表。 |
["bbc65bba53f6ed90de118a7849****"] |
樣本
正常返回樣本
JSON格式
{
"RequestId": "25818875-5F78-4DF6-D7393642CA58****",
"NonExistMediaIds": [
"[\"bbc65bba53f6ed90de118a7849****\"]"
]
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。