BatchGetMediaInfos によるメディアメタデータ取得の自動化 - ApsaraVideo VOD (VOD)

複数のメディアアセットの基本情報とソースファイル情報を取得します。

操作説明

1 回のリクエストで最大 20 個の音声または動画ファイルの情報を取得できます。
Video on Demand (VOD) は、ソースファイルがアップロードされた後に分析を行うため、メディアアセット情報は非同期で生成されます。イベント通知で音声/動画分析完了を設定できます。通知を受信した後、この操作を呼び出して音声または動画情報を取得します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

vod:BatchGetMediaInfos

get

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
MediaIds	string	必須	メディアアセットの ID (音声または動画の ID (VideoId)) です。複数の ID はコンマ (,) で区切ります。最大 20 個の ID を指定できます。ID は、次のいずれかの方法で取得できます。コンソールでアップロードされた音声または動画ファイルの場合、VOD コンソールにログインし、[メディアアセット] > [音声/動画] を選択して、音声または動画の ID を確認します。アップロード URL と資格情報を取得する操作を呼び出した後に返される VideoId パラメーターの値。 SearchMedia 操作を呼び出した後に返される VideoId パラメーターの値。	61ccbdb06fa83012be4d8083f6**,7d2fbc380b0e08e55f**
ReferenceIds	string	任意	カスタム ID のリストです。複数の ID はコンマ (,) で区切ります。最大 20 個の ID を指定できます。	123-123,1234-1234

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID です。	9E290613-04F4-47F4-795D30732077****
NonExistMediaIds	array	存在しないメディアアセット ID のリストです。
	string	存在しないメディアアセット ID のリストです。	["bbc65bba53f6ed90de118a7849****"]
NonExistReferenceIds	array	存在しないカスタム ID のリストです。
	string	存在しないカスタム ID のリストです。	123-123
ForbiddenMediaIds	array	操作が禁止されているメディアアセット ID のリストです。これは通常、複数のアプリケーションに対する権限がないことが原因です。詳細については、「マルチアプリケーションサービス」をご参照ください。
	string	操作が禁止されているメディアアセット ID のリストです。これは通常、複数のアプリケーションに対する権限がないことが原因です。詳細については、「マルチアプリケーションサービス」をご参照ください。	["bbc65bba53f6ed90de118a7849****"]
MediaInfos	array<object>	メディアアセットのリストです。
	array<object>	メディアアセットのリストです。
MediaId	string	メディアアセットの ID です。	10a5fa364a5b71ef89246733a78e****
MediaInfo	object	メディアアセットの基本情報です。
StorageLocation	string	音声または動画ファイルのストレージの場所です。	outin-***.oss-cn-shanghai.aliyuncs.com
CreationTime	string	音声または動画ファイルが作成された時刻です。時刻は yyyy-MM-ddTHH:mm:ssZ 形式で、UTC で表示されます。	2017-11-14T09:15:50Z
Status	string	動画のステータスです。有効な値： Uploading：動画はアップロード中です。 UploadFail：動画のアップロードに失敗しました。 UploadSucc：動画はアップロード済みです。 Transcoding：動画はトランスコード中です。 TranscodeFail：動画のトランスコーディングに失敗しました。 Blocked：動画はブロックされています。 Normal：動画は正常な状態です。	Normal
CateId	integer	カテゴリ ID です。	781111****
MediaId	string	メディアアセットの ID です。	7753d144efd74d6c45fe0570****
DownloadSwitch	string	オフラインダウンロードスイッチのステータスです。オフラインダウンロードを有効にすると、ユーザーは ApsaraVideo Player を使用して動画をローカルデバイスにキャッシュし、オフラインで視聴できます。詳細については、「オフラインダウンロード」をご参照ください。有効な値： on：オフラインダウンロードが有効です。 off：オフラインダウンロードが無効です。	on
Tags	string	音声または動画ファイルのタグです。複数のタグはコンマ (,) で区切ります。	tag1, tag2
ModificationTime	string	音声または動画ファイルが最後に更新された時刻です。時刻は yyyy-MM-ddTHH:mm:ssZ 形式で、UTC で表示されます。	2017-06-26T06:38:48Z
CateName	string	カテゴリ名です。	cate1
Description	string	音声または動画ファイルの説明です。	Alibaba Cloud VOD video description
AppId	string	アプリケーション ID です。	app-****
CoverURL	string	サムネイルの URL です。	https://example.aliyundoc.com/****.jpg
TemplateGroupId	string	トランスコーディングテンプレートグループの ID です。	b4039216985f4312a5382a4ed****
Title	string	音声または動画ファイルのタイトルです。	Alibaba Cloud VOD Video Title
Snapshots	array	ビデオスナップショット URL の配列です。
	string	ビデオスナップショット URL の配列です。説明この操作は、動画サムネイルのデータのみを返します。スナップショット機能を使用してキャプチャされた通常のスナップショット、スプライト、オリジナルスプライトイメージ、および WebVTT スナップショットのデータをクエリするには、ListSnapshots 操作を呼び出してください。	["http://example.aliyundoc.com/snapshot/**.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333","http://example.aliyundoc.com/snapshot/.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27243**",...]
