업데이트 기록

이 페이지에는 YouTube Reporting API 및 YouTube Analytics API의 API 변경사항과 문서 업데이트가 나와 있습니다. 두 API 모두 개발자가 YouTube 분석 데이터에 액세스할 수 있도록 지원하지만 방식은 다릅니다. 이 변경 로그를 구독하세요. 구독

2024년 11월 15일

참고: 다음 변경사항은 2024년 11월 18일부터 적용됩니다.

YouTube 분석 (타겟팅 쿼리) API 문서가 업데이트되어 이제 트래픽 소스 보고서의 경우 검색된 동영상 수 X 기간 일 수의 곱이 50,000을 초과하면 API의 reports.query 메서드가 오류를 반환한다는 내용이 포함되었습니다. 예를 들어 500개의 동영상 ID에 대한 데이터를 검색하는 쿼리는 최대 100일 동안의 데이터를 요청할 수 있습니다.

이 변경사항은 채널 및 콘텐츠 소유자의 보고서에 모두 영향을 미칩니다.

요청이 반환하는 행 수를 줄이려면 쿼리를 동영상 수를 줄이거나 기간을 더 짧게 설정하는 여러 쿼리로 분할하세요. 일반적으로 대규모 데이터 세트에는 대량 보고서를 사용하는 것이 좋습니다.

2024년 5월 6일

YouTube 분석 (타겟팅 쿼리) API는 채널에 관한 다음과 같은 세 가지 새로운 보고서를 지원합니다.

  • DMA별 사용자 활동 보고서는 지정 시장 지역(DMA)별 사용자 활동 통계를 제공하는 지역 보고서입니다. 이 보고서의 경우 filters 매개변수 값을 country==US로 설정해야 합니다.

  • 동시 시청자 수 보고서에는 단일 라이브 스트리밍 동영상의 여러 부분에 대한 동시 시청자 수가 표시됩니다.

  • 회원 취소 보고서에는 사용자가 채널 멤버십을 취소한 이유를 보여주는 통계가 제공됩니다.

    이 보고서에서는 사용자가 채널 멤버십을 취소한 이유를 지정하는 새로운 membershipsCancellationSurveyReason 측정기준을 사용합니다. 또한 이 이유로 취소된 채널 멤버십 수를 나타내는 새로운 membershipsCancellationSurveyResponses 측정항목을 사용합니다.

또한 시청 지속 시간 보고서가 세 가지 새로운 측정항목을 지원하도록 개선되었습니다.

2024년 4월 7일

YouTube 분석 (타겟팅 쿼리) API에 콘텐츠 소유자 재생목록 보고서와 관련된 몇 가지 업데이트가 있습니다. 이번 업데이트는 2024년 1월 19일에 발표된 채널 재생목록 보고서와 관련된 업데이트와 동일합니다.

