3-3.動画情報詳細
AmebaVisionに投稿された動画の詳細を返却するAPIです。
URL
http://vision.ameba.jp/api/get/detailMovie.do?movie=[動画ID]
リクエストパラメータ
movie:
動画を一意で表すID
動画閲覧画面(http://vision.ameba.jp/watch.do?movie=xxxxx)のURLに含まれている「movie」の値と同じものになります。
movieパラメータが渡されていない場合は、エラーが返却されます。
format:
返却するデータフォーマットの種類。xmlとjsonpの2種類を指定可能です。未指定の場合はxml形式でデータが返却されます。
callback:
format=jsonp の時のみ有効。jsonpのコールバック関数の名前が指定できます。JavaScriptの構文に使用できない文字列などが含まれている場合、未指定の場合はデフォルトのコールバック関数の名前(handler)になります。
要素名と内容
title | API の名称 |
link | API に関連するサイトのURL |
description | API の解説 |
item | 動画情報 |
title | 動画のタイトル |
link | 動画閲覧画面のページURL |
tagId | 動画を一意であらわすID |
description | 動画の解説文 |
amebaId | 動画投稿者のアメーバID |
ratingGood | Goodの評価数 Good/Bad評価を許可していない動画の場合は0が入ります。 |
ratingBad | Badの評価数 Good/Bad評価を許可していない動画の場合は0が入ります。 |
playTimeSecond | 動画の再生時間 MM:ss の形式になります。 |
viewCount | 動画の視聴回数 |
commentCount | コメントの投稿数 |
imageUrlLarge | 動画のサムネイル画像(大) |
imageUrlMedium | 動画のサムネイル画像(中) |
imageUrlSmall | 動画のサムネイル画像(小) |
registDatetime | 動画の投稿日時 RFC822 で定めるフォーマットになります。 |
elapsedTime | 動画が投稿されてから経過した日時 59分以内の場合はxx分前、23時間59分以内の場合はxx時間前、それ以降はxx日前と表示されます。 |
player | 動画のプレイヤーを表示するためのHTMLタグ 貼り付けが許可されていない動画の場合は、playerタグは空要素になります。 |