StorageClass	string	メディアアセットのストレージクラスです。有効な値： Standard：標準。 IA：低頻度アクセス (IA)。 Archive：アーカイブ。 ColdArchive：コールドアーカイブ。 SourceIA：ソース IA。 SourceArchive：ソースアーカイブ。 SourceColdArchive：ソースコールドアーカイブ。 Changing：メディアアセットのストレージクラスは変更中です。 SourceChanging：ソースファイルのストレージクラスは変更中です。	Standard
RestoreStatus	string	メディアアセットの解凍ステータスです。有効な値： Processing：メディアアセットは解凍中です。 Success：メディアアセットは解凍済みです。 Failed：メディアアセットの解凍に失敗しました。	Success
RestoreExpiration	string	解凍済みメディアアセットの有効期限です。	2023-03-30T10:14:14Z
UserData	string	カスタムパラメーターです。	{"Extend":"xxx","MessageCallback":"xxx"}
ReferenceId	string	カスタム ID です。ID には、小文字、大文字、数字、ハイフン (-)、およびアンダースコア (_) を含めることができます。ID は 6～64 文字の長さで、ユーザーに対して一意である必要があります。	123-123
MezzanineInfo	object	ソースファイルに関する情報です。
CreationTime	string	ファイルが作成された時刻です。時刻は yyyy-MM-ddTHH:mm:ssZ 形式で、UTC で表示されます。	2017-11-14T09:15:50Z
Status	string	ファイルのステータスです。有効な値： Uploading：ファイルはアップロード中です。これは初期状態です。 Normal：ファイルはアップロード済みです。 UploadFail：ファイルのアップロードに失敗しました。 Deleted：ファイルは削除済みです。	Normal
FileURL	string	ソースファイルの URL です。	http://example-bucket-**.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1**.mp4
MediaId	string	メディアアセットの ID です。	1f1a6fc03ca04814031b8a6559e****
Height	integer	ファイルの高さ (ピクセル単位、px) です。	540
Bitrate	string	ファイルのビットレート (Kbps) です。	771.2280
FileName	string	ファイル名です。	27ffc438-164h67f57ef-0005-6884-51a-1****.mp4
Width	integer	ファイルの幅 (ピクセル単位、px) です。	960
Size	integer	ファイルのサイズ (バイト単位) です。	4096477
Duration	string	ファイルの長さ (秒単位) です。	42.4930
Fps	string	ファイルのフレームレート (1 秒あたりのフレーム数) です。	25.0000
AudioStreamList	array<object>	オーディオストリームに関する情報です。
	object	オーディオストリームの詳細です。