다음 버전 기록 항목은 2024년 1월 19일의 항목과 거의 동일한 정보를 제공합니다. 단, 콘텐츠 소유자 재생목록 보고서에서는 2024년 12월 31일까지 isCurated 측정기준을 지원하고 채널 재생목록 보고서에서는 2024년 6월 30일까지 측정기준이 지원됩니다.

  • 참고: 지원 중단 공지사항입니다.

    콘텐츠 소유자 재생목록 보고서에서 isCurated 측정기준이 지원 중단되었습니다. 2024년 12월 31일 이후에는 더 이상 지원되지 않습니다. 이에 따라 해당 측정기준의 정의가 업데이트되었습니다.

    isCurated 측정기준을 삭제할 때 이전 버전과의 호환성을 유지하려면 재생목록 보고서 전용으로 views 측정항목 대신 playlistViews 측정항목을 가져오도록 코드도 업데이트해야 합니다. views 측정항목은 의미가 다르지만 재생목록 보고서에 계속 지원되므로 측정항목 이름을 업데이트하지 않아도 API는 계속 데이터를 반환합니다. 물론 애플리케이션을 수정하여 views와 playlistViews를 모두 검색하고 표시할 수 있습니다.

    isCurated 측정기준 외에도 다음 API 기능은 더 이상 새 보고서에서 지원되지 않습니다.

    • continent 및 subcontinent와 같은 위치 필터는 새 채널 재생목록 보고서에서 지원되지 않습니다.
    • 새 채널 재생목록 보고서에서는 더 이상 redViews 및 estimatedRedMinutesWatched 측정항목이 지원되지 않습니다. 이러한 측정항목은 YouTube 스튜디오에서 사용할 수 없었으므로 이번 변경사항은 API 기능을 스튜디오 애플리케이션에서 사용할 수 있는 기능과 일치시킵니다.
    • subscribedStatus 및 youtubeProduct 측정기준은 더 이상 채널 재생목록 보고서의 필터로 지원되지 않습니다. 이러한 필터는 YouTube 스튜디오에서 사용할 수 없었으므로 이번 변경사항은 API 기능을 스튜디오 애플리케이션에서 사용할 수 있는 기능과 일치시킵니다.

  • 콘텐츠 소유자 보고서 문서의 재생목록 보고서 섹션이 업데이트되어 재생목록 보고서에 지원되는 측정항목 유형을 더 자세히 설명합니다.

    • 집계된 동영상 측정항목은 콘텐츠 소유자가 소유한 콘텐츠 소유자의 재생목록에 있는 모든 동영상에 대해 집계된 사용자 활동 및 노출 측정항목을 제공합니다. 집계된 동영상 측정항목은 isCurated 측정기준을 사용하지 않는 API 요청에 대해서만 지원됩니다.
    • 재생목록 내 측정항목은 재생목록 페이지의 맥락에서 사용자 활동 및 참여도를 반영합니다. 이러한 측정항목에는 재생목록에 포함된 소유하지 않은 동영상의 조회수도 포함되지만 재생목록 맥락에서 발생한 경우에만 포함됩니다.
    • 지원되는 재생목록 측정항목 섹션에서는 재생목록 보고서에 지원되는 집계된 동영상 측정항목과 재생목록 내 측정항목을 확인할 수 있습니다.

  • 콘텐츠 소유자의 재생목록 보고서에는 다음과 같은 새로운 재생목록 내 측정항목이 지원됩니다. 이러한 측정항목은 보고서를 가져오는 API 요청에서 isCurated 측정기준을 사용하지 않는 경우에만 지원됩니다. 각 측정항목의 정의는 측정항목 문서를 참고하세요.

  • 이제 views 측정항목의 동작은 재생목록 보고서를 가져온 API 요청에서 isCurated 측정기준을 사용했는지 여부에 따라 달라집니다.

    • 요청에 isCurated 측정기준이 포함된 경우 views 측정항목은 콘텐츠 소유자의 재생목록 맥락에서 동영상이 조회된 횟수를 나타내는 재생목록 내 측정항목입니다.
    • 요청에 isCurated 측정기준이 포함되지 않은 경우 views 측정항목은 콘텐츠 소유자의 재생목록에 있는 동영상이 재생목록 맥락에서 재생되었는지와 관계없이 동영상이 재생된 총 횟수를 지정하는 집계된 동영상 측정항목입니다. 집계된 총계에는 재생목록을 소유한 채널과 연결된 콘텐츠 소유자가 소유한 동영상의 조회수만 포함됩니다.

      isCurated 측정기준을 사용하지 않는 이러한 보고서에서 playlistViews 측정항목은 재생목록 맥락에서 동영상이 재생된 횟수를 나타냅니다. 이 측정항목은 소유한 채널과 관계없이 재생목록에 있는 모든 동영상의 조회수를 집계합니다.

  • 이제 각 재생목록 보고서의 콘텐츠 소유자 보고서 문서에 API 요청에 isCurated 측정기준이 포함되는지에 따라 해당 보고서에 지원되는 측정항목을 보여주는 표가 포함됩니다. 예시는 시간 기반 재생목록 보고서를 정의하는 섹션을 참고하세요.

2024년 1월 19일

