업데이트 기록

이 페이지에는 YouTube Reporting API 및 YouTube Analytics API 모두에 대한 API 변경사항 및 문서 업데이트가 나와 있습니다. 두 API를 통해 개발자는 서로 다른 방식이지만 YouTube 분석 데이터에 액세스할 수 있습니다. 변경 기록을 구독하세요. 구독

2023년 12월 4일

YouTube 분석 (타겟팅된 쿼리) API가 insightTrafficSourceType 측정기준 값 2개를 병합하도록 업데이트되었습니다. 이전에는 재생목록의 일부로 재생된 동영상(PLAYLIST)과 재생목록의 모든 동영상이 나열된 페이지에서 발생한 조회수(YT_PLAYLIST_PAGE)가 이 측정기준에 구별되었습니다. 앞으로는 두 유형의 조회가 모두 PLAYLIST 측정기준 값과 연결됩니다.

2022년 12월 15일

YouTube 분석 (타겟팅된 쿼리) API는 2개의 새로운 측정기준과 1개의 새 보고서를 지원합니다.

  • 새 보고서에는 도시별 사용자 활동이 나와 있습니다. 이 보고서는 채널콘텐츠 소유자에게 제공됩니다. 이 보고서에는 사용자 활동이 발생한 도시에 대한 YouTube의 추정치를 식별하는 새로운 city 측정기준이 포함됩니다.

  • 새로운 creatorContentType 측정기준은 데이터 행의 사용자 활동 측정항목과 연결된 YouTube 콘텐츠 유형을 식별합니다. 지원되는 값은 LIVE_STREAM, SHORTS, STORY, VIDEO_ON_DEMAND입니다.

    creatorContentType 측정기준은 모든 채널 및 콘텐츠 소유자 동영상 보고서에서 선택 측정기준으로 지원됩니다.

  • 이제 YouTube Analytics API 샘플 요청 가이드에 새로운 측정기준에 대한 예가 모두 포함되었습니다.

  • 7DayTotals30DayTotals 측정기준에 대한 참조가 문서에서 삭제되었습니다. 이 측정기준의 지원 중단은 2019년 10월에 발표되었습니다.

2022년 8월 26일

YouTube 분석 (타겟팅된 쿼리) API와 YouTube Reporting (Bulk Reports) API는 모두 새로운 트래픽 소스 세부정보 값을 지원합니다.

  • YouTube Analytics API (타겟팅된 쿼리) API에서 insightTrafficSourceType 측정기준 값이 SUBSCRIBER인 경우 insightTrafficSourceDetail 값을 podcasts로 설정할 수 있습니다. 이는 트래픽이 팟캐스트 도착 페이지에서 참조되었음을 나타냅니다.
  • YouTube Reporting (Bulk Reports) API에서 traffic_source_type 측정기준 값이 3이면 traffic_source_detail 값을 podcasts로 설정할 수 있습니다. 이는 트래픽이 팟캐스트 도착 페이지에서 참조되었음을 나타냅니다.

2022년 2월 11일

gender 측정기준의 유효한 값 집합은 2022년 8월 11일 이후에 변경됩니다. 이는 API 구현에서 이전 버전과 호환되지 않는 변경사항일 수 있습니다. YouTube API 서비스 약관의 이전 버전과 호환되지 않는 변경사항 섹션에 따라 이 변경사항은 시행 6개월 전에 발표됩니다. 새로운 값 집합으로 원활하게 전환할 수 있도록 2022년 8월 11일 전에 API 구현을 업데이트하시기 바랍니다.

구체적인 변경사항은 다음과 같습니다.

  • YouTube 분석(타겟팅된 쿼리) API에서 gender 측정기준은 현재 두 가지 값(femalemale)을 지원합니다. 2022년 8월 11일부터 이 측정기준은 female, male, user_specified의 3가지 값을 지원합니다.
  • YouTube Reporting (Bulk Reports) API에서 gender 측정기준은 현재 세 가지 값(FEMALE, MALE, GENDER_OTHER)을 지원합니다. 2022년 8월 11일부터 지원되는 값 집합이 FEMALE, MALE, USER_SPECIFIED로 변경됩니다.

2022년 2월 9일

2021년 12월 13일부터 클립 반복 트래픽을 제외하도록 두 가지 측정항목이 업데이트되었습니다. 이 변경사항은 YouTube 분석 (타겟팅된 쿼리) API와 YouTube Reporting (일괄 보고서) API 모두에 영향을 미칩니다.

2022년 2월 2일

이 YouTube Reporting (Bulk Reports) API는 조회수가 Live Redirect에서 발생했음을 나타내는 새로운 트래픽 소스 측정기준 값을 지원합니다.

  • YouTube Reporting (Bulk Reports) API에서 traffic_source_type 측정기준은 28 값을 지원합니다.

이 트래픽 소스 유형의 경우 traffic_source_detail 측정기준은 시청자가 추천한 채널 ID를 지정합니다.

2020년 9월 23일

이 YouTube 분석 (타겟팅된 쿼리) API와 YouTube Reporting (Bulk Reports) API는 모두 YouTube Shorts 시청 환경에서 세로로 스와이프하여 시청자가 추천되었음을 나타내는 새로운 트래픽 소스 측정기준 값을 지원합니다.

  • YouTube Analytics API (타겟팅된 쿼리) API에서 insightTrafficSourceType 측정기준은 SHORTS 값을 지원합니다.
  • YouTube Reporting (Bulk Reports) API에서 traffic_source_type 측정기준은 24 값을 지원합니다.

트래픽 소스 세부정보 측정기준(YouTube Analytics API의 insightTrafficSourceDetail 또는 YouTube Reporting API의 traffic_source_detail)은 이 새로운 트래픽 소스 유형에 대해 채워지지 않습니다.

2020년 7월 20일

이 업데이트에서는 YouTube 분석 (타겟팅 쿼리) API에 영향을 미치는 두 가지 변경사항을 다룹니다.

  • YouTube 분석 보고 그룹의 최대 크기가 항목 200개에서 500개로 늘어났습니다.
  • reports.query 메서드의 filters 매개변수는 YouTube 분석 데이터를 가져올 때 적용해야 하는 필터 목록을 식별합니다. 매개변수는 video, playlist, channel 필터에 여러 값을 지정할 수 있는 기능을 지원하며 이러한 필터에 지정할 수 있는 최대 ID 수가 200개에서 500개로 증가했습니다.

2020년 2월 13일

이 업데이트에는 YouTube 분석 (타겟팅된 쿼리) API 및 YouTube Reporting (Bulk Reports) API와 관련된 다음과 같은 변경사항이 포함됩니다. 이번 변경사항에 대한 자세한 내용은 YouTube 고객센터를 참조하세요.

두 API에서 알림에 대해 가능한 트래픽 소스 세부정보 값의 집합이 변경됩니다. 타겟팅된 쿼리에서 알림은 insightTrafficSourceType=NOTIFICATION로 보고됩니다. 일괄 보고서에서 알림은 traffic_source_type=17로 보고됩니다.

새 값은 이전에 uploaded로 보고된 업로드된 동영상 및 실시간 스트림과 관련된 알림을 두 가지 카테고리로 분할합니다.

  • uploaded_push - 동영상이 업로드될 때 구독자에게 전송된 푸시 알림에서 발생한 조회수
  • uploaded_other - 동영상이 업로드될 때 구독자에게 전송된 푸시 알림 이외의 알림(예: 이메일 또는 받은편지함 알림)에서 발생한 조회수입니다.

이 값은 2020년 1월 13일 (2020년 1월 13일)부터 시작되는 기간에 대해 반환됩니다.

또한 이러한 값은 알림 자체를 나타내는 것이 아니라 특정 YouTube 조회수를 유도한 트래픽 소스를 나타냅니다. 예를 들어 보고서 행에 views=3, traffic_source_type=17 (NOTIFICATION), traffic_source_detail=uploaded_push가 표시된 경우 이 행은 동영상이 업로드될 때 전송된 푸시 알림을 시청자가 클릭하여 3회 조회가 발생했음을 나타냅니다.

2019년 10월 15일

이 업데이트에는 YouTube 분석 (타겟팅된 쿼리) API와 관련된 다음과 같은 변경사항이 포함되어 있습니다.

  • 참고: 이 내용은 지원 중단 공지입니다.

    YouTube에서 7DayTotals30DayTotals 측정기준에 대한 지원을 중단합니다. 2020년 4월 15일까지는 이러한 측정기준을 사용하여 데이터를 검색할 수 있습니다. 해당 날짜 또는 그 이후에 7DayTotals 또는 30DayTotals 측정기준을 사용하여 보고서를 검색하려고 하면 오류가 반환됩니다.

    사용자는 day 측정기준을 사용하여 쿼리하고 7일 또는 30일 기간의 데이터를 집계하거나 도출하여 이러한 측정기준의 일부 데이터를 재현할 수 있습니다. 예를 들면 다음과 같습니다.

    • 7일 동안의 조회수는 해당 기간의 각 날짜에서 발생한 조회수를 집계하여 계산할 수 있습니다.
    • 7일 동안의 시청자 비율은 매일 발생한 조회수에 해당 날짜의 시청자 비율을 곱하여 그날 동영상을 시청할 때 로그인한 시청자 수를 얻어 계산할 수 있습니다. 그런 다음 전체 기간에 로그인한 시청자 수를 합산한 후 해당 기간의 총 조회수로 나누어 전체 기간의 시청자 비율을 구할 수 있습니다.
    • 동일한 시청자를 다른 날에 순 시청자로 계산할 수 있으므로 7일 동안의 순 시청자 수는 계산할 수 없습니다. 하지만 30DayTotals 측정기준 대신 month 측정기준을 사용하여 30일 동안의 순 시청자 수에 대한 데이터를 추정할 수도 있습니다. month 측정기준은 캘린더 월을 참조하지만 30DayTotals 측정기준은 지정된 시작일과 종료일을 기준으로 30일 기간을 계산합니다.

2019년 6월 27일

이 업데이트에는 YouTube 분석 (타겟팅된 쿼리) API와 관련된 다음과 같은 변경사항이 포함되어 있습니다.

  • 이제 API 버전 1이 완전히 지원 중단되었으므로 지원 중단 알림과 버전 2로 업데이트하는 방법을 설명하는 이전 가이드를 포함하여 해당 버전에 대한 참조를 삭제하도록 문서가 업데이트되었습니다.

2018년 11월 1일

이 업데이트에는 YouTube 분석 (타겟팅된 쿼리) API와 관련된 다음과 같은 변경사항이 포함되어 있습니다.

  • API 버전 1이 이제 지원 중단되었습니다. 아직 업데이트하지 않은 경우 서비스 중단을 최소화하기 위해 가능한 한 빨리 API 버전 2를 사용하도록 API 클라이언트를 업데이트하세요. 자세한 내용은 이전 가이드를 참고하세요.

    이 지원 중단 일정은 원래 2018년 4월 26일에 발표된 바 있습니다.

2018년 9월 17일

이 업데이트에는 YouTube 분석 (타겟팅된 쿼리) API와 관련된 다음과 같은 변경사항이 포함되어 있습니다.

  • 데이터 모델 개요 문서의 새로운 데이터 익명처리 섹션에는 측정항목이 특정 기준을 충족하지 않으면 일부 YouTube 분석 데이터가 제한된다는 내용이 설명되어 있습니다. 이는 다양한 경우에 발생할 수 있습니다. 실제로 다음과 같은 경우 보고서에 일부 데이터가 포함되지 않을 수 있습니다.

    1. 지정된 기간 동안 동영상 또는 채널의 트래픽이 적은 경우

      또는

    2. 필터 또는 측정기준을 선택한 경우(예: 트래픽 소스, 국가) 값이 특정 기준을 충족하지 않는 경우

    새 섹션에는 YouTube 분석 보고서에서 제한될 수 있는 데이터 유형에 대한 설명도 포함되어 있습니다.

  • 재생 위치, 트래픽 소스, 기기 유형/운영체제 보고서에서 redViewsestimatedRedMinutesWatched 측정항목이 더 이상 지원되지 않는다는 사실을 반영하도록 채널 보고서콘텐츠 소유자 보고서 문서가 업데이트되었습니다.

2018년 6월 18일

