이 문서에서는 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는 대규모 데이터 세트를 가져오고 해당 데이터를 필터링, 정렬, 마이닝하는 도구를 제공할 수 있는 애플리케이션을 빌드하는 데 사용됩니다.
각 보고서에는 사전 정의된 필드 집합이 포함되어 있습니다. API를 사용하여 YouTube에서 생성해야 하는 보고서를 식별하는 보고 작업의 일정을 예약합니다. 그러면 YouTube에서 비동기식으로 다운로드할 수 있는 일일 보고서를 생성합니다. 각 보고서에는 고유한 24시간 기간의 데이터가 포함됩니다.
또한 YouTube는 YouTube 크리에이터 스튜디오에서 해당 보고서에 액세스할 수 있는 콘텐츠 소유자를 위해 시스템에서 관리하는 보고서 세트를 자동으로 생성합니다. 이러한 보고서는 광고 수익 데이터에 대한 프로그래매틱 액세스를 제공합니다.
지원되는 보고서
다음 표에는 API를 사용하여 가져올 수 있는 다양한 유형의 보고서가 나와 있습니다. YouTube Analytics API를 사용하여 타겟팅된 쿼리를 사용할 수 있으며 YouTube Reporting API를 사용하여 일괄 보고서를 사용할 수 있습니다.
한 API에서 사용할 수 있는 데이터가 다른 API에서는 사용하지 못할 수 있습니다. 예를 들어 YouTube Analytics API를 사용하면 주별 또는 월별 사용자 활동 측정항목을 가져올 수 있지만 YouTube Reporting API에서는 해당 데이터를 직접 집계해야 합니다. 반면 YouTube Reporting API는 콘텐츠 소유자의 애셋 보고서를 지원하지만 YouTube Analytics API에서는 해당 데이터를 사용할 수 없습니다.
| 보고서 유형 | |
|---|---|
| 동영상 보고서 | 채널 (query 또는 bulk) 및 콘텐츠 소유자 (query 또는 bulk)에 지원됩니다. 동영상 보고서는 채널의 동영상 또는 콘텐츠 소유자의 동영상과 관련된 모든 사용자 활동에 대한 통계를 제공합니다. 예를 들어 이러한 보고서에는 동영상의 조회수가 포함됩니다. YouTube 분석 API에서 일부 콘텐츠 소유자 동영상 보고서에는 예상 수익 및 광고 실적 측정항목도 포함됩니다. |
| 재생목록 보고서 | 채널 (query 또는 bulk) 및 콘텐츠 소유자 (query 또는 bulk)에 지원됩니다. 재생목록 보고서는 재생목록 컨텍스트에서 발생하는 동영상 조회수와 관련된 통계를 제공합니다. YouTube Reporting API는 재생목록의 시청 지속 시간 보고서를 지원하지만 YouTube Analytics API는 유사한 보고서를 지원하지 않습니다. |
| 광고 실적 보고서 | 콘텐츠 소유자 (query 또는 bulk)에 지원됩니다. 광고 실적 보고서는 동영상 재생 중에 게재된 광고의 노출수 기반 측정항목을 제공합니다. 이러한 측정항목은 각 광고 노출을 고려하며 각 동영상 재생은 여러 노출을 발생시킬 수 있습니다. |
| 예상 수익 보고서 | 콘텐츠 소유자 (대량)에게 지원됩니다. 예상 수익 보고서에는 Google 판매 광고 소스 및 비광고 소스에서 발생한 동영상의 총 예상 수익이 표시됩니다. 이러한 보고서에는 일부 광고 실적 측정항목도 포함되어 있습니다. 시스템 관리 보고서에는 실제 수익이 포함됩니다. |
| 저작물 보고서 | 콘텐츠 소유자 (대량)에게 지원됩니다. 저작물 보고서는 콘텐츠 소유자의 저작물에 연결된 동영상과 관련된 사용자 활동 측정항목을 제공합니다. 콘텐츠 소유자가 동영상을 콘텐츠 소유자의 저작물 중 하나의 일치 항목으로 소유권을 주장한 경우 해당 동영상은 콘텐츠 소유자의 보고서에 포함됩니다. 동영상은 콘텐츠 소유자 또는 다른 YouTube 사용자가 업로드했을 수 있습니다. |
| 시스템 관리 보고서 | YouTube 크리에이터 스튜디오의 보고서 메뉴에서 해당 보고서에 액세스할 수 있는 콘텐츠 소유자에게 지원됩니다. 시스템 관리 보고서는 저작물과 동영상에서 얻은 실제 수익 데이터를 제공합니다. 소유권 주장이 제기된 동영상과 해당 동영상과 일치하는 저작물을 나열하는 추가 보고서도 있습니다. 일부 크리에이터 스튜디오 보고서는 API에서 제공되지 않습니다. 참고: YouTube는 크리에이터 스튜디오에서 해당 보고서에 액세스할 수 있는 콘텐츠 소유자를 위해 시스템 관리 보고서를 자동으로 생성합니다. 따라서 이러한 보고서를 가져오는 프로세스는 이 목록에 있는 다른 유형의 보고서와 다릅니다. 자세한 내용은 시스템 관리 보고서 문서를 참고하세요. |
주요 차이점
다음 표는 YouTube 분석 API와 Reporting API의 중요한 차이점을 보여줍니다.
| 기능 | YouTube Analytics API | YouTube Reporting API |
|---|---|---|
| 데이터 검색 프로세스 | 각 API 요청은 반환할 측정기준과 측정항목, 데이터를 반환할 기간을 지정합니다. | 애플리케이션은 보고 작업을 예약합니다. 각 작업에 대해 YouTube는 비동기식으로 다운로드할 수 있는 일일 보고서를 생성합니다. |
| 기간 | 일부 API 보고서에는 사용자 활동이 발생한 날짜가 명시되어 있습니다. 이러한 보고서 중 일부는 월별로 사용자 활동 측정항목을 집계하는 측정기준을 지원합니다. | 모든 API 보고서에는 사용자 활동이 발생한 날짜가 명시됩니다. API를 사용하는 애플리케이션은 주기적 간격으로 데이터를 집계하는 기능을 구현할 수 있습니다. |
| 데이터 필터링 | 측정기준에 특정 값이 있는 행만 포함하도록 보고서를 필터링할 수 있습니다. API는 필터로만 사용되는 대륙, subContinent과 같은 일부 측정기준도 지원합니다. | API는 전체 데이터 세트의 일괄 다운로드를 지원합니다. 필터 전용 측정기준에 대한 필터링 또는 데이터 반환은 지원하지 않습니다. 클라이언트 애플리케이션은 다운로드된 데이터를 저장하고 자체 기능을 구현하여 데이터를 필터링합니다. |
| 정렬 | 반환된 측정항목 값을 기준으로 보고서를 정렬할 수 있습니다. 일부 보고서는 제한된 수의 결과만 지원합니다. 예를 들어 채널에서 조회수가 가장 많은 동영상을 나열하는 보고서는 최대 200개의 행을 반환합니다. | 이 API는 전체 데이터 세트의 일괄 다운로드를 지원합니다. 클라이언트 애플리케이션은 다운로드된 데이터를 정렬하는 자체 기능을 구현할 수 있습니다. |
| 열거 | API 보고서에는 열거된 측정기준 값을 식별하는 'ANDROID' 또는 'CHANNEL'과 같은 텍스트 값이 포함됩니다. | API 보고서에는 텍스트 값에 매핑될 수 있는 정수가 포함되어 있습니다. |
| 할당량 | API 서버는 각 쿼리를 평가하여 할당량 비용을 결정합니다. 할당량 사용량 섹션에서 방법론을 자세히 설명합니다. | 데이터가 한 번 검색된 후 애플리케이션 내에서 필터링, 정렬, 쿼리되므로 할당량 사용량은 문제가 되지 않습니다. |
| 고유 보고서 |
|
|
| 고유 측정기준 | group (필터 전용 측정기준) continent (필터 전용 측정기준) subContinent (필터 전용 측정기준) month viewsPerPlaylistStart averageTimeInPlaylist |
annotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language |
| 순 측정항목 | uniques relativeRetentionPerformance viewsPerPlaylistStart averageTimeInPlaylist |
card_click_rate card_clicks card_impressions card_teaser_click_rate card_teaser_clicks card_teaser_impressions estimated_partner_adsense_revenue estimated_partner_doubleclick_revenue playlist_saves_added playlist_saves_removed |
API 간 이름 지정 차이
두 API는 측정기준과 측정항목을 식별하는 데 다른 이름 지정 규칙을 사용합니다. YouTube Analytics API 이름은 adType와 같이 camelCase를 사용합니다. YouTube Reporting API 이름은 소문자이며 ad_type와 같이 밑줄을 사용합니다.
다음 표에는 두 API가 동일한 측정항목과 측정기준을 식별하는 데 사용하는 이름이 나와 있습니다. 이름을 camelCase에서 밑줄로 변환한 후의 차이보다 두 이름 간의 차이가 더 큰 경우도 있습니다. 예를 들어 YouTube Analytics API의 video 측정기준은 YouTube Reporting API에서 video_id로 이름이 지정됩니다.