YouTube 분석 (타겟팅 쿼리) API에 채널 재생목록 보고서와 관련된 몇 가지 업데이트가 있습니다. 이번 업데이트에는 지원 중단된 측정기준과 몇 가지 새로운 측정항목 및 업데이트된 측정항목이 포함됩니다.

  • 참고: 지원 중단 공지사항입니다.

    채널 보고서에서 isCurated 측정기준이 지원 중단되었습니다. 2024년 6월 30일 이후에는 더 이상 지원되지 않습니다. 이에 따라 해당 측정기준의 정의가 업데이트되었습니다.

    isCurated 측정기준을 삭제할 때 이전 버전과의 호환성을 유지하려면 재생목록 보고서 전용으로 views 측정항목 대신 playlistViews 측정항목을 가져오도록 코드도 업데이트해야 합니다. views 측정항목은 의미가 다르지만 재생목록 보고서에 계속 지원되므로 측정항목 이름을 업데이트하지 않아도 API는 계속 데이터를 반환합니다. 물론 애플리케이션을 수정하여 views와 playlistViews를 모두 검색하고 표시할 수 있습니다.

    isCurated 측정기준 외에도 다음 API 기능은 더 이상 새 보고서에서 지원되지 않습니다.

    • continent 및 subcontinent와 같은 위치 필터는 새 채널 재생목록 보고서에서 지원되지 않습니다.
    • 새 채널 재생목록 보고서에서는 더 이상 redViews 및 estimatedRedMinutesWatched 측정항목이 지원되지 않습니다. 이러한 측정항목은 YouTube 스튜디오에서 사용할 수 없었으므로 이번 변경사항은 API 기능을 스튜디오 애플리케이션에서 사용할 수 있는 기능과 일치시킵니다.
    • subscribedStatus 및 youtubeProduct 측정기준은 더 이상 채널 재생목록 보고서의 필터로 지원되지 않습니다. 이러한 필터는 YouTube 스튜디오에서 사용할 수 없었으므로 이번 변경사항은 API 기능을 스튜디오 애플리케이션에서 사용할 수 있는 기능과 일치시킵니다.

  • 채널 보고서 문서의 재생목록 보고서 섹션이 업데이트되어 재생목록 보고서에 지원되는 측정항목 유형을 더 자세히 설명합니다.

    • 집계된 동영상 측정항목은 채널에서 소유하고 있는 채널의 재생목록에 있는 모든 동영상에 대해 집계된 사용자 활동 및 노출 측정항목을 제공합니다. 집계된 동영상 측정항목은 isCurated 측정기준을 사용하지 않는 API 요청에 대해서만 지원됩니다.
    • 재생목록 내 측정항목은 재생목록 페이지의 맥락에서 사용자 활동 및 참여도를 반영합니다. 이러한 측정항목에는 재생목록에 포함된 소유하지 않은 동영상의 조회수도 포함되지만 재생목록 맥락에서 발생한 경우에만 포함됩니다.
    • 지원되는 재생목록 측정항목 섹션에서는 재생목록 보고서에 지원되는 집계된 동영상 측정항목과 재생목록 내 측정항목을 확인할 수 있습니다.

  • 채널의 재생목록 보고서에는 다음과 같은 새로운 재생목록 내 측정항목이 지원됩니다. 이러한 측정항목은 아직 콘텐츠 소유자 보고서에 지원되지 않습니다. 이러한 측정항목은 보고서를 가져오는 API 요청에서 isCurated 측정기준을 사용하지 않는 경우에만 지원됩니다. 각 측정항목의 정의는 측정항목 문서를 참고하세요.

  • 이제 views 측정항목의 동작은 재생목록 보고서를 가져온 API 요청에서 isCurated 측정기준을 사용했는지 여부에 따라 달라집니다.

    • 요청에 isCurated 측정기준이 포함된 경우 views 측정항목은 채널 재생목록의 맥락에서 동영상이 조회된 횟수를 나타내는 재생목록 내 측정항목입니다.
    • 요청에 isCurated 측정기준이 포함되지 않은 경우 views 측정항목은 재생목록 맥락에서 조회되었는지 여부와 관계없이 채널 재생목록의 동영상이 조회된 총 횟수를 지정하는 집계된 동영상 측정항목입니다. 집계된 총계에는 재생목록을 소유한 채널에서 소유한 동영상의 조회수만 포함됩니다.

      isCurated 측정기준을 사용하지 않는 이러한 보고서에서 playlistViews 측정항목은 재생목록 맥락에서 동영상이 재생된 횟수를 나타냅니다. 이 측정항목은 소유한 채널과 관계없이 재생목록에 있는 모든 동영상의 조회수를 집계합니다.

  • 이제 채널 보고서 문서에 API 요청에 isCurated 측정기준이 포함되는지에 따라 해당 보고서에 지원되는 측정항목을 보여주는 표가 각 재생목록 보고서에 포함됩니다. 예시는 시간 기반 재생목록 보고서를 정의하는 섹션을 참고하세요.

