すべてのプロダクト
Search

このプロダクト

    ApsaraVideo VOD:メディアアセット情報の取得と更新

    ドキュメントセンター

    ApsaraVideo VOD:メディアアセット情報の取得と更新

    最終更新日:Sep 18, 2026

    メディアファイルのアップロードまたは処理が完了すると、そのメディアアセット情報を取得および更新できます。本トピックでは、ApsaraVideo VOD コンソール、API、または SDK を使用してこれらの操作を実行する方法について説明します。

    ユースケース 1: API による取得と更新

    さまざまなビジネスシナリオに対応するため、ApsaraVideo VOD では、メディアアセット情報を以下のタイプに分類しています。各タイプは、異なる API を使用して個別に取得および更新できます。

    情報タイプ

    取得用 API

    更新用 API

    ユースケース

    基本情報

    GetVideoInfo

    GetVideoInfos

    GetImageInfo

    UpdateVideoInfo

    UpdateVideoInfos

    UpdateImageInfos

    タイトル、再生時間、ステータスなどの基本情報を取得し、アプリケーションに表示します。また、コンテンツ管理のために、タイトル、説明、サムネイル、カテゴリ ID、タグなどの属性を更新できます。

    ソースファイル情報

    GetMezzanineInfo

    ソースファイル情報はファイル自体から抽出されたメタデータのため、更新できません。

    元のファイルの URL とパラメーターを取得します。アーカイブ、二次処理、またはトラブルシューティングに使用されることが多いです。

    再生情報

    GetPlayInfo

    再生情報は更新できません。ただし、メディアをトランスコードすることで、新しい音声および動画ストリームを生成できます。SubmitTranscodeJobs

    認証情報を含む再生 URL を取得します。動画再生機能に不可欠です。

    説明

    メディアアセット情報の取得や更新を行う API の呼び出しには、サーバーサイド SDK の使用を推奨します。詳細については、「VOD SDK使用ガイド」をご参照ください。

    ユースケース 2: コンソールによる操作

    コンソールは、個々のメディアアセットの詳細を表示および管理するための直感的なインターフェイスを提供します。運用スタッフによる日常的な管理や、開発時の迅速な検証に最適です。

    1. ApsaraVideo VOD コンソールにログインします。

    2. 左側のナビゲーションペインで メディアファイル を選択し、次に [音声/動画]、イメージ、または ショート動画素材 をクリックして、対応するページに移動します。

    3. メディアアセットの詳細を表示するには、管理 をクリックします。

    以下の例では、音声/動画 アセットの管理方法を示します。

    基本情報

    「基本情報」タブでは、音声または動画のタイトル、説明、カテゴリ、タグ、サムネイルを表示または変更できます。編集後、保存 をクリックします。

    各パラメーターについては、次の表で説明します。

    パラメーター

    説明

    [カバー]

    画像をアップロードするか、動画スナップショットを選択することで、デフォルトの動画サムネイルを設定できます。

    説明

    カスタムサムネイルは JPG または PNG 形式でアップロードできます。サイズは 1 MB 以下、解像度は 1920x1080 以下である必要があります。

    [名前]

    音声または動画ファイルの名前です。この名前は再生時にプレーヤーに表示され、1～128 バイトの長さに設定できます。

    [説明]

    音声または動画ファイルの詳細な説明です。最大 1,024 バイトまで入力できます。

    [分類]

    動画にカテゴリを割り当てることができます。詳細については、「メディアアセットカテゴリの管理」をご参照ください。

    [タグ]

    各音声または動画ファイルに複数のタグを追加できます。タグには、中国語文字、英字、数字、アンダースコア (_) を使用できます。複数のタグは、カンマ (,)、セミコロン (;)、または Enter キーで区切ります。

    動画URL

    ソースファイル、および様々な形式や品質にトランスコードされた全ストリームの URL を、それぞれの解像度とビットレートと共に確認できます。

    各操作については、次の表で説明します。

    操作

    説明

    [コピー]

    選択した画質の再生 URL をコピーします。URL をブラウザーまたはプレーヤーに貼り付けて、動画をプレビューできます。

    [プレビュー]

    選択した画質の動画をコンソールで直接プレビューします。

    [削除]

    選択した画質の動画ストリームを削除します。

    [すべて削除]

    すべてのトランスコード済みファイルを削除しますが、ソースファイルは保持されます。この操作は元に戻すことができません。慎重に実行してください。

    Web プレーヤーコード

    動画ごとに、提供されている HTML または JavaScript のコードスニペットを使用できます。構成ツールを使用すると、プレーヤーのサイズや自動再生などのパラメーターを迅速に変更でき、セットアップを高速化できます。

    説明

    • Web プレーヤーコード タブは、動画アセットでのみ利用可能です。

    • 組み込みには、最新バージョンの ApsaraVideo Player for Web を使用してください。詳細については、「ApsaraVideo Player for Web」をご参照ください。