すべてのプロダクト
Search

このプロダクト

    ApsaraVideo VOD:メディア アセット情報のクエリ

    ドキュメントセンター

    ApsaraVideo VOD:メディア アセット情報のクエリ

    最終更新日:Mar 10, 2025

    ビデオ、オーディオ、画像ファイルなどのメディア アセットに関する情報をクエリし、返すフィールドを指定できます。あいまい一致や複数値クエリなど、複数のクエリ モードがサポートされています。特定のパラメーターに基づいて、メディア アセット情報のクエリ、フィルタリング、およびソートを行うこともできます。このトピックでは、ApsaraVideo VOD コンソール、API、または SDK を使用してメディア アセット情報をクエリする方法について説明します。

    方法

    メディア アセット情報をクエリするには、次の 2 つの方法を使用できます。

    • ApsaraVideo VOD コンソールの使用

      ApsaraVideo VOD コンソールにログインし、[オーディオ/ビデオ] ページに移動します。オーディオ ファイルとビデオ ファイルをタイプ、カテゴリ、ステータス、およびソースでフィルタリングできます。メディア名、メディア ID、またはタグ名でメディア アセットを検索することもできます。

      説明

      ビデオ ファイルがトランスコード失敗ステータスの場合は、ビデオ ファイルを削除して再度アップロードしてください。ビデオ ファイルのトランスコードが複数回失敗する場合は、「トランスコードに関するよくある質問」で考えられる原因と対応する解決策をご覧ください。

      搜索媒资信息1.png

    • API 操作または SDK の使用

      SearchMedia 操作を呼び出し、検索プロトコルを使用してメディア アセット情報をクエリします。SearchMedia 操作を呼び出してメディア アセット情報をクエリし、返すフィールドを指定できます。完全一致、あいまい一致、複数値クエリ、範囲クエリなど、複数のクエリ モードがサポートされています。 VideoId、CateId、StorageLocation、Title、または Tags に基づいてメディア アセット情報をフィルタリングできます。検索構文とルールの詳細については、「メディア アセット検索のプロトコル」をご参照ください。

    制限

    ページングの制限

    API 操作または SDK を使用してメディア アセットをクエリする場合、SearchMedia 操作は、深いページングによって発生するパフォーマンスの問題を回避するために、クエリ条件を満たすデータの一部のみを返します。より多くのデータを取得したり、すべてのデータを走査したりするには、ScrollToken および SessionId ページング識別子を使用する必要があります。

    • PageNo や PageSize などのページネーション パラメーターは、ScrollToken または SessionId を渡さずにデータを取得するために使用されます。 1 つのクエリで最初の 5,000 件のデータ レコードを取得できます。

    • より多くのデータを取得したり、すべてのデータを走査したりするには、PageNo および PageSize ページング パラメーターと、ScrollToken および SessionId ページング識別子を使用する必要があります。現在のページ番号と必要なページ番号の間のページのデータ レコード数が 1,200 を超えないようにしてください。必要なページ番号で指定されたページに移動すると、次の 1,200 件のデータ レコードを取得できます。上記の操作を繰り返して、すべてのデータを取得します。ページング識別子に基づいて、複数のセグメントでデータを取得できます。ただし、各セグメントで取得できるデータ レコードは最大 1,200 件です。1,2001,2001,200

    API 呼び出し例

    次のセクションのサンプル コードでは、ビデオ情報のクエリに使用されるクエリ文について説明します。

    重要

    • リクエストを送信する前に、リクエスト パラメーターで URL エンコーディングを実行する必要があります。

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

    項目

    説明

    戻り値フィールド

    デフォルトでは、SearchMedia 操作は基本的なメディア アセット情報のみを返します。より多くのメディア アセット情報を取得するには、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 に Music が含まれるメディア アセット情報をクエリします。

    Title='Music'

    または

    Title in ('Music')

    リクエスト例:

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

    複数値クエリ

    注: クエリに使用されるフィールドがあいまい一致のみをサポートしている場合、クエリ結果はあいまい一致に基づいて返されます。

    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

    参照