2023년 12월 4일

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

2022년 12월 15일

YouTube 분석 (타겟팅 쿼리) API는 다음과 같은 두 가지 새로운 측정기준과 하나의 새로운 보고서를 지원합니다.

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

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

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

  • 이제 YouTube Analytics API 샘플 요청 가이드에 두 가지 새로운 측정기준의 예시가 포함되어 있습니다.

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

2022년 8월 26일

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

  • YouTube Analytics API (타겟팅 쿼리) API에서 insightTrafficSourceType 측정기준의 값이 SUBSCRIBER인 경우 insightTrafficSourceDetail 값을 podcasts로 설정할 수 있습니다. 이는 트래픽이 팟캐스트 도착 페이지에서 추천되었음을 나타냅니다.
  • YouTube Reporting (대량 보고서) 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 측정기준은 현재 female 및 male 두 가지 값을 지원합니다. 2022년 8월 11일부터 이 측정기준은 female, male, user_specified의 세 가지 값을 지원합니다.
  • YouTube Reporting (대량 보고서) 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 보고 (대량 보고서) API는 조회수가 실시간 리디렉션에서 발생했음을 나타내는 새로운 트래픽 소스 측정기준 값을 지원합니다.

  • YouTube Reporting (대량 보고서) API에서 traffic_source_type 측정기준은 28 값을 지원합니다.

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

2020년 9월 23일

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

  • YouTube Analytics API (타겟팅 쿼리) API에서 insightTrafficSourceType 측정기준은 SHORTS 값을 지원합니다.
  • YouTube Reporting (대량 보고서) 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 (일괄 보고서) API와 관련된 다음과 같은 변경사항이 포함되어 있습니다. YouTube 고객센터에서 변경사항에 대해 자세히 알아보세요.

두 API 모두 알림에 사용할 수 있는 트래픽 소스 세부정보 값 집합이 변경됩니다. 타겟팅 쿼리에서는 알림이 insightTrafficSourceType=NOTIFICATION로 보고됩니다. 일괄 보고서에서는 알림이 traffic_source_type=17로 보고됩니다.

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

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

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

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

2019년 10월 15일

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

  • 참고: 지원 중단 공지사항입니다.

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

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

    • 7일 동안의 조회수는 해당 기간의 각 날짜 조회수를 집계하여 계산할 수 있습니다.
    • 7일 동안의 viewerPercentage는 매일 발생한 조회수에 해당 날짜의 viewerPercentage를 곱하여 그날 동영상을 시청할 때 로그인한 시청자 수를 구하면 계산할 수 있습니다. 그런 다음 전체 기간 동안 로그인한 시청자 수를 더하고 해당 기간의 총 조회수로 나누면 전체 기간의 viewerPercentage를 얻을 수 있습니다.
    • 동일한 시청자가 여러 날에 걸쳐 순 시청자로 계산될 수 있으므로 7일 동안의 순 시청자 수는 계산할 수 없습니다. 하지만 30DayTotals 측정기준 대신 month 측정기준을 사용하여 30일 동안의 순 시청자 수에 관한 데이터를 추정할 수 있습니다. month 측정기준은 30일 기간을 계산하는 반면 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 분석 보고서에서 제한될 수 있는 데이터 유형에 관한 설명도 포함되어 있습니다.

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

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 범위

      첫 번째 옵션은 읽기/쓰기 범위인 하나의 범위를 사용하는 반면, 두 번째 옵션은 읽기 전용 범위 두 개를 사용합니다.

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 신고 (일괄 신고) API와 관련된 다음과 같은 변경사항이 포함되어 있습니다.

  • 다음 변경사항은 현재 2018년 7월에 적용될 예정이며, 새로운 정책은 전 세계 모든 보고서 및 보고 작업에 적용됩니다.

    • 변경 후에는 백필 보고서를 비롯한 대부분의 API 보고서가 생성된 후 60일 동안 사용할 수 있습니다. 그러나 이전 데이터가 포함된 보고서는 생성된 후 30일 동안 사용할 수 있습니다.

      이번 공지사항 이전에는 모든 API 보고서를 생성된 시점부터 180일 동안 사용할 수 있었습니다. 다시 말해, 이 정책 변경사항이 적용되면 30일이 지난 이전 데이터 보고서에도 더 이상 API를 통해 액세스할 수 없게 됩니다. 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 리소스에 대한 언급이 포함되지 않는다는 내용으로 보고서 특성 섹션이 업데이트되었습니다.

  • 새 보고 작업을 예약하면 이전 보고서가 일반적으로 며칠 이내에 게시된다는 내용을 포함하도록 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를 대신 사용해야 합니다.

    또한 v2 API에서는 일부 v1 기능이 지원되지 않습니다.

    • 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 속성 정의에 설명되어 있습니다.

  • API가 이러한 측정기준에 대해 반환하는 실제 값을 표시하도록 age group 및 gender 측정기준의 문서가 수정되었습니다. 이는 문서 수정사항이며 API 기능 또는 동작의 변경사항을 반영하지 않습니다. 특히 다음 값이 변경되었습니다.

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

