API Reference

YouTube Analytics API를 사용하면 YouTube 채널 또는 콘텐츠 소유자의 YouTube 분석 데이터를 가져올 수 있습니다. 이 API는 실시간 쿼리를 지원하고 API 요청 매개변수를 기반으로 보고서를 생성합니다.

이 API는 다음 두 가지 유형의 함수를 지원합니다.

  • 보고서 검색 – API의 reports.query 메서드는 YouTube 분석 보고서를 가져옵니다.

  • YouTube 분석 그룹 관리 – YouTube 분석 그룹은 최대 500개의 채널, 동영상, 재생목록 또는 저작물로 구성된 맞춤 컬렉션입니다. 이 API는 YouTube 분석 그룹을 만들고, 가져오고, 업데이트하는 여러 메서드를 지원합니다. 그러면 채널 및 콘텐츠 소유자는 reports.query 메서드를 사용하여 그룹의 모든 항목에 대한 집계된 데이터를 가져와 실적 분석에 활용할 수 있습니다.

이 페이지에서는 이러한 기능을 사용 설정하는 API 리소스와 메서드에 대해 간략히 설명합니다.

승인

모든 YouTube Analytics API 요청은 승인된 상태여야 합니다. 승인 가이드에서는 OAuth 2.0 프로토콜을 사용하여 승인 토큰을 검색하는 방법을 설명합니다.

YouTube 분석 API 요청은 다음 승인 범위를 사용합니다.

범위
https://www.googleapis.com/auth/yt-analytics.readonly YouTube 콘텐츠에 관한 YouTube 분석 보고서 보기 이 범위를 사용하여 사용자 활동 측정항목(예: 조회수, 평가 횟수)을 조회할 수 있습니다.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly YouTube 콘텐츠에 관한 YouTube 분석 금전 보고서 보기 이 범위에서는 사용자 활동 측정항목, 예상 수익, 광고 실적 측정항목에 액세스할 수 있습니다.
https://www.googleapis.com/auth/youtube YouTube 계정을 관리합니다. YouTube Analytics API에서 채널 소유자는 이 범위를 사용하여 YouTube 분석 그룹과 그룹 항목을 관리합니다.
https://www.googleapis.com/auth/youtubepartner YouTube에서 YouTube 저작물과 관련 콘텐츠를 보고 관리합니다. YouTube 분석 API에서 콘텐츠 소유자는 이 범위를 사용하여 YouTube 분석 그룹과 그룹 항목을 관리합니다.

보고서 검색

API의 reports.query 메서드를 사용하면 다양한 YouTube 분석 보고서를 가져올 수 있습니다. 각 요청은 쿼리 매개변수를 사용하여 채널 ID 또는 콘텐츠 소유자, 시작일, 종료일, 측정항목을 하나 이상 지정합니다. 측정기준, 필터, 정렬 안내와 같은 추가 쿼리 매개변수도 제공할 수 있습니다.

메서드 HTTP 요청 설명
https://youtubeanalytics.googleapis.com/v2를 기준으로 하는 URI
query GET /reports YouTube 분석 보고서를 가져옵니다. 각 API 요청은 쿼리 매개변수를 사용하여 채널 ID 또는 콘텐츠 소유자, 시작일, 종료일, 측정항목을 하나 이상 지정합니다. 측정기준, 필터, 정렬 안내와 같은 추가 쿼리 매개변수도 제공할 수 있습니다.
  • 측정항목은 동영상 조회수 또는 평가 (좋아요 및 싫어요)와 같이 사용자 활동을 개별적으로 측정한 것입니다.
  • 측정기준은 사용자 활동이 발생한 날짜 또는 사용자가 위치한 국가와 같이 데이터를 집계하는 데 사용되는 일반적인 기준입니다. 보고서의 각 데이터 행에는 측정기준 값의 고유한 조합이 있습니다.
  • 필터는 검색할 데이터를 지정하는 측정기준 값입니다. 예를 들어 특정 국가, 특정 동영상 또는 동영상 그룹의 데이터를 검색할 수 있습니다.
지원되는 채널 보고서 및 콘텐츠 소유자 보고서 목록은 유효한 측정항목, 측정기준, 필터 조합을 정의합니다.

그룹 관리

이 API는 YouTube 분석 그룹을 만들고 관리하기 위한 두 가지 리소스를 제공합니다.

그룹

group 리소스는 최대 500개의 채널, 동영상, 재생목록 또는 저작물로 구성된 맞춤 컬렉션인 YouTube 분석 그룹을 나타냅니다.

그룹의 모든 항목은 동일한 유형의 리소스를 나타내야 합니다. 예를 들어 동영상 100개와 재생목록 100개가 포함된 그룹은 만들 수 없습니다.

애널리틱스 그룹에는 내가 업로드했거나 소유권을 주장했거나 내가 관리하는 채널에 연결된 리소스만 포함할 수 있습니다. 따라서 채널 소유자는 동영상 및 재생목록 그룹을 만들 수 있습니다. 콘텐츠 소유자는 동영상, 재생목록, 채널 또는 저작물 그룹을 만들 수 있습니다.

이 리소스에 대한 자세한 내용은 리소스 표현 및 속성 목록을 참조하세요.

메소드 HTTP 요청 설명
https://youtubeanalytics.googleapis.com/v2를 기준으로 하는 URI
list GET /groups API 요청 매개변수와 일치하는 그룹 목록을 반환합니다. 예를 들어 인증된 사용자가 소유한 모든 그룹을 검색하거나 고유 ID로 하나 이상의 그룹을 검색할 수 있습니다.
insert POST /groups YouTube 분석 그룹을 만듭니다. 그룹을 만든 후 groupItems.insert 메서드를 사용하여 그룹에 항목을 추가합니다.
update PUT /groups 그룹의 메타데이터를 수정합니다. 현재 업데이트할 수 있는 속성은 그룹의 제목뿐입니다. groupItems.insert 및 groupItems.delete를 사용하여 그룹 항목을 추가 및 삭제합니다.
delete DELETE /groups 그룹을 삭제합니다.

GroupItems

groupItem 리소스는 YouTube 분석 그룹의 항목을 나타냅니다.

이 리소스에 대한 자세한 내용은 리소스 표현 및 속성 목록을 참조하세요.

메소드 HTTP 요청 설명
https://youtubeanalytics.googleapis.com/v2를 기준으로 하는 URI
list GET /groupItems API 요청 매개변수와 일치하는 그룹 항목 컬렉션을 반환합니다.
insert POST /groupItems 그룹 항목을 만듭니다.
delete DELETE /groupItems 그룹에서 항목을 삭제합니다.