Index	string	オーディオストリームのシーケンス番号です。この番号は、メディアストリーム内でのオーディオストリームの位置を示します。	0
Timebase	string	タイムベースです。	0.000000
SampleFmt	string	サンプリングフォーマットです。	fltp
SampleRate	string	サンプルレートです。	44100
ChannelLayout	string	サウンドチャンネルの出力レイアウトです。有効な値： mono：モノラル。 stereo：ステレオ。	mono
Lang	string	言語です。	und
CodecLongName	string	エンコード形式の長い名前です。	AAC (Advanced Audio Coding)
Channels	string	サウンドチャンネルの数です。	1
NumFrames	string	総フレーム数です。	1
Bitrate	string	ビットレートです。	62.885
CodecTagString	string	エンコード形式のタグテキストです。	mp4a
StartTime	string	開始時刻です。時刻は yyyy-MM-ddTHH:mm:ssZ 形式で、UTC で表示されます。	2017-01-11T12:00:00Z
CodecName	string	エンコード形式の短い名前です。	aac
Duration	string	期間です。	3.227574
CodecTag	string	エンコード形式のタグです。	0x6134706d
CodecTimeBase	string	コーデックタイムベースです。	1/44100
VideoStreamList	array<object>	ビデオストリームに関する情報です。
	object	ビデオストリームの詳細です。
Timebase	string	タイムベースです。	0.000000
Index	string	ビデオストリームのシーケンス番号です。この番号は、メディアストリーム内でのビデオストリームの位置を示します。	1
AvgFPS	string	平均フレームレートです。	30.0
PixFmt	string	ピクセルフォーマットです。	yuv420p
Lang	string	言語です。	und
Sar	string	サンプルアスペクト比 (SAR) です。	0:1
Height	string	動画の高さです。	320
CodecLongName	string	エンコード形式の長い名前です。	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
NumFrames	string	総フレーム数です。	0
Bitrate	string	ファイルのビットレート (Kbps) です。	500
Rotate	string	動画の回転角度です。有効な値：[0, 360)。	90
CodecTagString	string	エンコード形式のタグテキストです。	avc1
HasBFrames	string	B フレームが存在するかどうかを示します。	0
Profile	string	コーデックプロファイルです。	Main
StartTime	string	開始時刻です。時刻は yyyy-MM-ddTHH:mm:ssZ 形式で、UTC で表示されます。	2017-01-11T12:00:00Z
Dar	string	表示アスペクト比 (DAR) です。	0:1
CodecName	string	エンコード形式の短い名前です。	h264
Width	string	動画の幅です。	568
Duration	string	期間です。	3.166667
Fps	string	フレームレートです。	30.0
CodecTag	string	エンコード形式のタグです。	0x31637661
CodecTimeBase	string	コーデックタイムベースです。	1/60
Level	string	エンコーディングレベルです。	30
HDRType	string	ビデオストリームのハイダイナミックレンジ (HDR) タイプです。	HDR
FileMD5	string
PlayInfoList	array<object>	音声または動画ファイルの再生情報です。これはストリーム情報です。
	object	音声または動画ファイルの詳細です。
