すべてのプロダクト
Search
ドキュメントセンター

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

最終更新日:Jun 21, 2026

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

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

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

情報タイプ

取得用 API

更新用 API

ユースケース

基本情報

GetVideoInfo

GetVideoInfos

GetImageInfo

UpdateVideoInfo

UpdateVideoInfos

UpdateImageInfos

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

ソースファイル情報

GetMezzanineInfo

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

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

再生情報

GetPlayInfo

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

認証情報を含む再生 URL を取得します。これは、ビデオ再生機能に不可欠です。

説明

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

ユースケース 2:コンソールの使用

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

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

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

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

管理

次の例では、[オーディオ/ビデオ] アセットの管理方法を説明します。

基本情報

[基本情報] タブでは、オーディオまたはビデオのタイトル、説明、カテゴリ、タグ、サムネイルを表示または変更できます。編集後、保存 をクリックします。

基础信息

次の表でパラメーターを説明します。

パラメーター

説明

[カバー]

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

説明

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

[名前]

オーディオまたはビデオファイルの名前です。この名前は再生中にプレーヤーに表示され、長さは 1〜128 バイトです。

[説明]

オーディオまたはビデオファイルの詳細な説明です。長さは最大 1,024 バイトです。

[分類]

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

[タグ]

各オーディオまたはビデオファイルに複数のタグを追加できます。タグには、中国語の文字、英字、数字、アンダースコア (_) を含めることができます。複数のタグは、コンマ (,)、セミコロン (;)、または Enter キーで区切ります。

ビデオ URL

ソースファイルと、さまざまなフォーマット・品質でトランスコードされたストリームの URL を、対応する解像度・ビットレートとともに確認できます。

11

次の表でアクションを説明します。

操作

説明

[コピー]

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

[プレビュー]

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

[削除]

選択した品質のビデオストリームを削除します。

[すべて削除]

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

Web プレーヤーコード

ビデオごとに、開発者は提供された HTML または JavaScript のコードスニペットを使用できます。設定ツールを使用すると、プレーヤーのサイズや自動再生などのパラメーターをすばやく変更して、セットアップを迅速に行えます。

説明
  • Web プレーヤーコード タブは、ビデオアセットでのみ利用できます。

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

web播放器