メディアライブラリ内のビデオファイル、オーディオファイル、画像ファイルなど、クエリ条件に一致するメディアアセットに関する情報をクエリ、フィルタリング、および並べ替えることができます。 このトピックでは、ApsaraVideo VODコンソール、API操作、またはSDKを使用してメディアアセット情報をクエリする方法について説明します。 このトピックでは、API操作を呼び出してメディアアセット情報をクエリする方法の制限と例についても説明します。
変更方法
次の2つの方法を使用して、メディアアセット情報を照会できます。
ApsaraVideo VODコンソールを使用する
ApsaraVideo VODコンソールの [ビデオとオーディオ] ページで、メディアアセットに関する情報を名前またはIDで照会できます。 詳細については、「メディアアセットの管理」をご参照ください。
API操作またはSDKを使用して
SearchMedia操作を呼び出し、検索プロトコルを使用してメディアアセット情報を照会します。 SearchMedia操作を呼び出して、メディアアセット情報を照会し、返すフィールドを指定できます。 完全一致、ファジー一致、多値クエリ、範囲クエリなど、複数のクエリモードがサポートされています。 VideoId、CateId、StorageLocation、Title、またはタグに基づいてメディアアセット情報をフィルタリングできます。 検索構文とルールの詳細については、「メディアアセット検索のプロトコル」をご参照ください。
制限事項
ページング制限
ディープページングによって引き起こされるパフォーマンスの問題を回避するために、SearchMedia操作は、クエリ条件を満たすデータの一部のみを返します。 より多くのデータを取得するか、すべてのデータをトラバースするには、ScrollTokenおよびSessionIdページネーション識別子を使用する必要があります。
PageNoやPageSizeなどのページ区切りパラメーターは、ScrollTokenやSessionIdを渡さずに一部のデータを取得するために使用されます。 1つのクエリに対して最初の5,000個のデータレコードを取得できます。より多くのデータを取得したり、すべてのデータをトラバースしたりするには、
PageNoとPageSizeページネーションパラメーター、およびScrollTokenとSessionIdページネーション識別子を使用する必要があります。 現在のページ番号と必要なページ番号の間のページのデータレコード数が1,200を超えないようにしてください。 必要なページ番号で指定されたページに移動すると、次の1,200のデータレコードを取得できます。 上記の操作を繰り返して、すべてのデータを取得します。 ページネーション識別子に基づいて、複数のセグメントのデータを取得できます。 ただし、各セグメントで最大1,200のデータレコードを取得できます。
API呼び出しの例
次のセクションのサンプルコードでは、ビデオ情報のクエリに使用されるクエリ文について説明します。
リクエストを送信する前に、リクエストパラメーターに対してURLエンコードを実行する必要があります。
ステートメントで使用する等号 (=) 、二重引用符 (") 、一重引用符 (') 、および括弧は、1バイト文字である必要があります。
アイテム | 説明 |
Returnフィールド | デフォルトでは、SearchMedia操作は基本的なメディアアセット情報のみを返します。 より多くのメディアアセット情報を取得するには、 リクエストの例 |
完全一致 |
リクエストの例 |
ファジーマッチ |
または リクエストの例 |
複数値クエリMulti-value query |
リクエストの例 |
範囲クエリ | 時間範囲を示すには、オープンまたはクローズの間隔を使用します。 リクエストの例 時間範囲の終了時刻または開始時刻のみを指定するには、左開きまたは右開きの間隔を使用します。 リクエストの例 |
ソートフィールド | 作成時間に基づいてメディアアセット情報を逆時系列でソートする: リクエストの例 |