セッションの詳細照会

Classic/VPC環境で利用できます。

プレイヤーを使用したユーザーのセッションに関する詳細情報を照会します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド	URI
GET	/v1/sessionRecent/{Session UUID}

リクエストヘッダ

Video Player Enhancement APIで共通して使用されるヘッダの詳細は、Video Player Enhancementのリクエストヘッダをご参照ください。

リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`Session UUID`	String	Required	ユニークユーザー番号 UUID形式

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request GET 'https://ma-dashboard-api.vpe.naverncp.com/v1/sessionRecent/{Session UUID}' \
--header 'x-api-key: {API Key}' \
--header 'x-project-id: {Project id}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`code`	String	-	レスポンスコード
`message`	String	-	レスポンスメッセージ
`result`	Array	-	セッション情報

`result`

resultの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`startTime`	Array	-	再生開始までかかった時間
`user`	Array	-	セッションユーザー情報
`player`	Array	-	プレイヤー情報
`error`	Array	-	エラー情報
`sessionLog`	Array	-	セッションログ (プレイヤー動作サイクルログ)
`media`	Array	-	再生ソース情報

`startTime`

startTimeの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`playerStartTimeSum`	Integer	-	プレイヤー準備時間 (秒)
`videoStartTimeSum`	Integer	-	再生開始時間 (秒)
`totalStartTimeSum`	Integer	-	総再生時間 (秒)

`user`

userの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`os`	String	-	OS情報
`isp`	String	-	ネットワーク情報
`nation`	String	-	国情報
`address`	String	-	位置情報
`browser`	String	-	ブラウザ情報
`ip`	String	-	IPアドレス
`device`	String	-	プレイヤー再生環境 `PC,Mobile`\| `PC` \| `Mobile`
`screen`	String	-	画面解像度
`lang`	String	-	言語コード
`visitedPage`	String	-	再生されたページ

`player`

playerの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`playerName`	String	-	プレイヤー名
`playerVersion`	String	-	プレイヤーバージョン
`playerType`	String	-	プレイヤー区分
`playerUrl`	String	-	プレイヤードメイン

`error`

errorの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`errorCode`	Integer	-	エラーコード
`message`	String	-	エラーメッセージ

`sessionLog`

sessionLogの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`logDate`	Date	-	セッションの作成日時
`uuid`	String	-	ユニークユーザー番号 UUID形式
`videoTime`	String	-	再生時間
`actionType`	String	-	アクションタイプ: Media Analytics使用量に対応するイベント情報 `player_start` \| `startup` \| `playing` \| `paused` \| `seeking` \| `rebuffering` \| `prev_tarck` \| `next_track` \| `ended` \| `error` `player_start`: プレイヤー開始 (VPE認証成功後、プレイヤー再生準備完了状態) `startup`: 再生成功 (ユーザーが再生を試みた後、動画の最初の画面を再生) `playing`: 再生時間 (60秒ごとにイベントを報告、60秒以前に別のイベントが発生した場合は即時報告) `paused`: 停止ボタンをクリック `seeking`: ビデオシーク、解像度変更時、バッファリング発生 `rebuffering`: 再生動画のデータ不足によりバッファリング発生 (`seeking`の場合を除く) `prev_tarck`: 前の動画ボタンをクリック `next_track`: 次の動画ボタンをクリック `ended`: 動画を最後まで視聴 (繰り返し再生設定時は、0秒への`seeking`が発生し、`ended`は発生しない) `error`: エラー発生
`actionDuration`	Integer	-	完了までかかった時間 (秒)

`media`

mediaの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`videoType`	String	-	再生ソース区分 `VOD,LIVE` \| `VOD` \| `LIVE` `VOD,LIVE`: VODビデオ、LIVEストリーム `VOD`: VODビデオ `LIVE`: LIVEストリーム
`videoFormat`	String	-	再生ソースの分類
`duration`	Integer	-	動画全体の長さ
`url`	String	-	再生ソース URL
`title`	String	-	動画のタイトル
`logDate`	Date	-	セッションの作成日時

レスポンスステータスコード

Video Player Enhancement APIで共通して使用されるレスポンスステータスコードの詳細は、Video Player Enhancementのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
	"code": 200,
	"message": "sessionRecentDetail",
	"result": {
		"startTime": {
			"playerStartTimeSum": 0.008,
			"videoStartTimeSum": 0.413,
			"totalStartTimeSum": 0.421
		},
		"user": {
			"os": "Windows / 10",
			"isp": "SK Broadband Co Ltd",
			"nation": "Korea, Republic of",
			"address": "ソウル特別市江南区駅三2洞",
			"browser": "Edge / 141.0.0.0",
			"ip": "***.***.***.***",
			"device": "PC",
			"screen": "1680x1050",
			"lang": "ko",
			"visitedPage": "/demo/scrollFloating"
		},
		"player": {
			"playerName": "vpe-guide-website",
			"playerVersion": "latest",
			"playerType": "VPE",
			"playerUrl": "https://vpe.*********.com"
		},
		"error": [],
		"sessionLog": [
			{
				"logDate": "2025-10-08 12:52:00",
				"logDateUnix": "1759895520830",
				"videoTime": 0,
				"watchingPercent": 0,
				"actionType": "player_start",
				"actionDuration": 0.008,
				"quality": "1080p",
				"errorCode": null,
				"errorMessage": null
			},
			{
				"logDate": "2025-10-08 12:52:01",
				"logDateUnix": "1759895521248",
				"videoTime": 0,
				"watchingPercent": 0,
				"actionType": "startup",
				"actionDuration": 0.413,
				"quality": "1080p",
				"errorCode": null,
				"errorMessage": null
			},
			{
				"logDate": "2025-10-08 12:52:02",
				"logDateUnix": "1759895522082",
				"videoTime": 0,
				"watchingPercent": 0,
				"actionType": "playing",
				"actionDuration": 0.834,
				"quality": "1080p",
				"errorCode": null,
				"errorMessage": null
			}
		],
		"media": [
			{
				"videoType": "VOD",
				"videoFormat": "hls",
				"duration": 91,
				"url": "https://*********.naverncp.com/hls/*********/endpoint/sample/221027_NAVER_Cloud_intro_Long_ver_AVC_,FHD_2Pass_30fps,HD_2Pass_30fps,SD_2Pass_30fps,.mp4.smil/master.m3u8",
				"title": "NAVERクラウドの紹介ビデオ",
				"logDate": "2025-10-08 12:52:01"
			}
		]
	}
}