이 문서에서는 YouTube Analytics API 및 YouTube Reporting API에서 YouTube 분석 데이터에 대한 액세스 권한을 제공하는 방법의 유사점과 차이점을 설명합니다. 이 문서의 목적은 애플리케이션에 적합한 API를 선택하는 데 도움을 주는 것입니다.
두 API 모두 개발자가 YouTube 분석 데이터를 검색할 수 있도록 지원합니다. 또한 두 API 모두 YouTube 채널 소유자와 YouTube 콘텐츠 소유자를 지원하며, 각 소유자는 다음과 같은 특정 보고서에 액세스할 수 있습니다.
-
채널 보고서는 특정 채널의 사용자 활동 측정항목을 포함합니다.
-
콘텐츠 소유자 보고서는 지정된 YouTube 콘텐츠 소유자와 연결된 모든 채널의 측정항목을 집계하며 예를 들어 음반사는 모든 음반사 아티스트의 YouTube 채널에 대한 통합 통계가 포함된 보고서를 검색할 수 있습니다. 일부 콘텐츠 소유자 보고서에는 사용자 활동 측정항목이 포함되지만, 수익 및 광고 실적과 관련된 측정항목이 포함된 콘텐츠 소유자 보고서도 있습니다.
Reporting API를 사용하면 일부 콘텐츠 소유자가 시스템에서 관리하는 광고 수익 보고서에 액세스할 수 있습니다. 시스템 관리 보고서의 데이터는 Reporting API로만 검색할 수 있습니다.
모든 YouTube 분석 및 YouTube Reporting API 요청은 요청된 데이터를 소유한 채널 또는 콘텐츠 소유자의 승인을 받아야 합니다.
콘텐츠 신고
API가 가져오는 보고서에는 다음 두 가지 유형의 데이터가 포함됩니다.
-
측정기준은 사용자 활동이 발생한 날짜 또는 사용자가 있는 국가와 같은 데이터를 집계하는 데 사용되는 일반적인 기준입니다.
보고서의 각 데이터 행에는 측정기준 값의 고유한 조합이 있습니다. 따라서 각 행의 측정기준 값 조합은 해당 행의 기본 키로 작동합니다.
-
측정항목은 사용자 활동, 광고 실적 또는 예상 수익을 개별적으로 측정한 것입니다. 사용자 활동 측정항목에는 동영상 조회수 및 평점 (좋아요 및 싫어요) 등이 포함됩니다.
애플리케이션에 적합한 API 선택
- YouTube Analytics API
- YouTube Analytics API는 실시간 타겟팅된 쿼리를 지원하여 맞춤 YouTube 분석 보고서를 생성합니다. API는 필터링 및 정렬 매개변수를 제공하므로 호출 애플리케이션에서 이러한 함수를 기본적으로 지원할 필요가 없습니다.
각 API 요청은 데이터를 반환할 기간을 지정합니다. API를 사용하여 주간 및 월간 데이터 세트를 검색할 수도 있습니다. 따라서 호출 애플리케이션은 가져온 데이터 세트를 저장하거나 기간 전반의 통계를 집계하지 않아도 됩니다. - YouTube Reporting API
- YouTube Reporting API는 채널 또는 콘텐츠 소유자의 YouTube 분석 데이터가 포함된 일괄 보고서를 검색합니다. 대규모 데이터 세트를 가져올 수 있고 해당 데이터를 필터링, 정렬, 마이닝하는 도구를 제공하는 애플리케이션을 위해 설계되었습니다.
각 보고서에는 사전 정의된 필드 집합이 포함되어 있습니다. 개발자는 API를 사용하여 보고 작업을 예약하고 각 작업에서 YouTube가 생성해야 하는 보고서를 식별합니다. 그러면 YouTube에서 비동기식으로 다운로드할 수 있는 일일 보고서를 생성합니다. 각 보고서에는 고유한 24시간 동안의 데이터가 포함되어 있습니다.
또한 YouTube 크리에이터 스튜디오에서 해당 보고서에 액세스할 수 있는 콘텐츠 소유자를 위해 시스템 관리 보고서 모음을 자동으로 생성합니다. 이 보고서를 통해 프로그래매틱 방식으로 광고 수익 데이터에 액세스할 수 있습니다. - 자막 관련 사용자 활동
- 재생목록의 시청 지속 시간 데이터
- 콘텐츠 소유자의 예상 수익 보고서 (2가지 보고서 사용 가능)
- 콘텐츠 소유자를 위한 저작물 보고서 (11개의 다양한 보고서 제공)
지원되는 보고서
다음 표에는 API를 사용하여 검색할 수 있는 다양한 보고서 유형이 나와 있습니다. 타겟팅된 쿼리는 YouTube Analytics API를 통해 사용할 수 있으며 일괄 보고서는 YouTube Reporting API를 통해 사용할 수 있습니다.
한 API에서 사용할 수 있는 데이터는 다른 API에서 사용하지 못할 수도 있습니다. 예를 들어 YouTube Analytics API를 사용하면 주별 또는 월별로 사용자 활동 측정항목을 검색할 수 있지만 YouTube Reporting API를 사용하려면 해당 데이터를 직접 집계해야 합니다. 반면 YouTube Reporting API는 콘텐츠 소유자의 저작물 보고서를 지원하지만 이 데이터는 YouTube Analytics API에서 사용할 수 없습니다.
| 보고서 유형 | |
|---|---|
| 동영상 보고서 | 채널 (쿼리 또는 일괄) 및 콘텐츠 소유자 (쿼리 또는 일괄)에서 지원됩니다. 동영상 보고서는 채널 동영상 또는 콘텐츠 소유자의 동영상과 관련된 모든 사용자 활동에 대한 통계를 제공합니다. 예를 들어 이 보고서에는 동영상의 조회수가 포함됩니다. YouTube Analytics API에서 일부 콘텐츠 소유자 동영상 보고서에는 예상 수익과 광고 실적 측정항목도 포함됩니다. |
| 재생목록 보고서 | 채널 (쿼리 또는 일괄) 및 콘텐츠 소유자 (쿼리 또는 일괄)에서 지원됩니다. 재생목록 보고서는 재생목록에서 발생하는 동영상 조회수와 관련된 통계를 제공합니다. YouTube Reporting API는 재생목록에 대한 잠재고객 보유 보고서를 지원하지만 YouTube Analytics API는 유사한 보고서를 지원하지 않습니다. |
| 광고 실적 보고서 | 콘텐츠 소유자 (쿼리 또는 일괄)에 지원됩니다. 광고 실적 보고서는 동영상 재생 중 게재된 광고의 노출 기반 측정항목을 제공합니다. 이러한 측정항목은 각 광고 노출을 나타내며 각 동영상 재생은 여러 노출을 생성할 수 있습니다. |
| 예상 수익 보고서 | 콘텐츠 소유자에게 지원됩니다 (일괄). 예상 수익 보고서는 Google 판매 광고 소스 및 광고 이외의 소스에서 얻은 동영상의 총 예상 수익을 제공합니다. 이 보고서에는 광고 실적 측정항목도 포함되어 있습니다. 시스템 관리 보고서에는 실제 수익이 포함됩니다. |
| 저작물 보고서 | 콘텐츠 소유자에게 지원됩니다 (일괄). 저작물 보고서는 콘텐츠 소유자의 저작물과 연결된 동영상과 관련된 사용자 활동 측정항목을 제공합니다. 콘텐츠 소유자가 콘텐츠 소유자의 저작물 중 하나와 일치하는 동영상으로 소유권을 주장한 경우 콘텐츠 소유자의 보고서에 동영상이 포함됩니다. 콘텐츠 소유자 또는 다른 YouTube 사용자가 업로드한 동영상일 수 있습니다. |
| 시스템 관리 보고서 | YouTube 크리에이터 스튜디오의 보고서 섹션에서 해당 보고서에 액세스할 수 있는 콘텐츠 소유자에게 지원됩니다. 시스템 관리 보고서는 저작물 및 동영상으로 얻은 실제 수익 데이터를 제공합니다. 추가 보고서에는 소유권 주장이 제기된 동영상 및 이러한 동영상과 일치하는 저작물이 표시됩니다. 현재 일부 크리에이터 스튜디오 보고서는 API에서 사용할 수 없습니다. 참고: YouTube에서는 크리에이터 스튜디오에서 해당 보고서 액세스 권한이 있는 콘텐츠 소유자를 위해 시스템 관리 보고서를 자동으로 생성합니다. 따라서 이러한 보고서를 가져오는 프로세스는 이 목록의 다른 보고서 유형과 다릅니다. 자세한 내용은 시스템 관리 보고서 문서를 참고하세요. |
주요 차이점
다음 표에서는 YouTube Analytics와 Reporting API의 중요한 차이점을 보여줍니다.
| 특성 | YouTube Analytics API | YouTube Reporting API |
|---|---|---|
| 데이터 검색 프로세스 | 각 API 요청은 반환될 측정기준 및 측정항목과 데이터를 반환할 기간을 지정합니다. | 애플리케이션에서 보고 작업을 예약합니다. 각 작업에 대해 YouTube는 비동기식으로 다운로드할 수 있는 일일 보고서를 생성합니다. |
| 기간 | 일부 API 보고서에는 사용자 활동이 발생한 날짜가 지정되어 있습니다. 일부 보고서에는 월별 사용자 활동 측정항목을 집계하는 측정기준이 지원됩니다. | 모든 API 보고서는 사용자 활동이 발생한 날짜를 지정합니다. API를 사용하는 애플리케이션은 주기적으로 데이터를 집계하는 기능을 구현할 수 있습니다. |
| 데이터 필터링 | 측정기준에 특정 값이 있는 행만 포함하도록 보고서를 필터링할 수 있습니다. API는 필터로만 사용되는 대륙 및 아대륙과 같은 일부 측정기준도 지원합니다. | API는 전체 데이터 세트의 일괄 다운로드를 지원합니다. 필터 전용 측정기준에 대한 필터링 또는 데이터 반환은 지원하지 않습니다. 클라이언트 애플리케이션은 다운로드한 데이터를 저장하고 데이터를 필터링하는 자체 기능을 구현합니다. |
| 정렬 | 반환된 측정항목 값을 기준으로 보고서를 정렬할 수 있습니다. 일부 보고서에서는 제한된 수의 결과만 지원됩니다. 예를 들어 채널에서 가장 많이 조회된 동영상을 나열하는 보고서는 최대 200개의 행을 반환합니다. | 이 API는 완전한 데이터 세트의 일괄 다운로드를 지원합니다. 클라이언트 애플리케이션은 다운로드한 데이터를 정렬하는 자체 기능을 구현할 수 있습니다. |
| 열거형 | API 보고서에는 'Android' 또는 'CHANNEL'과 같은 텍스트 값이 포함되어 열거형 측정기준 값을 식별합니다. | API 보고서에는 텍스트 값에 매핑할 수 있는 정수가 포함됩니다. |
| 할당량 | API 서버는 각 쿼리를 평가하여 할당량 비용을 결정합니다. 할당량 사용 섹션에서는 방법론을 더 자세히 설명합니다. | 할당량 사용량은 문제가 되지 않습니다. 데이터를 한 번 검색한 다음 애플리케이션에서 필터링하고 정렬하고 쿼리하기 때문입니다. |
| 순 보고서 |
|
|
| 고유 측정기준 | group (필터 전용 측정기준) 대륙 (필터 전용 측정기준) 하위 대륙 (필터 전용 측정기준) 월 isCurated==1 (필터 전용 측정기준) viewsPerPlaylistStart averageTimeInPlaylist |
annotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language |
| 고유 측정항목 | uniques RelativeRetainPerformance viewsPerPlaylistStart averageTimeInPlaylist |
card_click_rate card_clicks card_impressions card_viewer_click_rate card_playlist_clicks card_playlist_impressions estimated_partner_adsense_revenue estimated_partner_doubleclick_re}{17/save{17/11/11} |
API 간 차이점
두 API는 현재 측정기준과 측정항목을 식별하기 위해 다른 이름 지정 규칙을 사용합니다. 현재 YouTube Analytics API 이름에는 카멜 표기법이 사용되지만 YouTube Reporting API 이름에는 밑줄로 구분된 이름이 사용됩니다.
다음 표에서는 두 API가 동일한 측정항목 및 측정기준을 식별하는 데 사용하는 여러 이름을 식별합니다. 두 이름 사이의 차이가 카멜 표기법에서 밑줄로 변환한 결과보다 더 큰 경우도 있습니다. 예를 들어 YouTube Reporting API에서 video 측정기준은 YouTube Reporting API에서 video_id로 명명됩니다.