全部產品
Search

搜尋本產品

    ApsaraVideo VOD：搜尋媒資資訊

    文件中心

    ApsaraVideo VOD：搜尋媒資資訊

    更新時間：Jul 13, 2024

    上傳到ApsaraVideo for VOD媒資庫中的視頻、音頻、圖片等媒資，支援對其進行模糊比對、多值查詢、指定返回欄位等多方式多維度搜尋、篩選、過濾和排序，以擷取到符合搜尋條件的媒資資訊。本文為您介紹如何通過控制台和API/SDK方式搜尋媒資資訊。

    使用方式

    ApsaraVideo for VOD提供了如下兩種方式來搜尋媒資資訊：

    • 通過控制台搜尋

      登入ApsaraVideo for VOD控制台，進入媒資庫頁面，可以通過媒體名稱、媒體ID、標籤名稱等進行搜尋媒資資訊。具體操作，請參見媒資管理。搜尋媒資資訊1.png

    • 通過API/SDK搜尋

      使用SearchMedia - 搜尋媒體資訊介面，同時配合媒資搜尋協議使用。SearchMedia - 搜尋媒體資訊介面支援指定返回欄位、精確匹配、模糊比對、多值查詢、範圍查詢等多種方式的查詢，支援作為過濾條件的媒資資訊包括VideoId、CateId、StorageLocation、Title、Tags等多個欄位，詳細的搜尋文法及規則請參見媒資搜尋協議。

    使用限制

    翻頁限制

    通過API/SDK方式搜尋時，為避免深度翻頁造成效能問題，媒資搜尋限制只返回命中搜尋條件的部分資料。如果要擷取更多資料、甚至遍曆所有資料，則需要使用翻頁標記（ScrollToken）、會話ID（SessionId）。

    • 擷取部分資料使用翻頁參數（PageNo、PageSize），且不傳翻頁標識（ScrollToken、SessionId），可逐次擷取前5000條資料。

    • 擷取更多資料，或遍曆所有資料使用翻頁參數（PageNo、PageSize），且傳入翻頁標識（ScrollToken、SessionId），則翻頁位置與當前位置之間不能超過1200條資料；但可以在翻到最後一頁時擷取到接下來的1200條，以此類推，直到取完所有資料。也就是，可以根據翻頁標識，分多段拿資料，但每段限制最多1200條。

    API使用樣本

    下文將以搜尋視頻資訊為例介紹搜尋語句。

    重要

    • 發送請求前需要對請求參數做URL編碼。

    • 同時語句中使用的等號、雙引號、單引號、括弧必須為英文半形。

    分類

    描述

    返回欄位

    媒資搜尋介面預設返回媒資基本資料，當需要附加其他媒資資訊時需要指定Fields欄位。查詢結果中包含Title和CoverURL：

    Fields=Title,CoverURL

    請求樣本：

    http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia
&Fields=Title,CoverURL

    精確匹配

    查詢VideoId值為28ba2b26d540446c94cdd2c4c48090e5的視頻資訊：

    VideoId='28ba2b26d540446c94cdd2c4c48090e5'

    請求樣本：

    http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia
&Match=VideoId='28ba2b26d540446c94cdd2c4c48090e5'

    模糊比對

    Title中包含音樂，可以寫成：

    Title='音樂'

    或者寫成

    Title in ('音樂')

    請求樣本：

    http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia
&Match=Title='音樂'

    多值查詢

    查詢Status值為Normal 或Checking

    Status in ('Normal','Checking')

    請求樣本：

    http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia
&Match=Status in ('Normal','Checking')

    範圍查詢

    使用開閉區間表示範圍，CreationTime位於2018-01-01T00:00:00Z和2018-02-01T00:00:00Z之間：

    CreationTime=('2018-01-01T00:00:00Z','2018-02-01T00:00:00Z')

    請求樣本：

    http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia
&Match=CreationTime=('2018-01-01T00:00:00Z','2018-02-01T00:00:00Z')

    如果只有左邊界或右邊界，對應右邊界或左邊界值為空白即可，如CreationTime大於2018-01-01T00:00:00Z：

    CreationTime=('2018-01-01T00:00:00Z',)

    請求樣本：

    http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia
&Match=CreationTime=('2018-01-01T00:00:00Z',)

    排序欄位

    按建立時間倒排：

    CreationTime:Desc

    請求樣本：

    http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia
&SortBy=CreationTime:Desc

    相關文檔