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 Analytics 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 분석 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.insertgroupItems.delete를 사용합니다.
delete DELETE /groups 그룹을 삭제합니다.

그룹 항목

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

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

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