CreationTime	string	ストリームが作成された時刻です。時刻は yyyy-MM-ddTHH:mm:ssZ 形式で、UTC で表示されます。	2022-04-18T07:37:15Z
Status	string	メディアストリームのステータスです。有効な値： Normal：メディアストリームは正常な状態です。このステータスは、各解像度とフォーマットの最新のトランスコード済みストリームに割り当てられます。 Invisible：メディアストリームは非表示です。同じ解像度とフォーマットで複数のストリームがトランスコードされた場合、最新のトランスコード済みストリームは Normal とマークされ、他のストリームは Invisible とマークされます。	Normal
Specification	string	音声および動画トランスコーディングの出力仕様です。有効な値と説明の詳細については、「出力仕様：Specification」をご参照ください。	H264.LD
NarrowBandType	string	トランスコーディングタイプです。有効な値： 0：通常のトランスコーディング。 1.0：ナローバンド HD 1.0 トランスコーディング。 2.0：ナローバンド HD 2.0 トランスコーディング。	0
Height	integer	メディアストリームの高さ (ピクセル単位、px) です。	640
Bitrate	string	メディアストリームのビットレート (Kbps) です。	450.878
ModificationTime	string	ストリームが最後に更新された時刻です。時刻は yyyy-MM-ddTHH:mm:ssZ 形式で、UTC で表示されます。	2022-04-20T06:32:19Z
WatermarkId	string	メディアストリームに関連付けられているウォーターマークテンプレートの ID です。	dgfn26457856****
Encrypt	integer	メディアストリームが暗号化されているかどうかを示します。有効な値： 0：いいえ。 1：はい。	1
Definition	string	ビデオストリームの解像度です。有効な値： FD：低解像度。 LD：標準解像度。 SD：高解像度。 HD：超高解像度 OD：オリジナル画質。 2K：2K。 4K：4K。 SQ：標準音質。 HQ：高音質。 AUTO：アダプティブビットレート。	LD
EncryptType	string	メディアストリームの暗号化タイプです。有効な値： AliyunVoDEncryption：Alibaba Cloud 専用の暗号化。 HLSEncryption：HLS 暗号化。説明暗号化タイプが AliyunVoDEncryption の場合、ストリームは ApsaraVideo Player SDK を使用してのみ再生できます。	AliyunVoDEncryption
EncryptMode	string	メディアストリームの暗号化モードです。有効な値： License：ローカル復号モード。説明暗号化モードが License の場合、ストリームは ApsaraVideo Player SDK を使用してのみ再生できます。	License
StreamType	string	メディアストリームのタイプです。メディアストリームがビデオストリームの場合、値は video です。メディアストリームが音声のみのストリームの場合、値は audio です。	video
JobId	string	メディアストリームのトランスコーディングジョブの ID です。この ID は、メディアストリームの一意の識別子として機能します。	80e9c6580e754a798c3c19c59b16****
Size	integer	メディアストリームのサイズ (バイト単位) です。	418112
Width	integer	メディアストリームの幅 (ピクセル単位、px) です。	360
Fps	string	メディアストリームのフレームレート (1 秒あたりのフレーム数) です。	25
Duration	string	メディアストリームの長さ (秒単位) です。	9.0464
PlayURL	string	ビデオストリームの再生 URL です。	https://example.aliyundoc.com/d52ee123f331466aabf6ab32a93d**/a777f9e24e6e47a2a942467d5c38ea37-8ee8e04293c6657fdda282bc422704**.m3u8
Format	string	メディアストリームのフォーマットです。メディアファイルが動画の場合、有効な値は mp4 と m3u8 です。メディアファイルが音声のみの場合、値は mp3 です。	m3u8
HDRType	string	メディアストリームの HDR タイプです。有効な値： HDR HDR10 HLG DolbyVision HDRVivid SDR+	HLG
BitDepth	integer	色深度です。値は整数です。	8
JobType	integer	デジタルウォーターマークのタイプです。有効な値： 1：トレーシングウォーターマーク。 2：著作権ウォーターマーク。	2
JobExt	string	著作権ウォーターマークのカスタムウォーターマーク情報です。このパラメーターは、`JobType` が `2` の場合にのみ返されます。	CopyrightMarkTest
CodecName	string	エンコード形式の短い名前です。	h264
TemplateId	string	トランスコーディングテンプレートの ID です。	a86a4338dd2e83da45154004a541****
TemplateGroupId	string	トランスコーディングテンプレートグループの ID です。	fb0716154b21a4ecb5b70a26ccc8****

例

成功レスポンス

JSONJSON

