セッションの直近リストの照会

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

プレイヤーを使用したユーザーの直近100セッションを照会します。照会開始点と終了点の間隔に応じてデータ間隔が異なります。

開始点と終了点の間隔	インターバル
1日以下	5分単位
2日以上	1日単位

リクエスト

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

メソッド	URI
GET	/v1/sessionRecent

リクエストヘッダ

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

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

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

フィールド	タイプ	必須の有無	説明
`device`	String	Optional	プレイヤー再生環境 `PC,Mobile` (デフォルト)\| `PC` \| `Mobile`
`videoType`	String	Optional	再生ソース区分 `VOD,LIVE` (デフォルト) \| `VOD` \| `LIVE` `VOD,LIVE`: VODビデオ、LIVEストリーム `VOD`: VODビデオ `LIVE`: LIVEストリーム
`startDate`	Date	Optional	照会開始日時日付形式(UTC)
`endDate`	Date	Optional	照会終了日時日付形式(UTC)
`limit`	Integer	Optional	セッション数 N~100

リクエスト例

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

curl --location --request GET 'https://ma-dashboard-api.vpe.naverncp.com/v1/sessionRecent?device=PC,Mobile&videoType=VOD,LIVE' \
--header 'x-api-key: {API Key}' \
--header 'x-project-id: {Project id}'

レスポンス

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

レスポンスボディ

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

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

`result`

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

フィールド	タイプ	必須の有無	説明
`no`	Integer	-	番号
`logDate`	Date	-	セッションの作成日時
`uuid`	String	-	ユニークユーザー番号 UUID形式
`origin`	String	-	呼び出しドメイン
`os`	String	-	OS情報
`device`	String	-	プレイヤー再生環境 `PC,Mobile` \| `PC` \| `Mobile`
`totalStartTime`	Integer	-	再生完了報告までかかった時間 (秒)
`rebufferingTime`	Integer	-	バッファリング時間(秒)
`playingTime`	Integer	-	再生時間 (秒)
`isError`	Boolean	-	エラーかどうか `true` \| `false` `true`: エラー `false`: エラーではない
`sessionLog`	Array	-	セッションログ (プレイヤー動作サイクルログ)

`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		完了までかかった時間 (秒)

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

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

レスポンス例

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

{
	"code": 200,
	"message": "sessionRecent (1d)",
	"result": [
		{
			"logDate": "2025-10-10 09:54:38",
			"no": "14611077",
			"uuid": "ad5aea06-fb78-41c7-b2ad-716b685e32db",
			"origin": "https://mediaplus-demo.web.app",
			"os": "Mac OS / 10.15.7 ↑",
			"device": "PC",
			"totalStartTime": 2.4,
			"rebufferingTime": 0.195,
			"playingTime": 244.624,
			"isError": false,
			"sessionLog": [
				{
					"logDate": "2025-10-10 09:49:46",
					"videoTime": "00:00:00",
					"actionType": "player_start",
					"actionDuration": 5,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				},
				{
					"logDate": "2025-10-10 09:49:46",
					"videoTime": "00:00:00",
					"actionType": "startup",
					"actionDuration": 352,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				},
				{
					"logDate": "2025-10-10 09:50:16",
					"videoTime": "00:00:30",
					"actionType": "playing",
					"actionDuration": 30057,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				},
                ...
				{
					"logDate": "2025-10-10 09:54:23",
					"videoTime": "00:00:00",
					"actionType": "startup",
					"actionDuration": 239,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				},
				{
					"logDate": "2025-10-10 09:54:38",
					"videoTime": "00:00:15",
					"actionType": "playing",
					"actionDuration": 14978,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				},
				{
					"logDate": "2025-10-10 09:54:38",
					"videoTime": "00:00:15",
					"actionType": "ended",
					"actionDuration": 0,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				}
			]
		}
	]
}