--- title: "セッションの詳細照会" slug: "vpe-api-sessionrecent-uuid" updated: 2026-09-17T09:58:18Z published: 2026-09-17T09:58:18Z canonical: "api.ncloud-docs.com/vpe-api-sessionrecent-uuid" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # セッションの詳細照会 Classic/VPC環境で利用できます。 プレイヤーを使用したユーザーのセッションに関する詳細情報を照会します。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | GET | /v1/sessionRecent/{Session UUID} | ### リクエストヘッダ Video Player Enhancement APIで共通して使用されるヘッダの詳細は、[Video Player Enhancementのリクエストヘッダ](/docs/ja/vpe-api-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエストクエリパラメータ リクエストクエリパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `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` | Object | - | セッション情報 | | `result.startTime` | Object | - | 再生開始までかかった時間 | | `result.startTime.playerStartTimeSum` | Integer | - | プレイヤー準備時間 (秒) | | `result.startTime.videoStartTimeSum` | Integer | - | 再生開始時間 (秒) | | `result.startTime.totalStartTimeSum` | Integer | - | 総再生時間 (秒) | | `result.user` | Object | - | セッションユーザー情報 | | `result.user.os` | String | - | OS情報 | | `result.user.isp` | String | - | ネットワーク情報 | | `result.user.nation` | String | - | 国情報 | | `result.user.address` | String | - | 位置情報 | | `result.user.browser` | String | - | ブラウザ情報 | | `result.user.ip` | String | - | IPアドレス | | `result.user.device` | String | - | プレイヤー再生環境 - `PC,Mobile`\| `PC` \| `Mobile` | | `result.user.screen` | String | - | 画面解像度 | | `result.user.lang` | String | - | 言語コード | | `result.user.visitedPage` | String | - | 再生されたページ | | `result.player` | Object | - | プレイヤー情報 | | `result.player.playerName` | String | - | プレイヤー名 | | `result.player.playerVersion` | String | - | プレイヤーバージョン | | `result.player.playerType` | String | - | プレイヤー区分 | | `result.player.playerUrl` | String | - | プレイヤードメイン | | `result.error` | Array | - | エラー情報: [error](/docs/ja/vpe-api-sessionrecent-uuid#error) | | `result.sessionLog` | Array | - | セッションログ (プレイヤー動作サイクルログ): [sessionLog](/docs/ja/vpe-api-sessionrecent-uuid#sessionLog) | | `result.media` | Array | - | 再生ソース情報: [media](/docs/ja/vpe-api-sessionrecent-uuid#media) | #### `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のレスポンスステータスコード](/docs/ja/vpe-api-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 ``` { "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" } ] } } ```