コンテンツ再生リストの照会

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

プレイヤーを通じて再生したコンテンツリスト照会します。プレイヤー設定時にメタデータを設定したデータのみ集計され、照会開始点と終了点の間隔に応じてデータ集計基準が異なります。

リクエスト

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

リクエストヘッダ

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

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

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

リクエスト例

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

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

レスポンス

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

レスポンスボディ

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

list

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

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

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

レスポンス例

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

{
	"code": 200,
	"message": "contents/summary",
	"result": {
		"totalCount": 3,
		"list": [
			{
				"title": "NAVERクラウドの紹介ビデオ",
				"url": "https://*********.naverncp.com/hls/*********/vod/JDPCILtJUbYObLmI/media-plus-99/DQEhtI6zHI_,AVC_SD_1Pass_30fps_1,AVC_HD_1Pass_30fps,AVC_FHD_1Pass_30fps,.mp4.smil/master.m3u8",
				"videoType": "VOD",
				"contentsKey": "4311180*********a3edc1",
				"playCount": 96,
				"playTime": 35136
			},
			{
				"title": "NAVERクラウドの紹介ビデオ",
				"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",
				"videoType": "VOD",
				"contentsKey": "77da5874*********e50ec5ec3",
				"playCount": 52,
				"playTime": 6748
			},
			{
				"title": "NAVERクラウドの紹介ビデオ",
				"url": "https://*********.naverncp.com/hls/*********/vod/JDPCILtJUbYObLmI/media-plus-99/DQEhtI6zHI_,AVC_SD_1Pass_30fps_1,AVC_HD_1Pass_30fps,AVC_FHD_1Pass_30fps,.mp4.smil/master.m3u8",
				"videoType": "VOD",
				"contentsKey": "6dd90907a*********d3566049",
				"playCount": 7,
				"playTime": 17568
			}
		]
	}
}