국가

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

Request URL

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

Request Parameters

Parameter NameTypeDescription
sdate (Required)String조회할 시작 날짜 (yyyy-mm-dd)
edate (Required)String조회할 마지막 날짜 (yyyy-mm-dd)
packageIdNumber패키지 아이디
accessKeyString원본 키 (Original Key)
pageSizeNumber조회 결과 페이지당 목록 수량 (default 30)
sortDataString정렬 대상
- country (국가) (default)
- videoCount (재생수)
- duration (재생시간)
sortDirectionString정렬 옵션
- desc : 내림차순 (default)
- asc : 오름차순

Response Example

{
  "isSuccess":true,
  "message":"",
  "data":{
    "list":[{
      "duration":"316",
      "videoCount":"34",
      "country":"KR"
    }
   ],
    "requestId":"9698c8a2-497b-4cb5-ad60-4f229915e7d3",
    "pageSize":"30",
    "nextToken":""
  }
}

Response Data Value

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

추가 데이터 요청

pageSize를 초과하는 데이터가 존재 하는 경우 다음 Request URL을 이용하여, 추가 데이터를 요청합니다.

Request URL

GET https://api.v4.wecandeo.com/report/statistics/video/v1/country?requestId={request_id}&nextToken={next_token}

Request Parameters

Parameter NameTypeDescription
requestId (Required)String기존 요청 정보 ID
nextToken (Required)String다음 토큰 정보
pageSizeNumber조회 결과 페이지당 목록 수량 (default 30)