Classic/VPC 환경에서 이용 가능합니다.
플레이어를 통해 재생한 시간 합계를 차트 형식으로 조회합니다. 조회 시작 시점과 종료 시점 간의 간격에 따라 데이터 인터벌이 달라집니다.
| 시작 시점과 종료 시점 간격 | 인터벌 |
|---|---|
| 1일 이하 | 5분 단위 |
| 2일 이상 | 1일 단위 |
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|---|
| GET | /v1/charts/playTimeSum |
요청 헤더
Video Player Enhancement API에서 공통으로 사용하는 헤더에 대한 정보는 Video Player Enhancement 요청 헤더를 참조해 주십시오.
요청 쿼리 파라미터
요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
device |
String | Optional | 플레이어 재생 환경
|
videoType |
String | Optional | 재생 소스 구분
|
startDate |
Date | Optional | 조회 시작 일시
|
endDate |
Date | Optional | 조회 종료 일시
|
요청 예시
요청 예시는 다음과 같습니다.
curl --location --request GET 'https://ma-dashboard-api.vpe.naverncp.com/v1/charts/playTimeSum?device=PC,Mobile&videoType=VOD,LIVE' \
--header 'x-api-key: {API Key}' \
--header 'x-project-id: {Project id}'
응답
응답 형식을 설명합니다.
응답 바디
응답 바디에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
code |
String | - | 응답 코드 |
message |
String | - | 응답 메시지 |
result |
Object | - | 응답 결과 |
result.playTimeSum |
Integer | - | 재생 시간 (초) |
result.logDate |
Date | - | 일시 |
응답 상태 코드
Video Player Enhancement API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Video Player Enhancement 응답 상태 코드를 참조해 주십시오.
응답 예시
응답 예시는 다음과 같습니다.
{
"code": 200,
"message": "playTimeSum (1d)",
"result": [
{
"playTimeSum": 246.551,
"logDate": "2025-10-10 00:00:00"
},
{
"playTimeSum": 78.753,
"logDate": "2025-10-09 00:00:00"
},
{
"playTimeSum": 90.787,
"logDate": "2025-10-08 00:00:00"
},
{
"playTimeSum": 711.575,
"logDate": "2025-10-07 00:00:00"
},
{
"playTimeSum": 0,
"logDate": "2025-10-06 00:00:00"
},
{
"playTimeSum": 0,
"logDate": "2025-10-05 00:00:00"
},
{
"playTimeSum": 2728.3885,
"logDate": "2025-10-04 00:00:00"
},
{
"playTimeSum": 12723.06,
"logDate": "2025-10-03 00:00:00"
},
{
"playTimeSum": 28195.488,
"logDate": "2025-10-02 00:00:00"
},
{
"playTimeSum": 1242.892,
"logDate": "2025-10-01 00:00:00"
}
]
}