2017년 8월 10일

2016년 8월 10일에 이 문서에서는 YouTube 분석 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 Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      또한 값 52를 식별하는 데 사용되는 이름이 문서에서 값 73 (Kakao Story)와 더 명확하게 구분되도록 Kakao (Kakao Talk)로 업데이트되었습니다. 이 변경사항은 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 시청자와 관련된 redViews 및 estimatedRedMinutesWatched 측정항목을 지원합니다. 사실 API는 한동안 이러한 측정항목을 지원해 왔으며 YouTube Reporting API는 이미 2016년 9월 15일에 발표된 대로 두 측정항목을 모두 지원합니다.

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

    두 가지 새로운 측정항목을 지원하는 보고서를 표시하도록 채널 보고서 및 콘텐츠 소유자 보고서 문서가 업데이트되었습니다. views 및 estimatedMinutesWatched 측정항목을 이미 지원하는 모든 보고서에서 지원됩니다.

2017년 3월 3일

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

  • YouTube Reporting API (일괄 보고서)

    • date 측정기준의 정의가 수정되어 측정기준 값이 지정된 일, 월, 연도의 태평양 표준시 오전 12시부터 오후 11시 59분까지의 기간을 참조함을 명시했습니다. 태평양 표준시는 계절에 따라 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 (타겟팅된 쿼리)

    • time periods와 관련된 측정기준 설명이 수정되어 측정기준 값이 지정된 일, 월, 연도의 태평양 표준시 오전 12시부터 오후 11시 59분까지의 기간을 참조함을 명시했습니다. 태평양 표준시는 계절에 따라 UTC-7 또는 UTC-8입니다.

      날짜는 일반적으로 24시간 기간을 나타내지만 시계가 앞으로 조정된 날짜는 23시간 기간을 나타내고 시계가 뒤로 조정된 날짜는 25시간 기간을 나타냅니다. 이전 문서에서는 태평양 시간이 UTC-8이라고 설명했으며 하루가 24시간을 나타내지 않을 수 있다는 가능성을 언급하지 않았습니다.

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

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

    • operatingSystem 측정기준은 세 가지 새로운 측정기준 값을 지원합니다.
      • 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는 세 가지 새로운 최종 화면 보고서와 해당 보고서의 새로운 측정기준 및 측정항목을 지원합니다. 이 보고서는 동영상 재생이 중지된 후 표시되는 최종 화면에 대한 노출수 및 클릭률 통계를 제공합니다.

    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 분석의 일괄 보고서를 검색하는 프로세스와 약간 다릅니다.

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

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

    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 엔지니어링 및 개발자 블로그에서 자세히 설명한 바와 같이 새로 게시된 YouTube API 서비스 약관 ('업데이트된 약관')에는 현재 서비스 약관에 대한 다양한 업데이트 내용이 포함되어 있습니다. 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 측정기준은 시청자가 추천된 동영상을 식별합니다.

      • API의 핵심 측정항목 목록이 수정되어 estimated_partner_revenue이 핵심 측정항목으로 표시되고 목록에서 earnings이 삭제되었습니다. earnings 측정항목은 YouTube Reporting API에서 지원된 적이 없습니다.

      • 이제 ad_type 측정기준에서 동영상을 볼 수 있기 전에 재생되는 건너뛸 수 없는 동영상 광고(최대 6초)인 범퍼 광고를 나타내는 19 값을 지원합니다.

    2016년 7월 18일

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

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

      • 카드 측정항목을 포함하도록 다음 채널 보고서에 지원되는 측정항목 목록이 업데이트되었습니다. 이 보고서의 카드 측정항목 지원은 실제로 2016년 6월 28일에 추가되었으며 해당 날짜의 버전 기록 항목에서 변경사항을 자세히 설명합니다. 보고서는 다음과 같습니다.
        • 미국 주별 기본 사용자 활동
        • 특정 기간 동안의 미국 여러 주의 사용자 활동
        • 행정구역별 사용자 활동
        • 구독 상태별 사용자 활동
        • 행정구역별 구독 상태에 따른 사용자 활동
        • 주별 인기 동영상
        • 구독자 또는 구독 취소한 시청자에게 인기 있는 동영상

      • video 필터가 필요하고 group 필터는 지원되지 않는다는 점을 반영하도록 채널 시청 지속 시간 보고서 및 콘텐츠 소유자 시청 지속 시간 보고서의 필터 목록이 수정되었습니다.

        이전에는 두 보고서의 문서에 두 필터 중 하나를 사용하거나 두 필터 중 어느 것도 사용하지 않고 보고서를 검색할 수 있다고 잘못 설명되어 있었습니다.

    • YouTube Reporting API (일괄 보고서)

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

    2016년 6월 28일

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

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

    2016년 6월 22일

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

    • API 개요의 보고서 특성 섹션이 업데이트되어 보고서는 생성된 후 180일 동안 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 보고서가 지원 중단되었습니다.

      이러한 보고서에 대한 작업이 있는 경우 2016년 9월 22일 이후에는 YouTube에서 해당 작업에 대한 새 보고서를 생성하지 않습니다. 생성된 보고서는 생성된 후 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_percentage 및 audience_retention_type 속성이 표시되지 않습니다. 이러한 측정기준은 현재 API를 통해 제공되는 보고서에서 지원되지 않습니다.

    2016년 5월 19일

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

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

      content_owner_basic_a1 보고서를 만드는 작업이 이미 있는 경우에도 content_owner_basic_a2 보고서의 새 작업을 만들어야 합니다. YouTube는 콘텐츠 소유자를 새 보고서 버전으로 자동으로 이전하거나 새 보고서 버전을 생성하는 작업을 자동으로 만들지 않습니다. 일부 구현에서는 예기치 않은 새 작업이 표시되면 중대한 변경사항이 될 수 있습니다.

      새 보고서 출시와 함께 content_owner_basic_a1 보고서가 지원 중단되었습니다. 해당 보고서에 대한 작업이 있는 경우 2016년 8월 19일 이후에는 YouTube에서 해당 작업에 대한 새 보고서를 생성하지 않습니다. 생성된 보고서는 생성된 후 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가 이전 데이터를 전송하지 않았습니다. 이 변경사항은 이 공지사항 이전에 생성된 작업을 비롯한 모든 작업에 영향을 미칩니다.

      이전 보고서는 사용 가능해지는 즉시 게시되지만 작업에 대한 모든 이전 데이터가 게시되기까지는 약 1개월이 걸립니다. 따라서 보고 작업을 예약한 후 한 달이 지나면 약 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 Reporting API

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

    YouTube Analytics API

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

    2016년 2월 8일

    카드 측정항목이 더 이상 YouTube Analytics API의 지원 측정항목으로 표시되지 않도록 YouTube Analytics API에서 지원되는 측정항목 목록이 업데이트되었습니다. 이 API의 보고서 중 카드 측정항목을 지원한다고 문서화된 보고서는 없습니다.

    YouTube Reporting API를 사용하여 카드 측정항목을 계속 가져올 수 있습니다. 이 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_impressions 및 annotation_closable_impressions 측정항목의 이름이 보고서에 반환되는 이름과 일치하도록 업데이트되었습니다. 이전에는 이름이 clickable_annotation_impressions 및 closable_annotation_impressions로 문서화되었습니다.

    2015년 12월 18일

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

    2015년 12월 15일

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

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

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

      채널 및 콘텐츠 소유자가 사용할 수 있는 새로운 재생 세부정보 보고서를 식별하도록 문서가 업데이트되었습니다. 또한 이러한 측정기준 중 하나 이상을 선택적으로 보고서의 측정기준 또는 필터로 사용할 수 있다는 점을 명시하도록 다른 여러 보고서가 업데이트되었습니다.

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

      목차
      크기:
      필수 deviceType
      0 이상을 사용합니다. day, liveOrOnDemand, subscribedStatus, youtubeProduct
      측정항목:
      1개 이상 사용 조회수, estimatedMinutesWatched
      필터:
      0 또는 1 사용 country, province, continent, subContinent
      0 또는 1 사용 동영상, 그룹
      0 이상을 사용합니다. operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

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

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

      예를 들어 사용자가 video 필터가 20개의 동영상 ID를 나열하는 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일

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

    • YouTube Reporting API의 date 측정기준에 관한 문서가 태평양 표준시 (UTC-8) 오전 12시부터 시작되는 24시간 기간을 참조한다는 점을 반영하도록 수정되었습니다. 이전 문서에서는 이 날짜가 오전 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 값은 목록의 새 값입니다.

    2015년 9월 24일

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

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

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

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

    • YouTube Analytics API와 YouTube Reporting API는 서로 다른 API이지만 개발자가 YouTube 분석 데이터를 가져올 수 있습니다. 두 API 모두 유사한 데이터 세트에 대한 액세스를 제공하므로 두 API의 문서는 단일 문서 집합으로 게시됩니다.

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

    2015년 8월 20일

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

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

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

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

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

    2015년 7월 22일

    이번 업데이트에는 콘텐츠 소유자에게만 적용되는 몇 가지 변경사항이 포함되어 있습니다.

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

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

    • primaryAdGrossRevenue 측정항목이 지원 중단되었습니다. 대신 grossRevenue 측정항목을 사용하여 수익 데이터를 가져옵니다.

    • 지원 중단된 primaryAdGrossRevenue 측정항목 외에도 광고 실적 보고서에서는 더 이상 monetizedPlaybacks 및 playbackBasedCpm 측정항목을 지원하지 않습니다. 하지만 일부 동영상 보고서에서는 이러한 측정항목을 계속 지원합니다.

    2015년 6월 1일

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

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

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

      두 측정항목 모두 '나중에 볼 동영상' 재생목록과 같은 기본 재생목록을 포함합니다. 하지만 동영상이 자동으로 추가되는 재생목록(예: 채널의 업로드 재생목록 또는 사용자의 시청 기록)은 집계되지 않습니다. 또한 이 측정항목은 추가 및 삭제의 절대 수를 반영합니다. 따라서 사용자가 동영상을 재생목록에 추가한 다음 삭제했다가 다시 추가하면 측정항목에 동영상이 재생목록 2개에 추가되고 재생목록 1개에서 삭제되었다고 표시됩니다.

      이 측정항목의 데이터는 2014년 10월 1일부터 사용할 수 있습니다.

    2015년 3월 31일

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

    • favoritesAdded 및 favoritesRemoved 측정항목은 이 발표를 기준으로 모두 지원 중단됩니다. 이 두 측정항목은 모두 핵심 측정항목이며 서비스 약관에 명시된 지원 중단 정책의 적용을 받습니다.

    2015년 3월 16일

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

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

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

    2015년 2월 25일

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

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

      • 그룹 만들기 및 관리하기

        이 업데이트에서는 그룹을 만들고 관리하기 위한 group 및 groupItem 리소스를 도입합니다.

        • 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에서 재생목록 맥락에서 발생한 동영상 조회수와 관련된 통계가 포함된 재생목록 보고서를 지원합니다. 재생목록 보고서는 채널 및 콘텐츠 소유자가 사용할 수 있습니다.

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

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

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

      재생목록 보고서를 가져오기 위한 모든 요청은 isCurated 필터를 사용해야 하며, 이 필터는 1 (isCurated==1)로 설정해야 합니다.

    • 이제 API에서 시청 지속 시간 보고서를 지원합니다. 이 보고서는 동영상이 시청자의 관심을 얼마나 끌고 있는지를 측정합니다. 보고서의 새 elapsedVideoTimeRatio 측정기준은 해당 측정항목 값에 대해 경과된 동영상 길이를 측정합니다.

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

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

      • relativeRetentionPerformance 측정항목은 비슷한 길이의 모든 YouTube 동영상과 비교하여 재생 중에 동영상이 시청자의 관심을 얼마나 끌 수 있는지를 보여줍니다. 값이 0이면 동영상의 시청 지속 시간이 비슷한 길이의 다른 동영상보다 낮음을 나타내고, 값이 1이면 동영상의 시청 지속 시간이 비슷한 길이의 다른 동영상보다 높음을 나타냅니다. 중앙값이 0.5이면 비슷한 길이의 동영상 중 절반은 시청자를 더 잘 유지하고 절반은 시청자를 더 나쁘게 유지한다는 의미입니다.

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

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

      모든 새 측정항목은 핵심 측정항목이며 지원 중단 정책이 적용됩니다. 하지만 2013년 7월 16일부터는 새 측정항목에 대한 데이터를 사용할 수 있습니다. (annotationClickThroughRate 및 annotationCloseRate 측정항목의 데이터는 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 매개변수를 사용하여 응답에 특정 지역의 데이터만 포함되도록 합니다.

    • province가 dimensions 매개변수 값에 포함된 경우 요청에서 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 측정기준에 유효한 필터 값으로 insightTrafficSourceType 값 PROMOTED이 포함되지 않도록 문서가 수정되었습니다.

    2013년 9월 30일

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

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

    • 이제 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에서 시청자가 동영상을 시청하는 기기에 관한 데이터를 검색하는 데 사용할 수 있는 두 가지 새로운 측정기준인 deviceType 및 operatingSystem를 지원합니다. 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 요청 문서도 업데이트되었습니다.

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

      • 이제 선택적 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는 채널과 콘텐츠 소유자 모두를 위한 여러 가지 새로운 보고서를 지원하며, 이에 대해서는 아래에서 설명합니다. 각 보고서는 채널 보고서 또는 콘텐츠 소유자 보고서로 사용할 수 있습니다. 측정기준 및 측정항목 페이지도 이에 따라 업데이트되었습니다.

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

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

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

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

      • 시청 시간 보고서에는 시청자가 내 콘텐츠를 시청하는 데 소비한 시간이 표시됩니다. 보고서에서는 특정 기간(예: 일, 지난 7일, 지난 30일 등) 또는 국가의 데이터를 집계할 수 있습니다. 보고서에서 기간 또는 국가로 데이터를 집계한 경우 사용자가 시청한 각 동영상의 평균 비율과 각 동영상 조회의 평균 시간도 지정할 수 있습니다.

    2012년 10월 2일

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

    • 이제 모든 개발자가 YouTube Analytics API를 사용할 수 있습니다. 먼저 액세스를 요청하지 않고도 APIs console의 서비스 패널에서 프로젝트의 API를 활성화할 수 있습니다.

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

    2012년 9월 12일

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

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

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

      • 7DayTotals – 보고서의 데이터는 각 행에 7일간의 데이터가 포함되도록 집계됩니다.
      • 30DayTotals – 보고서의 데이터는 각 행에 30일 동안의 데이터가 포함되도록 집계됩니다.
      • month – 보고서의 데이터는 월별로 집계됩니다.

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

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

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

    • 동영상 보기 페이지, 채널 페이지, YouTube 홈페이지에 표시되는 가이드 등 여러 위치에서 채널의 구독자가 증가하거나 감소할 수 있음을 설명하도록 subscribersGained 및 subscribersLost 측정항목의 정의가 업데이트되었습니다. 동영상 전용 보고서에 이러한 측정항목이 표시될 경우에는 지정한 동영상의 보기 페이지에 대한 측정항목만 포함됩니다.