すべてのプロダクト
Search

このプロダクト

    :メディア資産情報の検索

    ドキュメントセンター

    :メディア資産情報の検索

    最終更新日:Jun 20, 2022

    メディアライブラリ内のビデオ、オーディオ、画像のメディアアセット情報を検索して並べ替えることができます。 このトピックでは、コンソールまたはAPI操作またはSDKを使用してメディアアセット情報を検索する方法について説明します。 このトピックでは、2つの検索方法の制限についても説明し、API操作を呼び出してメディア資産情報を検索する方法の例を示します。

    使用方法

    ApsaraVideo VODは、メディアアセット情報を検索するために次の2つの方法を提供します。

    制限事項

    ページネーションの制限

    詳細なページ付けによるパフォーマンスの問題を回避するために、SearchMedia操作は、検索条件を満たすデータの一部のみを返します。 より多くのデータを取得したり、すべてのデータを一覧表示したりするには、ScrollTokenおよびSessionIdページネーション識別パラメーターを使用する必要があります。

    • PageNoやPageSizeなどのページ区切りパラメーターは、ScrollTokenやSessionIdパラメーターを渡さずに一部のデータを取得するために使用されます。 最初の5,000件のデータレコードを1回取得できます。

    • より多くのデータを取得するか、すべてのデータを一覧表示するには、PageNoおよびPageSizeページ分割パラメーターと、ScrollTokenおよびSessionIdページ分割識別パラメーターを使用する必要があります。 現在のページ番号と必要なページ番号の間のページのデータレコード数が1,200を超えないようにしてください。 必要なページ番号で指定されたページに移動すると、次の1,200のデータレコードを取得できます。 すべてのデータが取得されるまで、判断を使用してデータを検索できます。 ページネーション識別パラメーターに基づいて、複数のセグメントのデータを取得できます。 However, you can obtain a maximum of 1,200 data records in each segment.

    APIの例

    次のセクションでは、例でビデオ情報検索を使用して、検索文について説明します。

    注意

    • リクエストを送信する前に、リクエストパラメーターに対してURLエンコードを実行する必要があります。

    • ステートメントで使用する等号 (=) 、二重引用符 (") 、一重引用符 (') 、および括弧は、1バイト文字である必要があります。

    項目

    説明

    返されたフィールド

    デフォルトでは、SearchMedia操作は基本的なメディアアセット情報のみを返します。 より多くのメディアアセット情報を取得するには、[フィールド] フィールドを設定する必要があります。 TitleおよびCoverURLパラメーターを取得します。

    フィールド=タイトル、CoverURL

    サンプルリクエスト:

    http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia
&フィールド=タイトル、CoverURL

    完全一致

    VideoIdの値が28ba2b26d540446c94cdd2c4c48090e 5であるメディアアセット情報を検索します。

    VideoId='28ba2b26d540446c94cdd2c4c48090e5'

    サンプルリクエスト:

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

    ファジーマッチ

    タイトルが音楽を含むメディア資産情報を検索する:

    タイトル='Music'

    or

    Title in ('Music')

    サンプルリクエスト:

    http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia
&マッチ=タイトル='音楽'

    複数値クエリMulti-value query

    ステータスが正常またはチェック中のメディア資産情報を検索します。

    ステータスin ('Normal','Checking')

    サンプルリクエスト:

    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','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',)

    ソートフィールド

    作成時間に基づいてメディアアセット情報を逆時系列でソートする:

    作成時間: Desc

    サンプルリクエスト:

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