批量修改音視頻信息。
接口說明
使用說明
- 通過音/視頻 ID 來定位視頻，支持修改音/視頻的標題、標簽、描述等信息，傳入參數則更新相應字段，否則該字段不會被覆蓋或更新。
- 一次最多支持修改 20 個音/視頻的信息。
QPS 限制
本接口的單用戶 QPS 限制為 30 次/秒。超過限制，API 調用會被限流，這可能會影響您的業務，請合理調用。更多信息，請參見 QPS 限制。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| vod:UpdateVideoInfos | update | *全部資源 * |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| UpdateContent | string | 是 | 更新內容。一次最多支持修改 20 個音/視頻的信息，多個音/視頻對象信息之間以英文逗號（,）分隔，一次更新超過 20 個將更新失敗并報錯 | [{"VideoId":"f45cf4eba5cb90233389558c39****","Title":"測試標題1"},{"VideoId":"f45cf4eba5c84233389558c36****","Title":"測試標題2"}] |
更新內容 UpdateContent
說明
UpdateContent 的取值需要轉為 String 后作為傳入參數。
| 名稱 | 類型 | 是否必需 | 描述 |
|---|---|---|---|
| VideoId | String | 是 | 音/視頻 ID。可通過以下方式獲取： 通過控制臺上傳的音/視頻，可登錄點播控制臺，選擇媒資庫 > 音/視頻查看音/視頻 ID。 通過獲取視頻上傳地址和憑證接口獲取上傳地址和憑證時，音/視頻 ID 為返回參數 VideoId 的值。 音/視頻上傳后，可通過搜索媒體信息接口查詢音/視頻 ID，為請求后返回參數 VideoId 的值。 |
| Title | String | 否 | 音/視頻標題。 |
| Description | String | 否 | 音/視頻描述。 |
| Tags | String | 否 | 圖片標簽。單個標簽不超過 32 字節。最多不超過 16 個標簽。多個標簽之間用半角逗號（,）分隔。UTF8 編碼。 |
| CoverURL | String | 否 | 音/視頻封面 URL。 |
| CateId | Long | 否 | 分類 ID。可通過以下方式獲取： 登錄點播控制臺，選擇配置管理 > 媒資管理配置 > 分類管理查看分類 ID。 通過創建分類接口創建分類時，分類 ID 為返回參數 CateId 的值。 通過獲取分類及子分類接口查詢分類時，為請求后返回參數 CateId 的值。 |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "25818875-5F78-4AF6-D7393642CA58****",
"ForbiddenVideoIds": [
"f45cf4eba5c84233389558c36****"
],
"NonExistVideoIds": [
"f45cf4eba5cb90233389558c39****"
]
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|
暫無變更歷史