{
  "RequestId": "9E290613-04F4-47F4-795D30732077****",
  "NonExistMediaIds": [
    "[\"bbc65bba53f6ed90de118a7849****\"]"
  ],
  "NonExistReferenceIds": [
    "123-123"
  ],
  "ForbiddenMediaIds": [
    "[\"bbc65bba53f6ed90de118a7849****\"]"
  ],
  "MediaInfos": [
    {
      "MediaId": "10a5fa364a5b71ef89246733a78e****",
      "MediaInfo": {
        "StorageLocation": "outin-***.oss-cn-shanghai.aliyuncs.com",
        "CreationTime": "2017-11-14T09:15:50Z",
        "Status": "Normal",
        "CateId": 0,
        "MediaId": "7753d144efd74d6c45fe0570****",
        "DownloadSwitch": "on",
        "Tags": "tag1, tag2",
        "ModificationTime": "2017-06-26T06:38:48Z",
        "CateName": "cate1",
        "Description": "Alibaba Cloud VOD video description",
        "AppId": "app-****",
        "CoverURL": "https://example.aliyundoc.com/****.jpg",
        "TemplateGroupId": "b4039216985f4312a5382a4ed****",
        "Title": "Alibaba Cloud VOD Video Title",
        "Snapshots": [
          "[\"http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****\",\"http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27243****\",...]"
        ],
        "StorageClass": "Standard",
        "RestoreStatus": "Success",
        "RestoreExpiration": "2023-03-30T10:14:14Z",
        "UserData": "{\"Extend\":\"xxx\",\"MessageCallback\":\"xxx\"}",
        "ReferenceId": "123-123"
      },
      "MezzanineInfo": {
        "CreationTime": "2017-11-14T09:15:50Z",
        "Status": "Normal",
        "FileURL": "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
        "MediaId": "1f1a6fc03ca04814031b8a6559e****",
        "Height": 540,
        "Bitrate": "771.2280",
        "FileName": "27ffc438-164h67f57ef-0005-6884-51a-1****.mp4\n",
        "Width": 960,
        "Size": 4096477,
        "Duration": "42.4930",
        "Fps": "25.0000",
        "AudioStreamList": [
          {
            "Index": "0",
            "Timebase": "0.000000",
            "SampleFmt": "fltp",
            "SampleRate": "44100",
            "ChannelLayout": "mono",
            "Lang": "und",
            "CodecLongName": "AAC (Advanced Audio Coding)\n",
            "Channels": "1",
            "NumFrames": "1",
            "Bitrate": "62.885",
            "CodecTagString": "mp4a",
            "StartTime": "2017-01-11T12:00:00Z",
            "CodecName": "aac",
            "Duration": "3.227574",
            "CodecTag": "0x6134706d",
            "CodecTimeBase": "1/44100"
          }
        ],
        "VideoStreamList": [
          {
            "Timebase": "0.000000",
            "Index": "1",
            "AvgFPS": "30.0",
            "PixFmt": "yuv420p",
            "Lang": "und",
            "Sar": "0:1",
            "Height": "320",
            "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
            "NumFrames": "0",
            "Bitrate": "500",
            "Rotate": "90",
            "CodecTagString": "avc1",
            "HasBFrames": "0",
            "Profile": "Main",
            "StartTime": "2017-01-11T12:00:00Z",
            "Dar": "0:1",
            "CodecName": "h264",
            "Width": "568",
            "Duration": "3.166667",
            "Fps": "30.0",
            "CodecTag": "0x31637661",
            "CodecTimeBase": "1/60",
            "Level": "30",
            "HDRType": "HDR"
          }
        ],
        "FileMD5": ""
      },
      "PlayInfoList": [
        {
          "CreationTime": "2022-04-18T07:37:15Z\n",
          "Status": "Normal",
          "Specification": "H264.LD",
          "NarrowBandType": "0",
          "Height": 640,
          "Bitrate": "450.878",
          "ModificationTime": "2022-04-20T06:32:19Z",
          "WatermarkId": "dgfn26457856****",
          "Encrypt": 1,
          "Definition": "LD",
          "EncryptType": "AliyunVoDEncryption",
          "EncryptMode": "License",
          "StreamType": "video",
          "JobId": "80e9c6580e754a798c3c19c59b16****",
          "Size": 418112,
          "Width": 360,
          "Fps": "25",
          "Duration": "9.0464",
          "PlayURL": "https://example.aliyundoc.com/d52ee123f331466aabf6ab32a93d****/a777f9e24e6e47a2a942467d5c38ea37-8ee8e04293c6657fdda282bc422704****.m3u8",
          "Format": "m3u8",
          "HDRType": "HLG",
          "BitDepth": 8,
          "JobType": 2,
          "JobExt": "CopyrightMarkTest",
          "CodecName": "h264",
          "TemplateId": "a86a4338dd2e83da45154004a541****",
          "TemplateGroupId": "fb0716154b21a4ecb5b70a26ccc8****"
        }
      ]
    }
  ]
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。