서문
비디오 데이터 엔드 포인트는 특정 비디오에 대한 특정 데이터를 빠르게 가져 오는 방법을 제공합니다. 현재 요청은 동영상에 대한 전체 조회수를 반환합니다. 향후 추가 데이터가 반환 될 수 있습니다. 이 엔드포인트의 주요 사용 사례는 트래픽이 많은 페이지에서 플레이어에게 전체 조회수 정보를 전달하는 것입니다. 이 경우 해당 페이지에 정기적으로 대량의 요청을Analytics API보내면 속도가 너무 느립니다.
끝점
비디오 데이터 요청의 끝점은 다음과 같습니다.
https://analytics.api.brightcove.com/v1/alltime/accounts/{account_id}/videos/{video_id}
모든 요청은 GET입니다.
인증
에 대한 모든Analytics API요청은 브라이트코브의 OAuth 서비스를 통해 인증됩니다.
인증은 Authorization 헤더에 전달 된 액세스 토큰을 기반으로합니다.
Authorization: Bearer {your token}
다음에 대한 클라이언트 자격 증명을 얻을 수 있습니다. Analytics API이를 사용하여 임시 액세스 토큰을 검색합니다. OAuth 개요클라이언트 자격 증명 및 액세스 토큰을 얻는 데 사용할 수 있는 다양한 접근 방식에 대한 설명 API 자격 증명 관리 Studio를 통해 클라이언트 자격 증명을 얻는 방법에 대한 정보
대응
요청에 대한 응답은 다음 형식의 JSON입니다.
{
"alltime_video_views": 103123
}
가능한 구현
다음은 동영상 데이터 엔드 포인트를 사용하여 동영상이 플레이어에로드 될 때 동영상에 대한 전체보기를 표시하는 방법입니다.
- 5 ~ 10 분 동안 동영상 ID별로 조회수를 저장하도록 캐싱을 설정합니다.
- 서버 또는 페이지에서 로직을 생성하여 먼저 캐시를 확인하여 현재 동영상에 대한 상시 동영상 조회수 데이터가 이미 있는지 확인한 다음 사용하세요.
- 값이 아직 캐시되지 않은 경우 비디오 정보 엔드 포인트에 요청하여 검색하고 페이지에 표시하는 것과 함께 캐시에 값을 저장합니다.
- 비디오 정보 엔드 포인트에 대한 요청이 시간 초과되거나 실패 할 경우 예외 처리를 설정해야합니다. 단순히 전체 비디오보기를 표시하지 않거나 보유한 마지막 값을 사용할 수 있습니다.