이 업데이트에는 YouTube 분석 (타겟팅 쿼리) API에 다음과 같은 변경사항이 포함되어 있습니다.

  • 다음 메서드의 범위 요구사항이 변경되었습니다.
    • reports.query 메서드에 대한 요청에는 https://www.googleapis.com/auth/youtube.readonly 범위에 액세스할 수 있어야 합니다.
    • groupItems.list 메서드에 대한 요청은 다음 중 하나에 액세스할 수 있어야 합니다.
      • https://www.googleapis.com/auth/youtube 범위
        또는
      • https://www.googleapis.com/auth/youtube.readonly 범위

        https://www.googleapis.com/auth/yt-analytics.readonly 범위

      첫 번째 옵션은 읽기-쓰기 범위인 1개의 범위를 사용하고, 두 번째 옵션은 2개의 읽기 전용 범위를 사용합니다.

2018년 5월 23일

이 업데이트에는 YouTube 분석 (타겟팅 쿼리) API에 다음과 같은 변경사항이 포함되어 있습니다.

  • API 개요에는 측정항목 집계 및 삭제된 항목 집계라는 새로운 섹션이 추가되었습니다. 이 섹션에서는 API 응답이 동영상, 재생목록, 채널 등의 삭제된 리소스와 연결된 데이터를 처리하는 방법을 설명합니다.
  • YouTube Data API를 사용하여 YouTube Analytics API 응답에서 식별된 리소스의 추가 메타데이터를 검색할 수 있음을 알리기 위해 API 개요의 권장사항 섹션이 업데이트되었습니다. YouTube API 서비스 개발자 정책 (III.E.4.b~III.E.4.d항)에 명시된 바와 같이 API 클라이언트는 30일 후에 해당 API에서 저장된 리소스 메타데이터를 삭제하거나 새로고침해야 합니다.

2018년 5월 22일

이 업데이트에는 YouTube Reporting (일괄 보고서) API와 관련된 다음과 같은 변경사항이 포함되어 있습니다.

  • 다음 변경사항은 현재 2018년 7월에 적용될 예정이며, 새 정책은 전 세계적으로 모든 보고서 및 보고 작업에 적용됩니다.
    • 변경이 완료되면 백업 광고 보고서를 비롯한 대부분의 API 보고서는 생성된 후 60일 동안 사용할 수 있습니다. 그러나 이전 데이터가 포함된 보고서는 생성된 후 30일 동안 사용할 수 있습니다.

      그 이전에는 모든 API 보고서가 생성된 후 180일 동안 제공되었습니다. 명확히 알려 드리자면, 이 정책 변경사항이 적용되면 API를 통해 생성된 지 30일이 지난 이전 데이터 보고서도 더 이상 액세스할 수 없습니다. 60일이 지난 다른 모든 보고서에도 더 이상 액세스할 수 없습니다. 따라서 이제 문서에는 정책 변경 전에 생성된 보고서는 최대 180일 동안 제공된다고 명시되어 있습니다.

    • 변경사항이 적용된 후 보고 작업을 예약하면 YouTube에서 해당 날짜 이후로 작업을 예약한 시점으로부터 이전 30일 기간에 관한 보고서를 생성합니다. 변경되기 전에 보고 작업을 예약하면 YouTube에서 작업이 예약된 시간 전 180일 기간에 대한 보고서를 생성합니다.

  • YouTube Data API를 사용하여 보고서에서 식별된 리소스에 대한 추가 메타데이터를 검색할 수 있음을 알리기 위해 권장사항 섹션이 업데이트되었습니다. YouTube API 서비스 개발자 정책 (III.E.4.b~III.E.4.d항)에 명시된 바와 같이 API 클라이언트는 30일 후에 해당 API에서 저장된 리소스 메타데이터를 삭제하거나 새로고침해야 합니다.

  • 보고서 데이터가 필터링되지 않더라도 2018년 6월 1일 이후 특정 기간의 데이터가 포함된 보고서에는 보고서 생성일로부터 최소 30일 전에 삭제된 YouTube 리소스에 대한 참조가 포함되지 않음을 명시하도록 보고서 특성 섹션이 업데이트되었습니다.

  • 새 보고 작업을 예약할 때 이전 보고서는 일반적으로 2일 이내에 게시된다는 점을 포함하도록 API 개요의 이전 데이터 섹션이 업데이트되었습니다. 이전에는 문서에는 이러한 보고서를 확인할 수 있기까지 최대 30일이 걸릴 수 있다고 명시되어 있었습니다.

  • 백필 데이터가 이전에 게재된 세트를 대체하는 데이터 세트로 더 명확하게 정의되도록 API 개요의 백필 데이터 섹션이 업데이트되었습니다.

2018년 4월 26일

이제 YouTube 분석 (타겟팅 쿼리) API 버전 2 (v2)가 공개됩니다. 다음 목록은 새 API 버전과 관련된 제품 및 문서 변경사항을 나타냅니다.

  • v2 API는 v1 API와 거의 동일합니다. 그러나 아래 나열된 변경사항을 반영하도록 코드를 업데이트해야 할 수 있습니다. 이러한 모든 변경사항은 새로운 이전 가이드에 자세히 설명되어 있습니다.

    • API 버전이 v1에서 v2로 변경되었습니다.
    • API 요청의 기준 URL이 https://www.googleapis.com/youtube/analytics/v1에서 https://youtubeanalytics.googleapis.com/v2로 변경되었습니다.
    • reports.query 메서드의 여러 매개변수의 이름이 업데이트되었습니다. 특히 v1 API의 end-date과 같이 하이픈이 포함된 매개변수 이름은 v2 API의 하이픈이 아닌 카멜 표기법 (endDate)을 사용합니다. 이러한 변경으로 인해, API의 그룹 생성 및 관리 메서드에서는 이미 매개변수 이름에 카멜 표기법을 사용했으므로 API 전체에서 매개변수 이름이 일관되게 유지됩니다.
    • v2 API는 Google의 전역 HTTP 일괄 엔드포인트 (www.googleapis.com/batch)로 전송되는 일괄 요청을 지원하지 않습니다. v2 API에서 일괄 요청을 보내는 경우 https://youtubeanalytics.googleapis.com/v2 엔드포인트를 사용해야 합니다.

    또한 다음과 같은 몇 가지 v1 기능이 v2 API에서 지원되지 않습니다.

    • reports.query 메서드는 더 이상 alt, quotaUser, userIp 요청 매개변수를 지원하지 않습니다.
    • v2 API는 다른 API에 대한 요청으로 구성된 일괄 처리를 지원하는 일괄 엔드포인트를 제공하지 않습니다. 그러나 배치는 동일한 API의 여러 메서드에 대한 요청으로 구성될 수 있습니다. Google은 모든 API에서 전역 배치 엔드포인트를 지원 중단하므로 이번 지원 중단은 YouTube Analytics API에만 국한되지 않습니다.
    • v2 API는 API v1에서 지원되었던 JSON-RPC 프로토콜을 지원하지 않습니다. 다시 한번 말씀드리지만 이번 지원 중단은 YouTube Analytics API에만 국한되지 않습니다.

  • 참고: 이 내용은 지원 중단 공지입니다.

    API 버전 1 (v1)은 현재 지원이 중단되었으며 2018년 10월 31일까지 지원됩니다. 이 날짜 이후에는 v1 API에 대한 모든 요청이 더 이상 작동하지 않습니다. 따라서 API를 통해 YouTube 분석 데이터에 액세스하는 데 지장이 없도록 2018년 10월 31일까지 반드시 v2 API로 업그레이드하시기 바랍니다.

2018년 2월 21일

이 업데이트에는 YouTube 분석 (타겟팅 쿼리) API에 다음과 같은 변경사항이 포함되어 있습니다.

  • 시청자의 연령대 및 성별을 기준으로 조회 통계를 집계하는 시청자 인구통계 보고서에서는 사용자 활동이 발생한 YouTube 서비스를 식별하는 youtubeProduct 측정기준을 더 이상 지원하지 않습니다.

2018년 1월 18일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

  • YouTube Reporting API (일괄 보고서)

    • 조회수가 발생한 기기의 소프트웨어 시스템을 식별하는 operating_system 측정기준은 이제 다음 값을 지원합니다.
      • 25: KaiOS
  • YouTube Analytics API (타겟팅된 쿼리)

    • operatingSystem 측정기준은 측정기준 값 KAIOS을 지원합니다.

2017년 12월 20일

이 업데이트에는 YouTube Reporting API와 관련된 두 가지 변경사항이 포함되어 있습니다.

  • 이제 API 서버는 보고서를 다운로드하는 요청에 대해 gzip 압축을 지원합니다. 다른 유형의 API 요청에는 gzip 압축이 지원되지 않습니다. gzip 압축을 사용 설정하면 각 API 응답에 필요한 대역폭이 줄어듭니다. 또한 애플리케이션에서 API 응답의 압축을 풀려면 추가 CPU 시간이 필요하지만, 일반적으로 네트워크 리소스를 적게 소비하는 것이 이 비용보다 크다는 이점이 있습니다.

    gzip으로 인코딩된 응답을 받으려면 다음 예와 같이 Accept-Encoding HTTP 요청 헤더를 gzip로 설정합니다.

    Accept-Encoding: gzip

    이 기능은 API 개요report 리소스의 downloadUrl 속성 정의에 설명되어 있습니다.

  • age groupgender 측정기준에 관한 문서가 수정되어 이러한 측정기준에 대해 API가 반환하는 실제 값을 보여줍니다. 이는 문서 수정사항이며 API 기능이나 동작의 변경사항을 반영한 것이 아닙니다. 특히 다음 값이 변경되었습니다.

    • age_group 측정기준 값은 대문자를 사용하고, AGE 단어와 연령대의 숫자 사이에 밑줄을 포함하고, 하이픈 대신 밑줄을 사용합니다. 따라서 age13-17age18-24과 같은 값은 각각 AGE_13_17AGE_18_24로 수정되었습니다.
    • gender 측정기준 값은 대문자를 사용합니다. 따라서 값 female, male, gender_otherFEMALE, MALE, GENDER_OTHER로 수정되었습니다.

2017년 8월 10일

2016년 8월 10일에 이 문서에서는 YouTube Analytics API의 earnings 측정항목의 지원 중단을 발표했습니다. (동시에 API에서는 동일한 데이터를 제공하는 estimatedRevenue라는 새로운 측정항목에 대한 지원을 추가했습니다.)

earnings 측정항목은 핵심 측정항목이므로 공지된 날로부터 1년 동안 지원되었습니다. 하지만 이제 1년의 기간이 종료되었으므로 earnings 측정항목은 더 이상 지원되지 않습니다. 따라서 earnings 측정항목을 지정하는 API 요청은 이제 400 HTTP 응답 코드를 반환합니다. earnings 측정항목 대신 estimatedRevenue 측정항목을 사용하도록 앱을 아직 업데이트하지 않았다면 최대한 빨리 업데이트하세요.

earnings 측정항목에 대한 나머지 참조를 삭제하도록 API 문서를 업데이트했습니다.

2017년 7월 6일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

  • YouTube Analytics API (타겟팅된 쿼리)

    • API 응답이 쿼리되는 모든 측정항목을 사용할 수 있는 요청된 기간의 마지막 날까지 데이터를 포함한다는 사실을 반영하여 API 문서가 업데이트되었습니다.

      예를 들어 요청에서 종료일을 2017년 7월 5일로 지정하고 요청된 모든 측정항목의 값은 2017년 7월 3일까지만 사용할 수 있으며, 이 날짜가 2017년 7월 3일까지만 응답에 포함될 수 있습니다. (요청된 측정항목 중 일부의 데이터를 2017년 7월 4일에 대한 데이터가 있는 경우에도 마찬가지입니다.)

    • 이제 adType 측정기준에서 reservedBumperInstream 값을 지원합니다. 이 값은 동영상을 보기 전에 재생되는 최대 6초 길이의 건너뛸 수 없는 동영상 광고를 의미합니다. 광고 형식은 auctionBumperInstream 광고와 동일하지만 이 유형은 입찰이 아닌 예약 방식으로 판매되는 광고를 나타냅니다.

  • YouTube Reporting API (일괄 보고서)

    • 이제 ad_type 측정기준은 예약 방식으로 판매되는 범퍼 광고를 나타내는 20 값을 지원합니다. 범퍼 광고는 동영상을 보기 전에 재생되는 건너뛸 수 없는 최대 6초 길이의 동영상 광고입니다. 또한 이 측정기준의 19 값은 예약 기준이 아닌 입찰으로 판매되는 범퍼 광고를 나타냅니다.

    • 다음 YouTube Reporting API 보고서의 보고 작업이 삭제되었습니다.

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      이러한 보고서 유형은 2016년 9월 15일에 지원 중단되었다고 발표되었으며, 2016년 12월 15일 이후에는 해당 보고서 유형에 대한 보고서가 더 이상 생성되지 않습니다. 이전에 생성된 보고서는 생성된 후 180일 동안 계속 사용할 수 있습니다. 따라서 일부 보고서는 2017년 6월 15일부터 액세스할 수 있었습니다. 하지만 보고서를 더 이상 사용할 수 없으므로 보고서와 관련된 작업도 필요하지 않습니다.

