GetVideoInfos - 批量擷取音視頻資訊 -

調用本介面通過音/視頻ID批量擷取多個音視頻的標題、描述、時間長度、封面URL、狀態、建立時間、大小、截圖、分類和標籤等資訊。

介面說明

一次最多擷取 20 個音視頻的資訊。
音視頻上傳完成後，點播會對上傳完成的音視頻源檔案進行分析，因此媒資資訊是非同步產生的。可通過設定音視頻分析完成的事件通知，當接收到音視頻分析完成的事件通知後，再調用本介面擷取音視頻資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

vod:GetVideoInfos

list

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
VideoIds	string	否	音/視頻 ID 列表。多個 ID 之間使用半形逗號（,）分隔，最多支援 20 個。可通過以下方式擷取音/視頻 ID：通過控制台上傳的視頻，可登入點播控制台，選擇媒資庫 > 音/視頻查看音/視頻 ID。通過擷取視頻上傳地址和憑證介面擷取上傳地址和憑證時，音/視頻 ID 為返回參數 VideoId 的值。音/視頻上傳後，可通過搜尋媒體資訊介面查詢音/視頻 ID，為請求後返回參數 VideoId 的值。	7753d144efd8e649c6c45fe0579**,7753d144efd74d6c45fe0570**
ReferenceIds	string	否	自訂 ID 列表。由一個或多個自訂 ID 組成，多個 ID 之間使用半形逗號（,）分隔。最多支援 20 個。	123-123,1234-1234

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
RequestId	string	請求 ID。	25818875-5F78-4AF6-D7393642CA58****
NonExistVideoIds	array	不存在的音/視頻 ID 列表。
	string	不存在的音/視頻 ID 列表。	["7753d144efd8e649c6c45fe0579****"]
NonExistReferenceIds	array	不存在的自訂 ID 列表。
	string	不存在的自訂 ID 列表。	123-123
VideoList	array<object>	音/視頻資訊列表。
	object	音/視頻資訊詳情。
StorageLocation	string	音/視頻儲存地址。	out-****.oss-cn-shanghai.aliyuncs.com
CreationTime	string	音/視頻建立時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。	2017-06-26T05:38:48Z
Status	string	視頻狀態。取值： Uploading：上傳中。 UploadFail：上傳失敗。 UploadSucc：上傳完成。 Transcoding：轉碼中。 TranscodeFail：轉碼失敗。 Blocked：屏蔽。 Normal：正常。	Normal
CateId	integer	分類別識別碼。	781111****
VideoId	string	音/視頻 ID。	7753d144efd74d6c45fe0570****
DownloadSwitch	string	離線下載開關狀態，開啟離線下載功能後，則允許移動端使用者通過阿里雲播放器將視頻緩衝至本地觀看。具體操作，請參見離線下載。取值： on：開啟，允許離線下載。 off：關閉，禁止離線下載。	on
Tags	string	音/視頻標籤。多個標籤之間使用半形逗號（,）分隔。	tag1, tag2
ModificationTime	string	音/視頻的最後一次更新時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。	2017-06-26T06:38:48Z
CateName	string	分類名稱。	cate1
Description	string	音/視頻描述。	Alibaba Cloud VOD video description
AppId	string	應用 ID。	app-****
Size	integer	音/視頻源檔案大小。單位：位元組。	453
CoverURL	string	音/視頻封面 URL。	https://example.aliyundoc.com/****.jpg
TemplateGroupId	string	轉碼模板組 ID。	b4039216985f4312a5382a4ed****
Duration	number	音/視頻時間長度。單位：秒。	120
Title	string	音/視頻標題。	Alibaba Cloud VOD Video Title
Snapshots	array	視頻截圖 URL 數組。
	string	視頻截圖 URL 數組。說明本介面僅會返回視頻的封面截圖資料，通過視頻截圖功能截取的普通截圖、雪碧截圖、雪碧圖原始圖、WebVTT 截圖的截圖資料，請調用 ListSnapshots 介面查詢。	["http://example.aliyundoc.com/snapshot/**.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333","http://example.aliyundoc.com/snapshot/.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27243**",...]
StorageClass	string	媒資儲存類型。取值： Standard：標準。 IA：媒資低頻。 Archive：媒資歸檔。 ColdArchive：媒資冷歸檔。 SourceIA：源檔案低頻。 SourceArchive：源檔案歸檔。 SourceColdArchive：源檔案冷歸檔。 Changing：媒資儲存類型變更中。 SourceChanging：源檔案儲存體類型變更中。	Standard
RestoreStatus	string	媒資解凍狀態。取值： Processing：解凍中。 Success：解凍成功。 Failed：解凍失敗。	Success
RestoreExpiration	string	媒資解凍有效期間。	2023-03-30T10:14:14Z
UserData	string	自訂設定。為 JSON 字串，支援訊息回調、上傳加速等設定。更多資訊，請參見 UserData 。	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}}
ReferenceId	string	自訂 ID，僅支援小寫字母、大寫字母、數字、橫線、底線，長度 6-64 位元。使用者維度唯一。	123-123

樣本

正常返回樣本

JSON格式

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "NonExistVideoIds": [
    "[\"7753d144efd8e649c6c45fe0579****\"]"
  ],
  "NonExistReferenceIds": [
    "123-123"
  ],
  "VideoList": [
    {
      "StorageLocation": "out-****.oss-cn-shanghai.aliyuncs.com",
      "CreationTime": "2017-06-26T05:38:48Z",
      "Status": "Normal",
      "CateId": 0,
      "VideoId": "7753d144efd74d6c45fe0570****",
      "DownloadSwitch": "on",
      "Tags": "tag1, tag2",
      "ModificationTime": "2017-06-26T06:38:48Z",
      "CateName": "cate1",
      "Description": "Alibaba Cloud VOD video description",
      "AppId": "app-****",
      "Size": 453,
      "CoverURL": "https://example.aliyundoc.com/****.jpg",
      "TemplateGroupId": "b4039216985f4312a5382a4ed****",
      "Duration": 120,
      "Title": "Alibaba Cloud VOD Video Title",
      "Snapshots": [
        "[\"http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****\",\"http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27243****\",...]"
      ],
      "StorageClass": "Standard",
      "RestoreStatus": "Success",
      "RestoreExpiration": "2023-03-30T10:14:14Z",
      "UserData": "{\"MessageCallback\":{\"CallbackURL\":\"http://example.aliyundoc.com\"},\"Extend\":{\"localId\":\"*****\",\"test\":\"www\"}}",
      "ReferenceId": "123-123"
    }
  ]
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。