국가

국가 별로 재생 수, 재생시간을 조회합니다.
패키지 별 또는 동영상 별 데이터를 선택적으로 조회할 수 있습니다.
패키지 또는 동영상의 선택이 없는 경우 계정 내 모든 동영상을 시간대별로 조회하며, 특정 패키지 또는 동영상을 선택 시 해당 데이터만 조회합니다.

Request URL

GET https://api.acs.wecandeo.com/report/stats/video/country?sdate={yyyy-mm-dd}&edate={yyyy-mm-dd}&package_id={package Id}&page_size={page size}&sort_direction={sort direction}

Request Parameters

Parameter NameTypeDescription
sdate(Required)String조회할 시작 날짜 (yyyy-mm-dd)
edate(Required)String조회할 마지막 날짜 (yyyy-mm-dd)
package_idNumber패키지 아이디
access_keyString원본 키 (Original Key – Video Access Key_Level 1)
sort_directionString정렬 옵션
- desc : 내림차순
- asc : 오름차순
page_size(Required)Number조회 결과 페이지당 목록 수량
next_tokenString응답 데이터가 남아있는 경우 추가하여 호출
request_idString응답 데이터가 남아있는 경우 추가하여 호출

Response Example

{
    "message": "success",
    "data": {
        "list": [
            {
                "duration": 5438,
                "country": "KR",
                "video_count": 10
            }
        ],
      	"page_size": 1,
        "next_token":"AQ3IwzaJX5eh2Ed4ZWmGT3NLCGUuONwfzC8s%2FFXzfZAMPuR1OcbuAB64hqwPNUAgm0sV7aP3tigRTFYEmyCOVf4mFSLX1YZ28Q%3D%3D",
        "request_id":"6dd8ca03-bd8f-48a8-8cf3-89d73ede9664"
    }
}

Response Data Value

NameTypeDescription
countryStringISO 3166-1
- 국가코드 필요 시 요청

공통 Response 참조

추가 데이터 요청

  • 응답 값에 next_tokenrequest_id가 있고 추가 데이터가 필요한 경우 응답된 next_token, request_id를 사용하여 추가 요청하면, 기존 데이터 이후의 데이터를 응답하게 됩니다.
  • 추가 데이터 요청 시 page_size를 변경하여 호출하면, 변경된 page_size만큼 응답하게 됩니다.