2017년 5월 24일

다음 YouTube Reporting API 보고서의 모든 보고 작업이 삭제되었습니다.

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

이러한 보고서 유형은 2016년 6월 22일에 지원 중단되었다고 발표되었으며, 2016년 9월 22일 이후에는 해당 보고서 유형에 대한 보고서가 더 이상 생성되지 않습니다. 이전에 생성된 보고서는 생성된 후 180일 동안 계속 사용할 수 있습니다. 따라서 일부 보고서는 2017년 3월 22일부터 액세스할 수 있었습니다. 하지만 보고서를 더 이상 사용할 수 없으므로 보고서와 관련된 작업도 필요하지 않습니다.

2017년 5월 22일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

  • YouTube Reporting API (일괄 보고서)

    • 동영상 공유에 사용된 서비스를 식별하는 sharing_service 측정기준이 이제 다음 값을 지원합니다.

      • 85: YouTube Music
      • 86: YouTube 게임
      • 87: YouTube Kids
      • 88: YouTube TV

      또한 52 값을 식별하는 데 사용된 이름이 값 73 (카카오 스토리)과 더 명확하게 구분되도록 문서의 카카오 (카카오톡)로 업데이트되었습니다. 이러한 변경사항에는 이러한 서비스와 공유된 동영상의 API 동작 또는 분류에는 변경사항이 반영되지 않습니다.

  • YouTube Analytics API (타겟팅된 쿼리)

    • 이제 sharingService 측정기준은 다음 값을 지원합니다.

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

2017년 3월 28일

크리에이터 스튜디오에서 YouTube 분석을 통해 수익 데이터에 액세스할 수 있는 채널 소유자는 이제 YouTube Analytics API를 통해서도 수익 데이터에 액세스할 수 있습니다.

2017년 3월 17일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

  • YouTube Analytics API는 YouTube Red 시청률과 관련된 redViewsestimatedRedMinutesWatched 측정항목을 지원합니다. 실제로 얼마 전부터 API에서 이러한 측정항목을 지원했으며 2016년 9월 15일에 발표된 바와 같이 YouTube Reporting API는 이미 두 측정항목을 모두 지원합니다.

    • redViews 측정항목은 YouTube Red 회원이 동영상을 시청한 횟수를 나타냅니다.
    • estimatedRedMinutesWatched 측정항목은 YouTube Red 회원이 동영상을 시청한 시간(분)을 나타냅니다.

    채널 보고서콘텐츠 소유자 보고서 문서가 업데이트되어 두 가지 새로운 측정항목을 지원하는 보고서가 표시됩니다. 이미 viewsestimatedMinutesWatched 측정항목을 지원한 모든 보고서에서 지원됩니다.

2017년 3월 3일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

  • YouTube Reporting API (일괄 보고서)

    • 측정기준 값이 지정된 일, 월, 연도의 태평양 표준시 오후 12시 59분에 끝나는 기간을 나타내도록 date 측정기준의 정의가 수정되었습니다. 연중 시간에 따라 태평양 시간은 UTC-7 또는 UTC-8입니다.

      날짜는 일반적으로 24시간 기간을 나타내고, 앞으로 조정되는 날짜는 23시간을 나타내고, 시간이 반대로 조정되는 날짜는 25시간 기간을 나타냅니다. (이전에는 문서에 각 날짜가 고유한 24시간 기간을 나타내고 태평양 시간은 항상 UTC-8이라고 명시되었습니다.)

      이 수정사항은 실제 API 동작의 변화를 나타내지 않습니다.

    • 조회수가 발생한 기기의 소프트웨어 시스템을 식별하는 operating_system 측정기준이 이제 다음과 같은 값을 지원합니다.
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia
    • content_owner_basic_a1 보고서 유형의 모든 보고 작업이 삭제되었습니다. 이 보고서 유형은 2016년 8월 19일 기준으로 완전히 지원 중단되었지만, 이전에 생성된 content_owner_basic_a1 보고서는 생성된 후 180일 동안 계속 사용할 수 있었습니다. 따라서 일부 보고서는 2017년 2월 19일부터 액세스할 수 있었습니다. 하지만 보고서를 더 이상 사용할 수 없으므로 보고서와 관련된 작업도 필요하지 않습니다.

  • YouTube Analytics API (타겟팅된 쿼리)

    • 측정기준 값이 태평양 표준시 오전 12시에 시작해 태평양 표준시로 지정된 일, 월, 연도의 오후 11시 59분에 끝나는 기간임을 나타내도록 time periods와 관련된 측정기준에 대한 설명이 수정되었습니다. 연중 시간에 따라 태평양 시간은 UTC-7 또는 UTC-8입니다.

      날짜는 일반적으로 24시간 기간을 나타내고, 앞으로 조정되는 날짜는 23시간을 나타내고, 시간이 반대로 조정되는 날짜는 25시간 기간을 나타냅니다. (이전에는 태평양 표준시가 UTC-8이라고 명시되었고 하루가 24시간을 나타내지 않을 가능성에 대해서는 언급하지 않았습니다.)

      이 수정사항은 실제 API 동작의 변화를 나타내지 않습니다.

    • 현재 채널 보고서에는 수익 또는 광고 실적 측정항목이 포함되지 않음을 명시하도록 채널 보고서 문서가 업데이트되었습니다. 따라서 현재 https://www.googleapis.com/auth/yt-analytics-monetary.readonly 범위는 채널 보고서의 수익 데이터에 대한 액세스 권한을 부여하지 않습니다.

    • operatingSystem 측정기준은 3가지 새로운 측정기준 값을 지원합니다.
      • FIREFOX
      • REALMEDIA
      • TIZEN

2017년 2월 8일

이제 YouTube Analytics API에서 include-historical-channel-data 매개변수(선택사항)를 지원합니다. 이 매개변수는 콘텐츠 소유자 보고서를 가져올 때만 관련이 있습니다.

이 매개변수를 사용하면 콘텐츠 소유자가 API 응답에 채널의 시청 시간과 채널이 콘텐츠 소유자와 연결되기 전 기간의 조회 데이터를 포함해야 함을 나타낼 수 있습니다. 기본 매개변수 값은 false입니다. 즉, 기본적으로 API 응답에는 채널이 콘텐츠 소유자와 연결된 시점의 시청 시간 및 조회수 데이터만 포함됩니다.

다음 규칙은 API 요청이 여러 채널의 데이터를 검색하는 경우에도 적용됩니다.

  • 매개변수 값이 false인 경우 특정 채널에 대해 반환되는 시청 시간 및 조회수 데이터는 채널이 콘텐츠 소유자와 연결된 날짜를 기준으로 합니다.

    다른 날짜에 콘텐츠 소유자와 연결된 채널이 다를 수 있다는 점에 유의해야 합니다. API 요청이 여러 채널의 데이터를 검색하고 매개변수 값이 false인 경우 API 응답에는 각 채널의 연결 날짜를 기준으로 시청 시간 및 조회수 데이터가 포함됩니다.
  • 매개변수 값이 true이면 응답은 API 요청에 지정된 시작일과 종료일을 기준으로 모든 채널의 시청 시간 및 조회수 데이터를 반환합니다.

2016년 12월 15일

다음 YouTube Reporting API 보고서는 더 이상 지원되지 않으며 문서에서 삭제되었습니다. 각 보고서의 최신 버전을 사용할 수 있습니다. 이 보고서의 지원 중단 공지는 2016년 9월 15일입니다.

API 참조 문서의 현재 보고서 유형 목록도 업데이트되었습니다.

2016년 11월 11일

이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    YouTube Reporting API는 3개의 새로운 최종 화면 보고서와 이러한 보고서의 새로운 측정기준 및 측정항목을 지원합니다. 이 보고서는 동영상 재생이 중지된 후 표시되는 최종 화면의 노출수 및 클릭연결 통계를 제공합니다.

    2016년 11월 8일

    이 업데이트에는 YouTube Analytics API가 다음과 같이 변경되었습니다.

    • 다음 목록의 측정항목은 완전히 지원 중단되었으며 더 이상 지원되지 않습니다. 2016년 8월 10일에 발표된 바와 같이 동일한 데이터를 참조하는 새 측정항목은 이미 지원되고 있습니다. 아래 표에는 지원 중단된 측정항목 이름과 새 측정항목 이름이 나와 있습니다.

      지원 중단된 측정항목 새 측정항목
      adEarnings estimatedAdRevenue
      impressionBasedCpm cpm
      impressions adImpressions
      redPartnerRevenue estimatedRedPartnerRevenue

    2016년 10월 27일

    이제 YouTube에서는 YouTube 크리에이터 스튜디오의 보고서 섹션에서 관련 보고서에 액세스할 수 있는 콘텐츠 소유자를 위해 시스템 관리 광고 수익 보고서 모음을 자동으로 생성합니다. 새로운 시스템 관리 API 보고서는 수동으로 다운로드 가능한 크리에이터 스튜디오 보고서에서도 사용할 수 있는 데이터에 대한 프로그래매틱 액세스를 제공하도록 설계되었습니다.

    시스템 관리 보고서 개요에서는 새 보고서에 대한 간략한 개요를 제공하고 API를 통해 새 보고서를 검색하는 과정을 설명합니다. 파트너는 보고서를 생성하기 위해 작업을 예약할 필요가 없으므로 이 프로세스는 YouTube 분석의 일괄 보고서를 가져오는 프로세스와 약간 다릅니다.

    reportType 리소스의 id 속성이 API를 통해 액세스할 수 있는 시스템 관리 보고서 목록을 포함하도록 업데이트되었습니다.

    • 동영상별 전 세계 월별 광고 수익
    • 동영상별 국가별 일일 광고 수익
    • 저작물별 전 세계 월간 광고 수익
    • 저작물별 국가별 일일 광고 수익
    • 소유권 주장 (이 보고서에는 수익 데이터가 포함되지 않음)

    2016년 9월 27일

    참고: 이 내용은 지원 중단 공지입니다.

    YouTube Analytics API의 uniques 측정항목이 지원 중단되었습니다. 이는 핵심 측정항목이 아니며 2016년 10월 31일까지 지원됩니다.

    2016년 9월 15일

    이 업데이트에는 다음과 같은 YouTube Reporting API 변경사항이 포함되어 있습니다.

    2016년 8월 19일

    이 업데이트에는 다음과 같은 YouTube Reporting API 변경사항이 포함되어 있습니다.

    • content_owner_basic_a1 보고서는 완전히 지원 중단되었으며 문서에서 삭제되었습니다. YouTube에서는 더 이상 이러한 유형의 새 보고서를 생성하지 않지만, 이미 생성된 보고서는 생성된 날로부터 180일 동안 계속 사용할 수 있습니다.

      content_owner_basic_a1 보고서는 2016년 5월 19일 업데이트 기록 항목에 설명된 대로 content_owner_basic_a2 보고서를 대체합니다.

    2016년 8월 11일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • 새로 게시된 YouTube API 서비스 약관 ('업데이트된 약관')은 YouTube 엔지니어링 및 개발자 블로그에서 자세히 논의되었으며 현재 서비스 약관에 대한 다양한 업데이트 사항을 제공합니다. 2017년 2월 10일부터 적용되는 업데이트된 약관 외에도 이 업데이트에는 개발자가 준수해야 하는 정책을 설명하는 몇 가지 지원 문서가 포함되어 있습니다.

      새로운 문서의 전체 내용은 업데이트된 약관의 업데이트 내역에 설명되어 있습니다. 또한 업데이트된 약관 또는 해당 증빙 문서에 대한 향후 변경은 해당 업데이트 내역에 설명되어 있습니다. 문서의 링크에서 업데이트 기록의 변경사항이 나열된 RSS 피드 구독을 구독할 수 있습니다.

    2016년 8월 10일

    이 업데이트에는 다음과 같은 변경사항이 포함되어 있습니다.

    • YouTube Analytics API (타겟팅된 쿼리)

      • 참고: 이 내용은 지원 중단 공지입니다.

        다음 표의 측정항목은 지원 중단됩니다. 동시에 동일한 데이터를 참조하는 새로운 측정항목이 도입되고 있습니다. 즉, 이전 측정항목의 이름이 변경됩니다. 하지만 YouTube Analytics API는 표에 나열된 지원 중단일까지 두 측정항목 이름을 모두 지원합니다.

        측정항목의 이전 이름 새 측정항목 이름 지원 날짜
        earnings estimatedRevenue 2017년 8월 10일
        adEarnings estimatedAdRevenue 2016년 11월 4일
        redPartnerRevenue estimatedRedPartnerRevenue 2016년 11월 4일
        impressionBasedCpm cpm 2016년 11월 4일
        impressions adImpressions 2016년 11월 4일

        earnings 측정항목은 핵심 측정항목이었으므로 발표일로부터 1년 동안 지원됩니다. 핵심 측정항목이 아닌 다른 측정항목은 2016년 11월 4일까지 3개월 동안 지원됩니다.

        예를 들어 2016년 11월 4일까지 API 요청에서 impressionBasedCpm 측정항목이나 cpm 측정항목 또는 둘 다를 지정할 수 있습니다. 하지만 이 날짜 이후에는 cpm 측정항목만 지원됩니다.

      • insightTrafficSourceType 측정기준은 다음 두 가지 새로운 측정기준 값을 지원합니다.
        • CAMPAIGN_CARD: 이 트래픽 소스는 콘텐츠 소유자 보고서에서만 지원됩니다. 이 표시는 콘텐츠 소유자가 조회한 콘텐츠를 홍보하기 위해 사용한, 소유권 주장이 제기된 사용자 업로드 동영상에서 조회수가 발생했음을 나타냅니다.
        • END_SCREEN: 다른 동영상의 최종 화면에서 발생한 조회수와 관련된 데이터입니다.

        두 새 트래픽 소스의 경우 traffic source detail 보고서를 가져올 수도 있습니다. 두 경우 모두 insightTrafficSourceDetail 측정기준은 시청자가 추천된 동영상을 식별합니다.

      • 이제 adType 측정기준에서 auctionBumperInstream 값을 지원합니다. 이 값은 동영상을 보기 전에 재생되는 최대 6초 길이의 건너뛸 수 없는 동영상 광고를 의미합니다.

    • YouTube Reporting API (일괄 보고서)

      • 이제 traffic_source_type 측정기준에서 다음 값을 지원합니다.
        • 19: 이 트래픽 소스는 콘텐츠 소유자 보고서에서만 지원됩니다. 이 표시는 콘텐츠 소유자가 조회한 콘텐츠를 홍보하기 위해 사용한, 소유권 주장이 제기된 사용자 업로드 동영상에서 조회수가 발생했음을 나타냅니다.
        • 20: 다른 동영상의 최종 화면에서 발생한 조회수와 관련된 데이터입니다.

        두 가지 새로운 트래픽 소스 모두 traffic_source_detail 측정기준은 시청자가 추천된 동영상을 식별합니다.

      • estimated_partner_revenue를 핵심 측정항목으로 나열하고 해당 목록에서 earnings을 삭제하도록 API의 핵심 측정항목 목록이 수정되었습니다. earnings 측정항목은 YouTube Reporting API에서 지원되는 적이 없습니다.

      • 이제 ad_type 측정기준은 범퍼 광고를 참조하는 19 값을 지원합니다. 범퍼 광고는 동영상을 보기 전에 재생되는 최대 6초 길이의 건너뛸 수 없는 동영상 광고입니다.

    2016년 7월 18일

    이 업데이트에는 다음과 같은 변경사항이 포함되어 있습니다.

    • YouTube Analytics API (타겟팅된 쿼리)

      • 다음 채널 보고서에서 지원되는 측정항목 목록이 카드 측정항목을 포함하도록 업데이트되었습니다. 이 보고서에서 카드 측정항목 지원은 실제로 2016년 6월 28일에 추가되었으며 해당 날짜의 업데이트 기록 항목에서 변경사항에 대해 자세히 설명합니다. 보고서는 다음과 같습니다.
        • 미국 주의 기본 사용자 활동
        • 특정 기간 동안의 미국 여러 주의 사용자 활동
        • 행정구역별 사용자 활동
        • 구독 상태별 사용자 활동
        • 지방의 구독 상태별 사용자 활동
        • 주별 인기 동영상
        • 구독 또는 미구독 시청자의 인기 동영상
      • video 필터가 필요하고 group 필터가 지원되지 않음을 반영하기 위해 채널 시청 지속 시간 보고서콘텐츠 소유자 시청 지속 시간 보고서의 필터 목록이 수정되었습니다.

        이전에는 두 보고서의 문서에 이 두 필터 중 하나를 사용하거나 두 필터 모두 사용하지 않고 보고서를 가져올 수 있다고 잘못 기술되어 있었습니다.

    • YouTube Reporting API (일괄 보고서)

      • API 개요에서 보고서의 다운로드 URL을 검색하는 방법을 설명하는 섹션이 데이터가 없는 날짜에 대해 YouTube에서 다운로드 가능한 보고서를 생성한다고 명시하도록 수정되었습니다. 이러한 보고서에는 헤더 행이 있지만 추가 데이터는 포함되어 있지 않습니다. 이 정보는 동일한 문서의 보고서 특성 섹션에서 2016년 4월 12일에 이미 업데이트되었습니다.
      • content_owner_asset_cards_a1 보고서의 측정기준 목록이 보고서에서 card_id 측정기준을 사용함을 반영하여 수정되었습니다. 이전에는 문서에 측정기준 이름이 card_title로 잘못 표시되었습니다.

    2016년 6월 28일

    여러 채널콘텐츠 소유자 보고서에서 카드 측정항목에 대한 지원을 반영하도록 YouTube Analytics API 문서가 업데이트되었습니다. 새로 지원되는 측정항목은 다음과 같습니다.

    측정항목은 다음 유형의 보고서에서 지원됩니다.

    2016년 6월 22일

    이 업데이트에는 다음과 같은 YouTube Reporting API 변경사항이 포함되어 있습니다. 첫 번째 변경사항은 일반적으로 API에 적용되며 나머지 변경사항은 콘텐츠 소유자 보고서에만 영향을 미칩니다.

    • 보고서가 생성된 후 180일 동안 API를 통해 보고서를 사용할 수 있음을 명확히 하기 위해 API 개요의 보고서 특성 섹션이 업데이트되었습니다.

      이전에는 문서에 API 요청이 전송된 날짜로부터 최대 180일 동안 보고서를 사용할 수 있다고 명시되어 있었습니다. 원문은 기술적으로는 사실이지만 그래도 기껏해야 보다 혼란스러웠습니다.

    • API는 세 가지 보고서의 새 버전을 지원합니다. 그 중 두 보고서에는 새로운 측정항목과 이름이 변경된 측정항목도 포함되어 있습니다.

      • content_owner_ad_rates_a1 보고서는 content_owner_ad_performance_a1 보고서의 새로운 버전입니다. 새로 이름이 변경된 보고서는 이전 버전과 동일합니다.

      • 새 버전이 있는 두 보고서의 이름이 변경되었습니다.

        • content_owner_estimated_earnings_a1 보고서의 새 버전의 이름은 content_owner_estimated_revenue_a1입니다.
        • content_owner_asset_estimated_earnings_a1 보고서의 새 버전의 이름은 content_owner_asset_estimated_revenue_a1입니다.

        새로 이름이 지정된 두 보고서는 다음과 같은 점에서 이전 버전과 다릅니다.

      이러한 보고서의 이전 버전을 만드는 작업이 이미 있는 경우 이름이 변경된 보고서에 대해 새 작업을 만들어야 합니다. 새 보고서 버전이 출시되면서 content_owner_ad_performance_a1, content_owner_estimated_earnings_a1, content_owner_asset_estimated_earnings_a1 보고서가 지원 중단되었습니다.

      이러한 보고서에 대한 작업이 있는 경우 YouTube는 2016년 9월 22일 이후에는 이러한 작업에 대한 새 보고서를 생성하지 않습니다. 생성된 보고서는 생성된 후 180일 동안 계속 사용할 수 있습니다.

    • reportType 리소스의 id 속성 정의가 현재 사용 가능한 보고서 집합을 반영하도록 업데이트되었습니다.

    • 문서의 두 측정항목의 이름이 보고서에 표시되는 이름과 일치하도록 수정되었습니다. 이는 순수한 문서 수정사항이며 실제 보고서 내용의 변경사항을 반영한 것은 아닙니다.

      • estimated_partner_adsense_revenue 측정항목의 이름이 estimated_partner_ad_sense_revenue로 업데이트되었습니다. 그러나 이 측정항목은 이번 업데이트로 지원이 중단되는 두 보고서에만 표시됩니다. 위에 설명된 대로 이 측정항목의 이름은 최신 버전의 보고서에서 estimated_partner_ad_auction_revenue로 변경되었습니다.
      • estimated_partner_doubleclick_revenue 측정항목의 이름이 estimated_partner_double_click_revenue로 업데이트되었습니다. 이 측정항목은 이번 업데이트로 지원이 중단되는 두 보고서에만 표시됩니다. 위에 설명된 대로 이 측정항목의 이름은 최신 버전의 보고서에서 estimated_partner_ad_reserved_revenue로 변경되었습니다.

    • Reporting API의 측정기준 문서가 더 이상 elapsed_video_time_percentageaudience_retention_type 속성을 표시하지 않도록 업데이트되었습니다. 다음 측정기준은 현재 API를 통해 제공되는 보고서에서는 지원되지 않습니다.

    2016년 5월 19일

    이 업데이트에는 다음과 같은 YouTube Reporting API 변경사항이 포함되어 있습니다.

    • API는 새로운 버전의 콘텐츠 소유자를 위한 사용자 활동 보고서를 지원합니다. 새 보고서의 보고서 유형 ID는 content_owner_basic_a2입니다. 이전 버전의 보고서인 content_owner_basic_a1와 달리 새 버전은 likesdislikes 측정항목을 지원합니다.

      content_owner_basic_a1 보고서를 만드는 작업이 이미 있는 경우에도 content_owner_basic_a2 보고서를 위한 새 작업을 만들어야 합니다. YouTube는 콘텐츠 소유자를 새 보고서 버전으로 자동 이전하거나 새 보고서 버전을 생성하는 작업을 자동으로 만들지 않습니다. 일부 구현에서는 예기치 않은 새 작업의 모양이 브레이킹 체인지일 수 있습니다.

      새 보고서의 출시와 함께 content_owner_basic_a1 보고서는 지원 중단되었습니다. 해당 보고서에 대한 작업이 있는 경우 YouTube는 2016년 8월 19일 이후에는 해당 작업에 대한 새 보고서를 생성하지 않습니다. 생성된 보고서는 생성된 후 180일 동안 계속 사용할 수 있습니다.

    • reportType, job, report 리소스는 모두 연결된 리소스가 지원 중단된 보고서 유형을 나타내는지 여부를 식별하는 새 속성을 지원합니다.

      • reportType 리소스의 deprecateTime 속성은 보고서 유형이 지원 중단되는 날짜와 시간을 지정합니다. 이 속성에는 지원 중단된 것으로 발표된 보고서의 값만 있으며 이 값은 YouTube에서 해당 유형의 보고서 생성을 중단할 날짜를 나타냅니다.

        보고서 유형이 지원 중단으로 발표되면 YouTube는 이후 3개월 동안 해당 유형의 보고서를 생성합니다. 예를 들어 2016년 5월 19일에 업데이트된 이 업데이트는 content_owner_basic_a1 보고서의 지원 중단을 발표합니다. 따라서 이 보고서 유형의 deprecateTime은 2016년 8월 19일을 기준으로 특정 시간을 지정하며, 이후에는 YouTube에서 해당 유형의 보고서 생성을 중지합니다.

      • job 리소스의 expireTime 속성은 작업이 만료되거나 만료되는 날짜와 시간을 지정합니다. 작업과 연결된 보고서 유형이 지원 중단되었거나 작업에 대해 생성된 보고서가 장기간 다운로드되지 않은 경우 이 속성에 값이 있습니다. 날짜는 YouTube에서 더 이상 작업에 대한 새 보고서를 생성하지 않는 시간을 표시합니다.

      • report 리소스의 jobExpireTime 속성은 보고서와 연결된 작업이 만료되거나 만료되는 날짜와 시간을 지정합니다. 이 속성에는 이 목록의 이전 항목에 설명된 대로 job 리소스의 expireTime 속성과 동일한 값이 포함됩니다.

    • 이제 지원 중단된 보고서의 작업을 만들려고 하면 jobs.create 메서드가 400 HTTP 응답 코드 (Bad Request)를 반환합니다. 또한 메서드 문서에는 이제 API 요청 실패의 원인이 되는 여러 다른 이유가 나열되어 있습니다.

    2016년 4월 12일

    이 업데이트에는 다음과 같은 변경사항이 포함되며, 모든 변경사항은 YouTube Reporting API에만 영향을 미칩니다.

    • 이제 YouTube에서는 보고 작업이 처음 예약되기 전 180일간의 데이터를 생성합니다. 이전에는 Reporting API를 통해 이전 데이터가 제공되지 않았습니다. 이 변경사항은 이 공지 이전에 생성된 작업을 비롯한 모든 작업에 영향을 미칩니다.

      이력 보고서는 제공되는 즉시 게시되지만, 작업에 대한 모든 과거 데이터가 게시되는 데는 약 한 달이 소요됩니다. 따라서 보고 작업을 예약한 지 한 달 후 약 7개월분의 데이터에 액세스할 수 있습니다. (이 발표 이전에 생성된 모든 채용정보의 과거 데이터는 발표일로부터 한 달 이내에 게시되어야 합니다.)

      이전 데이터는 2015년 7월 1일 이후의 데이터만 사용할 수 있습니다. 따라서 2015년 12월 28일 이전에 생성된 작업의 과거 데이터는 180일 미만이 됩니다.

      이러한 변경사항은 Reporting API 개요의 새로운 이전 데이터 섹션에 모두 설명되어 있습니다.

    • YouTube Reporting API 개요의 보고서 특성 섹션에 다음과 같은 변경사항이 업데이트되었습니다.

      • 이제 문서에는 보고서를 생성된 후 180일 동안 사용할 수 있으므로 API 클라이언트에서 다운로드할 수 있다고 명시되어 있습니다. 이전에는 문서에 API 요청이 전송된 날짜로부터 최대 6개월 동안 보고서를 사용할 수 있다고 명시되어 있었습니다.

      • API가 사용 가능한 데이터가 없는 날에 대해 다운로드 가능한 보고서를 생성한다는 사실을 반영하여 문서를 업데이트했습니다. 이러한 보고서에는 헤더 행이 포함되지만 추가 데이터는 포함되지 않습니다.

    • YouTube Reporting API에서 광고 수익 데이터 또는 YouTube Red 구독 수익 데이터가 포함된 시스템 관리 보고서 자동 생성 기능이 곧 지원될 예정입니다. 이 보고서는 YouTube 크리에이터 스튜디오에서 직접 다운로드 가능한 수익 보고서에 액세스할 수 있는 콘텐츠 소유자에게 제공됩니다. 따라서 새로운 API 기능이 해당 데이터에 대한 프로그래매틱 액세스를 제공합니다.

      시스템 관리 보고서의 출시에 대비하여 다음과 같은 API 변경사항이 발표됩니다.

      • job 리소스의 새로운 systemManaged 속성은 리소스가 시스템 관리 보고서를 생성하는 작업을 설명하는지 여부를 나타냅니다. YouTube는 YouTube 콘텐츠 소유자에 대한 시스템 관리 보고서를 자동으로 생성하며 콘텐츠 소유자는 이러한 보고서를 생성하는 작업을 수정하거나 삭제할 수 없습니다.

      • jobs.list 메서드의 새로운 includeSystemManaged 매개변수는 API 응답에 시스템 관리 보고서의 작업을 포함해야 하는지 여부를 나타냅니다. 매개변수의 기본값은 false입니다.

      • jobs.reports.list 메서드의 새로운 startTimeAtOrAfter 매개변수는 API 응답에 보고서의 가장 오래된 데이터가 지정된 날짜 또는 그 이후인 경우에만 보고서를 포함해야 함을 나타냅니다. 마찬가지로 startTimeBefore 매개변수는 API 응답에 보고서의 가장 이른 데이터가 지정된 날짜 이전인 경우에만 보고서를 포함해야 함을 나타냅니다.

        보고서가 생성된 시간과 관련된 메서드의 createdAfter 매개변수와 달리 새 매개변수는 보고서의 데이터와 관련이 있습니다.

      • reportType 리소스의 새로운 systemManaged 속성은 리소스가 시스템 관리 보고서를 설명하는지 여부를 나타냅니다.

      • reportTypes.list 메서드의 새로운 includeSystemManaged 매개변수는 API 응답에 시스템 관리 보고서를 포함해야 하는지 여부를 나타냅니다. 매개변수의 기본값은 false입니다.

    2016년 3월 28일

    이제 YouTube Reporting API 및 YouTube Analytics API에서 몇 가지 추가 공유 서비스에 대한 조회 통계를 반환합니다.

    • YouTube Reporting API에서 sharing_service 측정기준은 다음과 같은 새 값을 지원합니다.
      • 82: iOS 시스템 활동 대화상자
      • 83: Google 받은편지함
      • 84: Android 메신저
    • YouTube Analytics API에서 sharingService 측정기준은 다음과 같은 새 값을 지원합니다.
      • ANDROID_MESSENGER: Android 메신저
      • INBOX: Google 받은편지함
      • IOS_SYSTEM_ACTIVITY_DIALOG: iOS 시스템 활동 대화상자

    2016년 3월 16일

    이 업데이트에는 다음과 같은 변경사항이 포함되어 있으며 이는 YouTube Reporting API와 YouTube Analytics API 모두에 영향을 미칩니다.

    YouTube 보고 API

    • playback_location_type 측정기준은 다음 두 가지 새로운 측정기준 값을 지원합니다.
      • 7: YouTube 홈페이지나 홈 화면, 사용자의 구독 피드 또는 다른 YouTube 탐색 기능에서 발생한 조회수와 관련이 있습니다.
      • 8: YouTube 검색결과 페이지에서 직접 발생한 조회수와 관련된 데이터입니다.
    • 이제 traffic_source_type 측정기준은 18를 크기 값으로 지원합니다. 이 값은 재생목록에 있는 모든 동영상을 나열한 페이지에서 동영상 조회수가 발생했음을 나타냅니다. 이 소스는 동영상이 재생목록의 일부로 재생되는 동안 조회수가 발생했음을 나타내는 소스 유형 14와 다릅니다.

    YouTube 분석 API

    • insightPlaybackLocationType 측정기준은 다음 두 가지 새로운 측정기준 값을 지원합니다.
      • BROWSE: YouTube 홈페이지나 홈 화면, 사용자의 구독 피드 또는 다른 YouTube 탐색 기능에서 발생한 조회수와 관련이 있습니다.
      • SEARCH: YouTube 검색결과 페이지에서 직접 발생한 조회수와 관련된 데이터입니다.
    • 이제 insightTrafficSourceType 측정기준은 YT_PLAYLIST_PAGE를 크기 값으로 지원합니다. 이 값은 재생목록에 있는 모든 동영상을 나열한 페이지에서 동영상 조회수가 발생했음을 나타냅니다. 이 소스는 동영상이 재생목록의 일부로 재생되는 동안 조회수가 발생했음을 나타내는 PLAYLIST 소스 유형과 다릅니다.

    2016년 2월 8일

    YouTube Analytics API에서 지원되는 측정항목 목록이 업데이트되어 카드 측정항목이 더 이상 해당 API에서 지원되는 측정항목으로 표시되지 않습니다. (해당 API의 보고서는 어떠한 카드 측정항목도 지원하는 것으로 문서화되지 않았습니다.)

    여러 채널콘텐츠 소유자 보고서에서 이러한 측정항목을 지원하는 YouTube Reporting API를 사용하여 카드 측정항목을 계속 검색할 수 있다는 점에 유의하시기 바랍니다.

    2016년 1월 6일

    이제 YouTube Reporting API와 YouTube Analytics API가 Chromecast 기기를 통해 발생하는 조회수를 구체적으로 파악합니다.

    • YouTube Reporting API에서 operating_system 측정기준은 21 값을 사용하여 Chromecast를 통해 발생한 조회수를 식별합니다.
    • YouTube Analytics API에서 operatingSystem 측정기준은 CHROMECAST 값을 사용하여 Chromecast를 통해 발생한 조회수를 식별합니다.

    2015년 12월 21일

    이 문서에서는 annotation_clickable_impressionsannotation_closable_impressions 측정항목의 이름이 보고서에 반환되는 이름과 일치하도록 업데이트되었습니다. 이전에는 이름이 clickable_annotation_impressionsclosable_annotation_impressions로 문서화되었습니다.

    2015년 12월 18일

    유럽연합 (EU) 법률에 따라 특정 정보를 EU의 최종 사용자에게 제공하고 동의를 얻어야 합니다. 따라서 유럽 연합의 최종 사용자에게는 EU 사용자 동의 정책을 준수해야 합니다. YouTube API 서비스 약관에 이 요건에 관한 알림이 추가되었습니다.

    2015년 12월 15일

    이 업데이트에는 다음과 같은 변경사항이 포함되며, 모든 변경사항은 YouTube Analytics API에 영향을 줍니다.

    • 이제 YouTube Analytics API에서 다양한 채널 및 콘텐츠 소유자 보고서에서 사용할 수 있는 3가지 새로운 재생 세부정보 측정기준을 지원합니다.

      • liveOrOnDemand: 이 측정기준은 보고서의 데이터가 실시간 방송 중에 발생한 사용자 활동을 설명하는지 여부를 나타냅니다.
      • subscribedStatus: 데이터의 사용자 활동 측정항목이 동영상 또는 재생목록의 채널을 구독한 시청자와 연결되어 있는지를 나타내는 측정기준입니다.
      • youtubeProduct: 사용자 활동이 발생한 YouTube 속성을 식별하는 측정기준입니다. 가능한 값은 핵심 YouTube 웹사이트 (또는 YouTube 앱), YouTube Gaming, YouTube Kids입니다.

      채널콘텐츠 소유자가 사용할 수 있는 새로운 재생 세부정보 보고서를 확인할 수 있도록 문서가 업데이트되었습니다. 또한 이러한 측정기준 중 하나 이상을 보고서에서 측정기준 및 필터로 선택적으로 사용할 수 있음을 알리기 위해 다른 많은 보고서가 업데이트되었습니다.

    • 각 보고서를 검색하는 데 사용할 수 있는 측정기준, 측정항목, 필터의 유효한 조합을 더 쉽게 식별할 수 있도록 보고서를 설명하는 표의 형식이 변경되었습니다. 채널의 '기기 유형' 보고서를 설명하는 아래 표에는 새 형식이 나와 있습니다.

      목차
      크기:
      필수 deviceType
      0개 이상을 사용하세요. day, liveOrOnDemand, subscribedStatus, youtubeProduct
      측정항목:
      1개 이상 사용 조회수, estimatedMinutesWatched
      필터:
      0 또는 1을 사용하세요. 국가, , 대륙, subContinent
      0 또는 1을 사용하세요. video, group
      0개 이상을 사용하세요. operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

      필수 및 선택 입력란을 설명하는 용어는 채널콘텐츠 소유자 보고서 문서에 설명되어 있습니다.

    • 이제 YouTube Analytics API에서 API 사용자가 여러 값 (video, playlist, channel)을 지원하는 필터에서 데이터를 검색할 수 없는 항목을 자동으로 삭제합니다. 이전에는 API 사용자가 지정된 항목 중 하나 이상의 데이터에 액세스할 수 없는 경우 API 서버에서 오류를 반환했습니다.

      예를 들어 사용자가 video 필터에 동영상 ID 20개를 나열하는 API 요청을 제출한다고 가정해 보겠습니다. 사용자가 동영상 18개를 소유합니다. 그러나 한 동영상 ID는 다른 채널에서 소유한 동영상을 식별하고 다른 ID는 삭제되어 더 이상 존재하지 않는 동영상을 식별합니다. 이 경우 이제 API 서버는 오류를 반환하는 대신 사용자가 액세스할 수 없는 두 동영상을 삭제하며, API 응답에는 API 사용자가 소유한 동영상 18개에 대한 데이터가 포함됩니다.

    • 비어 있는 YouTube 분석 group에 대한 데이터를 요청하면 API에서 이제 오류가 아닌 빈 데이터 세트를 반환합니다.

    • 항목을 그룹에 추가하려고 하지만 해당 항목에 대한 액세스 권한이 없는 경우 이제 YouTube Analytics API의 groupItems.insert 메서드가 승인되지 않은 (403 HTTP 응답 코드) 오류를 반환합니다. 이전에는 API를 사용하여 항목을 그룹에 추가할 수 있었지만 나중에 해당 그룹에 대한 보고서 데이터를 검색하려고 하면 승인되지 않은 오류가 반환되었습니다.

    • 이제 YouTube Analytics API의 groups.list 메서드가 페이지로 나누기를 지원합니다. API 응답에 사용 가능한 그룹이 모두 포함되어 있지 않은 경우 응답의 nextPageToken 매개변수는 다음 결과 페이지를 검색하는 데 사용할 수 있는 토큰을 지정합니다. 추가 결과를 검색하려면 메서드의 pageToken 매개변수를 이 값으로 설정합니다.

    2015년 11월 10일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    2015년 10월 29일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • 이 날짜가 태평양 표준시 기준 오전 12시 (UTC-8)부터 24시간을 참조하도록 YouTube Reporting API의 date 측정기준 문서가 수정되었습니다. 이전에는 문서에 날짜가 오전 12시(GMT)에 시작되었다고 나와 있었습니다.

      또한 모든 날짜 관련 측정기준 (day, 7DayTotals, 30DayTotals, month)이 태평양 표준시 (UTC-8) 오전 12시에 시작되는 날짜를 나타내도록 YouTube Analytics API 문서가 업데이트되었습니다.

    • 이제 YouTube Reporting API의 jobs.reports.list() 메서드가 createdAfter 쿼리 매개변수를 지원합니다. 지정된 경우 이 매개변수는 API 응답이 백필된 데이터가 포함된 새 보고서를 비롯하여 지정된 날짜 및 시간 이후에 생성된 보고서만 나열해야 함을 나타냅니다. 매개변수 값은 반환된 데이터와 연결된 날짜가 아니라 보고서가 생성된 시간과 관련이 있습니다.

      매개변수 값은 RFC3339 UTC 'Zulu' 형식의 타임스탬프로, 정밀도는 마이크로초 수준입니다. 예: "2015-10-02T15:01:23.045678Z"

      createdAfter 매개변수를 사용하여 동일한 보고서가 반복적으로 처리되지 않도록 하는 방법을 설명하도록 YouTube Reporting API 권장사항도 업데이트되었습니다.

    • job 리소스의 createTime 속성과 report 리소스의 startTime, endTime, createTime 속성의 정의가 모두 수정되어 속성 값이 나노초가 아닌 마이크로초로 정확합니다. 또한 모든 정의는 이제 속성 값이 타임스탬프임을 정확하게 반영합니다.

    2015년 10월 8일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • 가능한 측정기준 값의 목록을 포함하도록 YouTube Analytics API의 sharingService 측정기준에 대한 문서가 업데이트되었습니다. 목록에는 새로 지원되는 여러 서비스가 포함됩니다.

      YouTube Reporting API의 sharing_service 측정기준의 정의도 새로 지원되는 값을 나열하도록 업데이트되었습니다. 59보다 큰 enum 값이 목록의 새 enum 값입니다.

    2015년 9월 24일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • 새로운 YouTube Reporting API는 채널 또는 콘텐츠 소유자의 YouTube 분석 데이터가 포함된 일괄 데이터 보고서를 검색합니다. 대규모 데이터 세트를 가져올 수 있고 해당 데이터를 필터링, 정렬, 마이닝할 수 있는 도구를 제공하는 애플리케이션용으로 설계되었습니다.

      각 YouTube Reporting API 보고서에는 사전 정의된 측정기준 및 측정항목이 포함되어 있습니다. (YouTube Analytics API 보고서에서도 측정항목과 측정기준이 사용됩니다.) 보고서의 각 데이터 행에는 측정기준 값의 고유한 조합이 있습니다. 측정기준 값을 기준으로 여러 행에 걸쳐 데이터를 집계하여 개별 동영상, 국가, 실시간 동영상, 구독한 사용자 등에 대한 측정항목을 계산할 수 있습니다.

      API를 사용하여 보고 작업을 예약할 수 있습니다. 각 작업은 YouTube가 생성해야 하는 보고서를 식별합니다. 작업을 설정하면 YouTube에서 비동기식으로 다운로드할 수 있는 일일 보고서를 생성합니다. 각 보고서에는 고유한 24시간 동안의 데이터가 포함되어 있습니다.

    • API는 서로 다르지만 YouTube Analytics API와 YouTube Reporting API 모두 개발자가 YouTube 분석 데이터를 가져오는 데 사용합니다. 두 API 모두 비슷한 데이터 세트에 대한 액세스를 제공하므로 두 API에 대한 문서는 단일 문서 모음으로 게시됩니다.

      • 문서 집합의 가이드 탭에는 API 요청 승인 안내 등 두 API에 공통된 정보가 포함되어 있습니다.
      • 일괄 보고서 탭에는 YouTube Reporting API와 관련된 참조 문서와 기타 콘텐츠가 포함되어 있습니다.
      • 타겟팅된 쿼리 탭에는 YouTube Analytics API와 관련된 참조 문서와 기타 콘텐츠가 포함되어 있습니다.
      • 샘플 탭에는 두 API 중 하나에 사용할 수 있는 코드 샘플이 표시됩니다.
      • Tools 탭에는 개발자가 두 API 중 하나를 구현하는 데 도움이 되는 추가 리소스가 표시됩니다.

    2015년 8월 20일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • API를 더 쉽게 이해할 수 있도록 API 문서를 재구성했습니다. 따라서 이러한 변경사항은 새 기능을 설명하지 않습니다.

      • 이제 문서에는 사용 가능한 모든 채널 보고서 목록이 표시된 페이지 및 사용 가능한 모든 콘텐츠 소유자 보고서 목록이 포함된 페이지가 포함됩니다. 이전에는 문서에 채널 동영상 보고서, 채널 재생목록 보고서 등을 위한 별도의 페이지가 있었습니다.

      • 새로운 데이터 모델 개요에서는 API의 작동 방식을 보다 명확하게 설명합니다. 특히 이 문서에서는 YouTube가 측정항목, 측정기준, 필터를 사용하여 보고서 값을 계산하는 방법을 더 잘 설명합니다.

      • 보고서를 검색하는 데 사용하는 API의 reports.query 메서드가 이제 별도로 문서화됩니다. 해당 페이지의 정보는 이전에 다른 일부 페이지에 있었습니다. 새 페이지는 보고서를 검색하기 위해 전송해야 하는 정보를 더 쉽게 식별할 수 있도록 설계되었습니다.

    2015년 7월 22일

    이 업데이트에는 몇 가지 변경사항이 있으며, 모든 변경사항은 콘텐츠 소유자에게만 적용됩니다.

    • 새로운 adEarnings 측정항목에는 모든 Google 판매 광고 소스로부터 발생한 예상 총 수익 (순수익)이 포함됩니다. 핵심 측정항목이 아닙니다. API는 earnings 측정항목을 이미 지원한 모든 보고서에서 adEarnings 측정항목을 지원합니다.

      또한 해당 값에 모든 Google 판매 광고 소스와 광고가 아닌 소스의 총 예상 수입이 포함된다는 사실을 반영하여 earnings 측정항목의 정의가 수정되었습니다. 이전에는 측정항목에 광고 소스에서 발생한 수입만 포함되었다고 잘못 정의되었습니다.

    • primaryAdGrossRevenue 측정항목이 지원 중단되었습니다. 대신 수익 데이터를 검색하려면 grossRevenue 측정항목을 사용하세요.

    • 지원 중단된 primaryAdGrossRevenue 측정항목 외에도 광고 실적 보고서에서 monetizedPlaybacksplaybackBasedCpm 측정항목이 더 이상 지원되지 않습니다. 그러나 일부 동영상 보고서에서 이러한 측정항목을 계속 지원합니다.

    2015년 6월 1일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • 이제 API는 동영상 보고서에 두 가지 새로운 측정항목(videosAddedToPlaylists, videosRemovedFromPlaylists)을 지원합니다. 새 측정항목을 지원하는 보고서를 확인할 수 있도록 채널콘텐츠 소유자에 대한 동영상 보고서 목록이 모두 업데이트되었습니다.

      • videosAddedToPlaylists – 쿼리 범위에 있는 동영상이 YouTube 재생목록에 추가된 횟수입니다. 동영상이 동영상 소유자의 재생목록이나 다른 채널의 재생목록에 추가되었을 수 있습니다.
      • videosRemovedFromPlaylists – 쿼리 범위에 있는 동영상이 YouTube 재생목록에서 삭제된 횟수입니다. 동영상이 동영상 소유자의 재생목록이나 다른 채널의 재생목록에서 삭제되었을 수 있습니다.

      두 측정항목 모두 '나중에 볼 동영상' 재생목록과 같은 기본 재생목록을 포함합니다. 하지만 채널의 업로드 재생목록 또는 사용자의 시청 기록 등 동영상이 자동으로 추가된 재생목록은 계산에 포함되지 않습니다. 또한 이러한 측정항목은 추가 및 삭제의 절댓값을 반영합니다. 따라서 사용자가 재생목록에 동영상을 추가했다가 삭제한 다음 다시 추가하는 경우 측정항목은 동영상이 두 개의 재생목록에 추가되고 한 재생목록에서 삭제되었음을 나타냅니다.

      이러한 측정항목에 대한 데이터는 2014년 10월 1일부터 제공됩니다.

    2015년 3월 31일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    2015년 3월 16일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • currency 매개변수를 사용하면 미국 달러 (USD)가 아닌 다른 통화로 수익 측정항목을 가져올 수 있습니다. 매개변수가 설정되면 API에서 earnings, grossRevenue, playbackBasedCpm, impressionBasedCpm 측정항목의 값을 지정된 통화로 변환합니다. 반환된 값은 매일 변경되는 환율을 사용하여 계산된 추정치입니다.

      매개변수 값은 3자리 ISO 4217 통화 코드입니다. 기본값은 USD입니다. 매개변수 정의에는 지원되는 통화 코드 목록이 포함됩니다.

    2015년 2월 25일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • 이제 API에서 YouTube 분석 그룹을 만들고 관리하는 기능과 해당 그룹에 대한 보고서 데이터를 검색하는 기능을 지원합니다.

      • 그룹 만들기 및 관리

        이 업데이트에는 그룹 생성 및 관리를 위한 groupgroupItem 리소스가 도입되었습니다.

        • group 리소스는 최대 200개의 채널, 동영상, 재생목록 또는 저작물로 구성된 맞춤 컬렉션인 분석 그룹을 나타냅니다. API는 이 리소스에 대해 list, insert, update, delete 메서드를 지원합니다.
        • groupItem 리소스는 애널리틱스 그룹의 항목을 나타냅니다. API는 이 리소스에 대해 list, insert, delete 메서드를 지원합니다.

        예를 들어 groups.insert 메서드를 사용하여 그룹을 만들고 groupItems.insert 메서드를 사용하여 이 그룹에 항목을 추가할 수 있습니다.

      • 그룹의 보고서 데이터 검색하기

        여러 채널 보고서콘텐츠 소유자 보고서의 필터로 사용할 수 있는 group 측정기준을 포함하도록 측정기준 문서가 업데이트되었습니다. group 필터를 사용하면 API가 해당 그룹의 모든 항목에 대한 데이터를 반환합니다. API는 현재 애셋 그룹에 대한 보고서를 만드는 기능을 지원하지 않습니다.

      YouTube 분석 그룹에 대한 자세한 내용은 YouTube 고객센터를 참조하세요.

    2015년 2월 13일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • API에서 더 이상 show 측정기준을 지원하지 않습니다.

    2014년 8월 28일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • 이제 API는 video, playlist, channel, show 측정기준이 필터로 사용될 때 해당 측정기준에 여러 값을 지정할 수 있는 기능을 지원합니다. 여러 값을 지정하려면 filters 매개변수 값을 API 응답을 필터링해야 하는 동영상, 재생목록, 채널 또는 프로그램 ID를 쉼표로 구분된 목록으로 설정합니다. 매개변수 값은 최대 200개의 ID를 지정할 수 있습니다.

      동일한 필터에 여러 값을 지정하는 경우 요청에 지정한 측정기준 목록에 해당 필터를 추가할 수도 있습니다. 필터가 특정 보고서에서 지원되는 측정기준으로 등록되지 않은 경우에도 마찬가지입니다. 측정기준 목록에 필터를 추가하면 API에서도 필터 값을 사용하여 결과를 그룹화합니다.

      이 기능에 관한 자세한 내용은 filters 매개변수 정의를 참고하세요.

    2014년 7월 16일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • 이제 채널 보고서를 가져올 때 ids 매개변수의 값을 channel==MINE로 설정하여 인증된 사용자의 채널에 대한 데이터를 검색할 수 있습니다. ids 매개변수를 channel==CHANNEL_ID로 설정하여 지정된 채널의 데이터를 가져올 수도 있습니다.

    • 이제 API가 재생목록 보고서를 지원합니다. 보고서에는 재생목록 컨텍스트에서 발생하는 동영상 조회수와 관련된 통계가 포함됩니다. 재생목록 보고서는 채널콘텐츠 소유자에 대해 사용할 수 있습니다.

      모든 재생목록 보고서는 viewsestimatedMinutesWatched 측정항목을 지원하며 일부 보고서는 averageViewDuration 측정항목도 지원합니다.

      또한 모든 재생목록 보고서는 다음과 같은 새 측정항목을 지원합니다. 각 측정항목은 웹에서 발생한 재생목록 조회수만 반영합니다.

      • playlistStarts: 시청자가 재생목록 재생을 시작한 횟수입니다.
      • viewsPerPlaylistStart: 재생목록이 시작될 때마다 발생한 평균 동영상 조회수입니다.
      • averageTimeInPlaylist: 재생목록이 시작된 후 시청자가 재생목록의 동영상을 시청한 예상 평균 시간(분)입니다.

      재생목록 보고서 검색 요청은 isCurated 필터를 사용해야 하며 이 필터는 1 (isCurated==1)로 설정해야 합니다.

    • 이제 API에서 시청 지속 시간 보고서를 지원합니다. 이 보고서는 동영상의 잠재고객 보유 능력을 측정합니다. 보고서의 새로운 elapsedVideoTimeRatio 측정기준은 해당하는 측정항목 값에 대해 경과된 동영상의 양을 측정합니다.

      • audienceWatchRatio 측정항목은 동영상의 특정 지점에서 동영상을 보는 시청자의 절대 비율을 나타냅니다. 비율은 동영상의 특정 부분을 시청한 횟수와 동영상의 총 조회수를 비교하여 계산합니다.

        특정 동영상 보기에서 동영상의 일부를 두 번 이상 시청하거나 아예 시청하지 않을 수 있습니다. 예를 들어 사용자가 동영상의 같은 부분을 되감고 여러 번 시청하는 경우 해당 부분의 절대 비율은 1보다 클 수 있습니다.

      • relativeRetentionPerformance 측정항목은 비슷한 길이의 모든 YouTube 동영상과 비교하여 재생 중 특정 동영상이 시청자를 얼마나 잘 유지하는지 보여줍니다. 0 값은 동영상이 비슷한 길이의 다른 어떤 동영상보다 시청 지속 시간이 비슷한 수준임을 나타내고, 1 값은 동영상이 비슷한 길이의 다른 어떤 동영상보다 시청 지속 시간이 길다는 것을 나타냅니다. 중앙값이 0.5이면 길이가 비슷한 동영상 중 절반은 시청 지속 시간이 길고, 절반은 시청 지속 시간이 짧다는 것을 나타냅니다.

      또한 audienceType 필터를 사용하여 자연 조회수, TrueView 인스트림 광고를 통한 조회수, TrueView 디스플레이 광고를 통한 조회수와 관련된 데이터만 보고서에서 반환하도록 할 수 있습니다. 자연 조회수는 동영상 검색 또는 추천 동영상 클릭과 같은 사용자 액션의 직접적인 결과입니다.

    • 이 API는 주석과 관련된 여러 가지 새로운 측정항목을 지원합니다. 아래에 나열된 측정항목은 이전에 annotationClickThroughRateannotationCloseRate 측정항목을 지원한 모든 보고서에서 가져올 수 있습니다.

      새로운 측정항목은 모두 핵심 측정항목이며 지원 중단 정책이 적용됩니다. 하지만 2013년 7월 16일부터 새 측정항목에 대한 데이터를 사용할 수 있습니다. annotationClickThroughRateannotationCloseRate 측정항목의 데이터는 2012년 6월 10일부터 사용할 수 있습니다.

    • GOOGLE_SEARCH는 더 이상 insightTrafficSourceType 측정기준에 대한 별도의 값으로 보고되지 않습니다. 대신 Google 검색결과에서 발생한 추천은 EXT_URL 트래픽 소스 유형으로 표시됩니다. 따라서 insightTrafficSourceType 필터를 GOOGLE_SEARCH로 설정하는 insightTrafficSourceDetail 보고서를 더 이상 검색할 수 없습니다.

    2014년 1월 31일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    2014년 1월 16일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • 채널 및 콘텐츠 소유자 보고서에서 최근 출시된 탭 형식과 유사한 탭 형식을 사용하여 여러 개의 예를 카테고리로 그룹화할 수 있도록 샘플 요청 문서를 새롭게 디자인했습니다. 새로운 디자인에서는 예제가 다음 카테고리로 그룹화됩니다.

      • 기본 통계
      • 시간 기준
      • 지역
      • 재생 위치
      • 트래픽 소스
      • 기기/운영체제
      • 인구통계
      • 소셜
      • 수입/광고 (콘텐츠 소유자 보고서만 해당)

    • 이제 샘플 요청 문서에 채널 보고서 또는 콘텐츠 소유자 보고서에서 지방별 데이터를 검색하는 새로운 예가 포함됩니다.

      • 미국 주 및 워싱턴 D.C.의 지역별 측정항목: 이 보고서는 채널 동영상에 대한 조회수 및 기타 통계를 지역별로 세분화하여 검색합니다. 데이터에는 미국 주와 워싱턴 D.C가 포함됩니다. 이 예에서는 province 측정기준을 사용하고, filters 매개변수를 사용하여 미국 내 결과만 포함하도록 응답을 제한합니다.

      • 캘리포니아 시청자 인구통계(연령대 및 성별): 이 보고서는 캘리포니아에서 채널의 동영상을 시청한 시청자(콘텐츠 소유자 보고서의 경우 콘텐츠 소유자 보고서)의 연령대와 성별에 대한 통계를 가져옵니다. 이 예시에서는 filters 매개변수를 사용하여 응답에 특정 지역의 데이터만 포함되도록 합니다.

    • provincedimensions 매개변수 값에 포함된 경우 요청에서 filters 매개변수 값에 country==US를 포함하여 데이터를 미국으로 제한하도록 province 측정기준의 정의가 업데이트되었습니다.

    2014년 1월 6일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • 지원되는 채널콘텐츠 소유자 보고서가 나열된 문서의 디자인이 변경되었습니다. 가능한 모든 보고서가 나열된 표를 제공하는 대신 각 문서는 보고서를 카테고리로 그룹화합니다.

      • 기본 통계
      • 시간 기준
      • 지역
      • 재생 위치
      • 트래픽 소스
      • 기기/운영체제
      • 인구통계
      • 소셜
      • 인기 동영상

      각 문서에는 이러한 카테고리가 탭 목록으로 표시되며 탭을 클릭하면 해당 카테고리에서 지원되는 보고서를 볼 수 있습니다.

    • 이제 API에서 세 가지 새로운 지역 측정기준인 province, continent, subContinent를 지원합니다.

      • province 측정기준을 사용하면 미국 주 및 콜롬비아 특별구에 대한 통계를 검색할 수 있습니다. API는 이 측정기준에 대해 두 가지 용도를 지원합니다.

        • API는 상태별로 통계를 분석하는 두 가지 보고서를 지원합니다. 두 보고서 모두 채널콘텐츠 소유자에 사용할 수 있습니다.

          • 중요 통계 보고서는 조회수, 예상 시청 시간(분)을 비롯한 여러 통계를 제공합니다.
          • 시간 기반 보고서도 동일한 통계를 제공하지만 일별, 7일, 30일 또는 월별 기준으로 데이터를 집계합니다.

        • filters 쿼리 매개변수를 사용하여 특정 상태에 관한 통계만 포함하도록 보고서를 제한할 수 있습니다. 지역 보고서, 재생 위치 보고서, 트래픽 소스 보고서, 기기 보고서, 운영체제 보고서, 인구통계 보고서, 인기 동영상 보고서 등 여러 보고서에서 이러한 유형의 필터링을 지원합니다.

      • continent 측정기준은 대륙을 식별하는 UN (UN) 통계 지역 코드를 지정합니다. 이 측정기준은 필터로만 사용할 수 있습니다.

      • subContinent 측정기준은 대륙의 하위 지역을 식별하는 UN (UN) 통계 지역 코드를 지정합니다. 이 측정기준은 필터로만 사용할 수 있습니다.

        각 하위 지역은 하나의 대륙에만 연결되므로 subContinent 필터를 사용할 때 continent 필터도 사용할 필요가 없습니다. 실제로 요청에서 두 측정기준을 모두 사용하면 API가 오류를 반환합니다.

    • insightTrafficSourceDetail 측정기준에 insightTrafficSourceTypePROMOTED이 유효한 필터 값으로 포함되지 않도록 문서가 수정되었습니다.

    2013년 9월 30일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • 이제 YouTube Analytics API에는 서비스 약관에 설명된 지원 중단 정책이 적용됩니다. 하지만 API의 비핵심 측정기준 및 비핵심 측정항목에는 지원 중단 정책이 적용되지 않습니다. 측정기준metrics 페이지가 업데이트되어 핵심 측정기준 및 핵심 측정항목이 나열됩니다. 또한 핵심 측정기준 및 측정항목을 명시적으로 식별할 수 있도록 이러한 페이지의 정의가 업데이트되었습니다.

    • 이제 API에서 insightPlaybackLocationType 측정기준의 값으로 EXTERNAL_APP를 지원합니다. 이 업데이트와 함께 2013년 9월 10일부터 재생은 더 이상 MOBILE 재생으로 분류되지 않지만 이 날짜 이전에 발생한 모바일 재생은 해당 값으로 분류됩니다.

      이 업데이트를 통해 이제 모바일 재생은 재생이 발생하는 애플리케이션 유형에 따라 WATCH, EMBEDDED 또는 EXTERNAL_APP 재생으로 분류됩니다.

    • 이제 API에서 insightTrafficSourceType 측정기준의 값으로 PLAYLIST를 지원합니다. 이 값은 동영상 조회수를 재생목록에서 추천했음을 나타냅니다. 이전에는 이러한 뷰가 측정기준의 YT_OTHER_PAGE 카테고리를 사용하여 분류되었습니다.

    2013년 7월 16일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • API는 이제 여러 측정기준 및 측정항목을 기준으로 보고서를 정렬할 수 있는 기능을 지원합니다. 샘플 요청 문서에는 새로운 예인 여러 측정기준/측정항목으로 요청 정렬하기가 포함되어 이 기능을 보여줍니다. 이 요청은 트래픽 소스 데이터를 검색하며 sort 매개변수 값이 day,-views입니다. 결과는 시간순으로 정렬되지만 하루의 결과 집합에서는 첫째 행에 조회수가 제일 높은 트래픽 소스 데이터를 포함하고 둘째 행에 그 다음으로 조회수가 높은 소스의 데이터를 포함하는 등 조회수가 높은 순서로 포함합니다.

    • 이제 API는 두 가지 새로운 측정기준인 deviceTypeoperatingSystem를 지원합니다. 이 측정기준은 시청자가 내 동영상을 시청하는 기기에 관한 데이터를 검색하는 데 사용할 수 있습니다. API는 측정 기준 하나를 사용하거나 둘 다 사용하는 보고서를 지원합니다.

      • deviceType 보고서를 사용하면 데스크톱, 휴대기기, 태블릿 기기 등 다양한 유형의 기기에 대한 조회수 및 예상 시청 시간을 가져올 수 있습니다. 또한 operatingSystem 필터를 사용하여 특정 운영체제(예: Android 또는 iOS)를 실행하는 기기의 통계만 포함하도록 기기 유형 보고서를 제한할 수 있습니다.

      • operatingSystem 보고서를 사용하면 Android, iOS, Linux 등 다양한 운영체제의 조회수 및 예상 시청 시간을 가져올 수 있습니다. deviceType 필터를 사용하여 휴대기기 또는 태블릿과 같은 특정 기기 유형의 통계만 포함하도록 운영체제 보고서를 제한할 수도 있습니다.

      새 기기 유형 및 운영체제 보고서는 채널콘텐츠 소유자에 대해 사용할 수 있습니다.

    • 샘플 요청 문서가 업데이트되어 채널에 대한 기기 보고서 3개와 콘텐츠 소유자에 대한 기기 보고서 3개를 포함합니다.

    • insightPlaybackLocationType 측정기준은 측정기준의 다른 값 중 하나를 사용하여 분류되지 않은 조회수를 식별하는 YT_OTHER 값을 반환할 수 있습니다.

    2013년 5월 23일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    2013년 5월 10일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    2013년 5월 6일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • 이제 API에서 조회수 측정항목, 참여도 측정항목, 수입 측정항목, 광고 실적 측정항목을 비롯한 다른 측정항목과 함께 시청 시간 측정항목(estimatedMinutesWatched, averageViewDuration, averageViewPercentage)을 가져오는 기능을 지원합니다.

      사용 가능한 채널 보고서콘텐츠 소유자 보고서 목록이 이 변경사항을 반영하여 업데이트되었습니다. (시청 시간 측정항목이 다른 보고서의 일부로 검색되므로 실제 목록은 짧습니다.)

      샘플 API 요청 문서도 업데이트되었습니다.

    • insightPlaybackLocationDetailinsightTrafficSourceDetail 측정기준을 사용하는 보고서는 다음과 같이 개선되었습니다.

      • 이제 country 필터(선택사항)를 지원합니다.

      • 이제 콘텐츠 소유자는 다음과 같은 새로운 filter 조합을 사용하여 보고서를 검색할 수 있습니다. 이러한 모든 조합은 선택적 country 필터도 지원합니다.

        • 재생 위치 세부정보

          • channel,insightPlaybackLocationType==EMBEDDED
          • show,insightPlaybackLocationType==EMBEDDED
          • claimedStatus,insightPlaybackLocationType==EMBEDDED
          • uploaderType,insightPlaybackLocationType==EMBEDDED
          • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

        • 트래픽 소스 세부정보

          • channel,insightTrafficSourceType
          • show,insightTrafficSourceType
          • claimedStatus,insightTrafficSourceType
          • uploaderType,insightTrafficSourceType
          • uploaderType,claimedStatus,insightTrafficSourceType

    2013년 5월 3일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • 새로운 샘플 API 요청 문서에서는 YouTube Analytics API를 사용하여 다양한 유형의 보고서를 검색하는 방법을 보여주는 예를 제공합니다. 각 예에는 요청에서 검색하는 보고서에 대한 간략한 설명이 포함되어 있으며 요청에 대한 측정기준, 측정항목, 필터, 정렬 매개변수가 표시됩니다.

    • 이제 insightTrafficSourceType 측정기준은 SUBSCRIBER를 유효한 값으로 지원합니다. 이 값은 YouTube 홈페이지의 피드 또는 YouTube 구독 기능에서 추천한 동영상 조회수를 식별합니다. 이 트래픽 소스를 기준으로 필터링하면 insightTrafficSourceDetail 입력란에 동영상이 조회된 홈페이지 피드 또는 다른 페이지가 표시됩니다.

    2013년 3월 28일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    2013년 3월 21일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • 이제 API에서 수익 및 광고 실적 측정항목은 물론 새 광고 실적 보고서도 지원합니다. YouTube 파트너 프로그램에 참여하는 YouTube 콘텐츠 파트너만 측정항목과 보고서에 액세스할 수 있습니다.

      • 새로 지원되는 보고서는 재생 기반 광고 실적 측정항목과 노출 기반 광고 실적 측정항목을 지원합니다. 광고 실적 보고서에 대한 자세한 내용은 콘텐츠 소유자 보고서 문서를 참조하세요.

      • 새로 지원되는 측정항목은 다음과 같습니다. 콘텐츠 소유자 보고서 목록이 업데이트되어 아래 측정항목을 지원하는 2개의 새 보고서를 비롯해 여러 보고서를 확인할 수 있습니다.

        • earnings – Google에서 판매하는 모든 광고 소스의 총 예상 수익입니다.
        • grossRevenue – Google 또는 DoubleClick 파트너의 총 예상 수익입니다.
        • primaryAdGrossRevenue – 보고서에서 다루는 동영상 재생에 대해 Google 또는 DoubleClick 파트너의 기본 광고 유형 아래에 합산되고 분류되는 예상 총수익입니다.
        • monetizedPlaybacks – 하나 이상의 광고 노출을 표시한 재생 횟수입니다.
        • playbackBasedCpm – 1,000회 재생당 총 예상 수익입니다.
        • impressions – 확인된 광고 노출수입니다.
        • impressionBasedCpm – 1,000회 광고 노출당 총 예상 수익입니다.

        참고: 보다 자세한 내용은 측정항목 정의를 참조하세요.

      • 수익 또는 광고 실적 측정항목을 검색하는 모든 요청은 새 https://www.googleapis.com/auth/yt-analytics-monetary.readonly 범위를 사용하여 액세스 권한을 부여하는 승인 토큰을 전송해야 합니다.

    • API 문서가 재구성되어 서로 다른 유형의 보고서를 별도의 페이지에서 설명합니다. 따라서 이제 다른 유형의 채널 보고서콘텐츠 소유자 보고서를 설명하는 별도의 페이지가 있습니다.

    2013년 2월 4일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • API 참조 가이드에는 이제 섹션이 추가되었습니다. 이 섹션에는 Java, JavaScript, Python, Ruby 클라이언트 라이브러리를 사용하여 API를 호출하는 방법을 보여주는 코드 샘플이 포함되어 있습니다. JavaScript 코드 샘플은 샘플 애플리케이션 문서에 자세히 설명된 것과 동일합니다.

    2012년 11월 14일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • API 참조 가이드에는 이제 응답에서 API를 호출하고, API 요청을 확인하며, 실제 데이터를 검색할 수 있게 해주는 APIs Explorer가 포함되어 있습니다.

    • API는 아래에 설명된 대로 채널 및 콘텐츠 소유자 모두를 위한 여러 새 보고서를 지원합니다. 각 보고서를 채널 보고서 또는 콘텐츠 소유자 보고서로 사용할 수 있습니다. 이에 따라 측정기준metrics 페이지도 업데이트되었습니다.

      • 재생 위치 보고서는 다른 유형의 페이지 또는 애플리케이션에서 발생한 동영상 조회수를 지정합니다.

      • 재생 위치 세부정보 보고서는 지정된 동영상에서 가장 많은 조회수를 기록한 내장 플레이어를 식별합니다. 이 보고서에서는 최상위 내장 플레이어와 연결된 URL을 식별하여 재생 위치 보고서보다 더 자세하게 볼 수 있습니다.

      • 트래픽 소스 보고서는 다른 종류의 리퍼러에서 발생한 동영상 조회수를 확인합니다.

      • 트래픽 소스 세부정보 보고서는 지정된 동영상 및 지정된 트래픽 소스 유형에 대해 가장 많은 조회수를 생성한 리퍼러를 식별합니다. 예를 들어 이 보고서를 통해 특정 동영상으로 가장 많은 트래픽을 보낸 관련 동영상을 확인할 수 있습니다. 여러 가지 트래픽 소스에 대해 지원되는 보고서입니다.

      • 시청 시간 보고서는 시청자가 내 콘텐츠를 시청한 시간을 제공합니다. 보고서에서는 일, 이전 7일, 이전 30일 등 특정 기간이나 국가의 데이터를 집계할 수 있습니다. 보고서에서 기간 또는 국가로 데이터를 집계한 경우 사용자가 시청한 각 동영상의 평균 비율과 각 동영상 조회의 평균 시간도 지정할 수 있습니다.

    2012년 10월 2일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • 이제 모든 개발자가 YouTube Analytics API를 사용할 수 있습니다. 먼저 액세스를 요청할 필요 없이 APIs consoleServices(서비스) 패널에서 프로젝트의 API를 활성화할 수 있습니다.

    • 새로운 시작하기 섹션에서는 YouTube Analytics API를 사용하는 애플리케이션을 빌드하기 위한 기본 요건과 기본 단계를 간략히 설명합니다.

    2012년 9월 12일

    이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.

    • 새로운 할당량 사용 이해하기 섹션에서는 API 할당량 사용을 최적화하기 위한 가이드라인을 제공합니다. API 서버는 각 요청에 대한 쿼리 비용을 계산하고 API 사용 할당량에서 이 비용을 차감합니다. 보고서 유형에 따라 쿼리 비용이 크게 차이가 날 수 있으므로 할당량을 효율적으로 사용하도록 계획하고 애플리케이션에서 실제로 필요한 측정항목과 데이터만 사용해야 합니다.

    • 일시적 측정기준 섹션은 업데이트되어 이 측정기준이 애널리틱스 보고서에서 기간을 기준으로 데이터를 집계해야 함을 나타냅니다. 이제 API는 다음과 같은 일시적 측정기준을 추가로 지원합니다.

      • 7DayTotals – 보고서의 데이터가 집계되어 각 행에 7일간의 데이터가 포함됩니다.
      • 30DayTotals – 보고서의 데이터가 집계되어 각 행에 30일 간의 데이터가 포함됩니다.
      • month – 보고서의 데이터는 한 달 단위로 집계됩니다.

      사용 가능한 보고서 섹션도 마찬가지로 업데이트되어 일시적 측정기준을 사용하는 보고서에 대한 API의 지원을 설명합니다.

    • 콘텐츠 소유자 보고서를 검색하는 API 요청에서 이러한 측정기준 (video, channel, show) 중 하나 또는 지원되는 claimedStatusuploaderType 측정기준의 조합을 사용하여 데이터를 필터링해야 함을 명시하도록 보고 항목 측정기준 섹션이 업데이트되었습니다.

    • 이제 API는 많이 본 동영상 보고서에 새로운 두 가지 정렬 옵션을 지원합니다. 이러한 보고서는 채널 보고서 또는 콘텐츠 소유자 보고서로서 제공되며, 국가별 기준의 측정항목 (조회수, 댓글, 좋아요 수 등)을 포함하고 있으며 이러한 측정항목을 동영상별로 분류합니다. 또한 동영상 보기 페이지의 채널에 구독하거나 구독하지 않은 사용자 수를 기준으로 보고서를 정렬할 수 있습니다.

    • subscribersGainedsubscribersLost metrics의 정의가 업데이트되어 동영상 보기 페이지, 채널 페이지, YouTube 홈페이지에 표시되는 가이드 등 여러 위치에서 채널이 구독자를 얻거나 잃을 수 있음을 설명합니다. 동영상 전용 보고서에 이러한 측정항목이 표시될 경우에는 지정한 동영상의 보기 페이지에 대한 측정항목만 포함됩니다.