이 페이지에는 YouTube Reporting API 및 YouTube Analytics API 모두에 대한 API 변경사항 및 문서 업데이트가 나와 있습니다. 개발자는 두 API 모두 다양한 방법으로 YouTube 분석 데이터에 액세스할 수 있습니다. 변경 기록을 구독하세요.
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
측정기준을 사용하지 않는 경우에만 지원됩니다. 각 측정항목의 정의는 metrics 문서를 참조하세요. -
이제
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
측정기준을 사용하지 않는 경우에만 지원됩니다. 각 측정항목의 정의는 metrics 문서를 참조하세요. -
이제
views
측정항목의 동작은 재생목록 보고서를 검색한 API 요청에서isCurated
측정기준을 사용했는지에 따라 달라집니다.- 요청에
isCurated
측정기준이 포함된 경우views
측정항목은 채널의 재생목록과 관련하여 동영상이 조회된 횟수를 나타내는 재생목록 내 측정항목입니다. - 요청에
isCurated
측정기준이 포함되지 않은 경우views
측정항목은 재생목록 맥락에서 조회수가 발생했는지 여부와 관계없이 채널의 재생목록에 있는 동영상의 총 조회수를 지정하는 집계된 동영상 측정항목입니다. 집계된 총계에는 재생목록을 소유한 채널에서 소유한 동영상의 조회수만 포함됩니다.isCurated
측정기준을 사용하지 않는 이 보고서에서playlistViews
측정항목은 재생목록 맥락에서 동영상이 조회된 횟수를 나타냅니다. 이 측정항목은 채널 소유자에 관계없이 재생목록에 있는 모든 동영상의 조회수를 집계합니다.
- 요청에
-
이제 각 재생목록 보고서의 채널 보고서 문서에 API 요청에
isCurated
측정기준이 포함되었는지에 따라 지원되는 측정항목을 보여주는 표가 포함됩니다. 예를 보려면 시간 기반 재생목록 보고서 정의 섹션을 참조하세요.
2023년 12월 4일
YouTube 분석 (타겟팅된 쿼리) API가 두 개의 insightTrafficSourceType
측정기준 값을 병합하도록 업데이트되었습니다. 이전에는 재생목록의 일부로 재생된 동영상(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 샘플 요청 가이드에 새로운 측정기준에 대한 예가 모두 포함됩니다.
-
7DayTotals
및30DayTotals
측정기준에 대한 참조가 문서에서 삭제되었습니다. 이 측정기준의 지원 중단은 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
측정기준은 현재 두 가지 값(female
및male
)을 지원합니다. 2022년 8월 11일부터 이 측정기준은female
,male
,user_specified
의 세 가지 값을 지원합니다. - 현재 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 (Bulk Reports) API에 모두 영향을 미칩니다.
- 2021년 12월 13일부터 YouTube 분석 (타겟팅된 쿼리) API의
averageViewDuration
및averageViewPercentage
측정항목에서 루핑 클립 트래픽이 제외됩니다. - YouTube Reporting (Bulk Reports) API에서
average_view_duration_seconds
및average_view_duration_percentage
측정항목은 모두 2021년 12월 13일부터 반복 클립 트래픽을 제외합니다.
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 Analytics (타겟 쿼리) 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-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일 동안의 시청자 비율은 각 날짜에 발생한 조회수에 해당 날짜의 시청자 비율을 곱하여 그날 동영상을 시청할 때 로그인한 시청자 수를 구할 수 있습니다. 그런 다음 전체 기간에 로그인한 시청자 수를 더하고 해당 기간의 총 조회수로 나눠 전체 기간의 뷰어 비율을 확인할 수 있습니다.
- 동일한 시청자가 다른 날의 순 시청자로 계산될 수 있으므로 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 분석 데이터가 제한된다는 내용을 설명합니다. 이러한 상황은 다양한 경우에 발생할 수 있습니다. 실제로 다음과 같은 경우 보고서에 데이터가 전부 또는 전혀 포함되지 않을 수 있습니다.
-
특정 기간 동안 동영상 또는 채널의 트래픽이 제한된 경우
사용하여
-
값이 특정 기준을 충족하지 않는 필터 또는 측정기준(예: 트래픽 소스 또는 국가)을 선택한 경우
새 섹션에는 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
범위
첫 번째 옵션은 읽기-쓰기 범위인 1개의 범위를 사용하는 반면, 두 번째 옵션은 두 개의 읽기 전용 범위를 사용합니다.
2018년 5월 23일
이 업데이트에는 YouTube 분석 (타겟팅 쿼리) API에 다음과 같은 변경사항이 포함되어 있습니다.
- API 개요에는 측정항목 집계 및 삭제된 항목 집계라는 새로운 섹션이 포함되어 있습니다. 이 섹션에서는 API 응답이 동영상, 재생목록, 채널 등 삭제된 리소스와 연결된 데이터를 어떻게 처리하는지 설명합니다.
- API 개요의 권장사항 섹션이 업데이트되어 YouTube Data API를 사용하면 YouTube Analytics API 응답에서 식별된 리소스에 대한 추가 메타데이터를 검색할 수 있음을 다시 확인할 수 있습니다. YouTube API 서비스 개발자 정책 (III.E.4.b~III.E.4.d 섹션)에 명시된 바와 같이 API 클라이언트는 30일 후에 해당 API에서 저장된 리소스 메타데이터를 삭제하거나 새로고침해야 합니다.
2018년 5월 22일
이번 업데이트에는 YouTube Reporting (Bulk Reports) 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 (v2) 버전 2가 이제 공개적으로 제공됩니다. 다음 목록은 새 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 버전이
-
참고: 이 메시지는 지원 중단에 대한 공지입니다.
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 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 Music86
: YouTube 게임87
: YouTube Kids88
: YouTube TV
또한
52
값을 식별하는 데 사용되는 이름이 값73
(카카오 스토리)과 더 명확하게 구분되도록 문서에서 카카오 (카카오톡)로 업데이트되었습니다. 이러한 서비스에 공유된 동영상의 API 동작 또는 분류에는 변경사항이 반영되지 않습니다.
- 동영상 공유에 사용된 서비스를 식별하는
-
YouTube Analytics API (타겟팅된 쿼리)
- 이제
sharingService
측정기준은 다음 값을 지원합니다.YOUTUBE_GAMING
YOUTUBE_KIDS
YOUTUBE_MUSIC
YOUTUBE_TV
- 이제
2017년 3월 28일
크리에이터 스튜디오에서 YouTube 분석을 통해 수익 데이터에 액세스할 수 있는 채널 소유자는 이제 YouTube Analytics API를 통해서도 해당 수익 데이터에 액세스할 수 있습니다.
-
API는 다음과 같은 수익 관련 측정항목을 지원합니다.
adImpressions
cpm
estimatedAdRevenue
estimatedRedPartnerRevenue
estimatedRevenue
grossRevenue
monetizedPlaybacks
playbackBasedCpm
이러한 측정항목은 다음 보고서에서 지원됩니다.
-
이제 채널 소유자는
adType
측정기준 및day
측정기준(선택사항)을 지원하는 광고 실적 보고서를 검색할 수도 있습니다.
2017년 3월 17일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
-
YouTube Analytics API는 YouTube Red 시청률과 관련된
redViews
및estimatedRedMinutesWatched
측정항목을 지원합니다. 실제로 API는 이러한 측정항목을 한동안 지원했으며 2016년 9월 15일에 발표된 바와 같이 YouTube Reporting API는 이미 두 측정항목을 모두 지원하고 있습니다.redViews
측정항목은 YouTube Red 회원이 동영상을 시청한 횟수를 식별합니다.estimatedRedMinutesWatched
측정항목은 YouTube Red 회원이 동영상을 시청한 시간(분)을 나타냅니다.
채널 보고서 및 콘텐츠 소유자 보고서 문서가 업데이트되어 두 가지 새로운 측정항목을 지원하는 보고서가 표시됩니다.
views
및estimatedMinutesWatched
측정항목이 이미 지원되는 모든 보고서에서 지원됩니다.
2017년 3월 3일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
-
YouTube Reporting API (일괄 보고서)
-
측정기준 값이 지정된 일, 월, 년의 오전 12:00(태평양 표준시)에 시작하여 태평양 표준시로 오후 11시 59분에 끝나는 기간을 참조하도록
date
측정기준의 정의가 수정되었습니다. 태평양 시간은 연중 시간에 따라 UTC-7 또는 UTC-8입니다.날짜는 일반적으로 24시간 기간을 나타내고, 시간이 앞으로 조정되는 날짜는 23시간을 나타내고, 시간을 거꾸로 조정한 날짜는 25시간 기간을 나타냅니다. (이전에는 문서에 각 날짜가 고유한 24시간 기간을 나타내고 태평양 표준시는 항상 UTC-8이라고 명시되어 있었습니다.)
이러한 수정은 실제 API 동작의 변화를 나타내지 않습니다.
- 조회수가 발생한 기기의 소프트웨어 시스템을 식별하는
operating_system
측정기준은 이제 다음 값을 지원합니다.22
: Tizen23
: Firefox24
: RealMedia
-
content_owner_basic_a1
보고서 유형의 모든 보고 작업이 삭제되었습니다. 이 보고서 유형은 2016년 8월 19일부터 완전히 지원 중단되었지만 이전에 생성된content_owner_basic_a1
보고서는 생성된 후 180일 동안 계속 사용할 수 있었습니다. 따라서 일부 보고서는 2017년 2월 19일부터 액세스할 수 있었습니다. 하지만 보고서를 더 이상 사용할 수 없으므로 보고서와 관련된 작업도 필요하지 않습니다.
-
-
YouTube Analytics API (타겟팅된 쿼리)
-
측정기준 값이 지정된 날짜, 월, 연도의 오전 12:00 태평양 표준시에서 오후 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일입니다.)
-
채널 보고서
channel_basic_a1
-channel_basic_a2
보고서로 대체되었습니다.channel_province_a1
-channel_province_a2
보고서로 대체되었습니다.channel_playback_location_a1
-channel_playback_location_a2
보고서로 대체되었습니다.channel_traffic_source_a1
-channel_traffic_source_a2
보고서로 대체되었습니다.channel_device_os_a1
-channel_device_os_a2
보고서로 대체되었습니다.channel_subtitles_a1
-channel_subtitles_a2
보고서로 대체되었습니다.channel_combined_a1
-channel_combined_a2
보고서로 대체되었습니다.
-
콘텐츠 소유자 보고서
content_owner_basic_a2
-content_owner_basic_a3
보고서로 대체되었습니다.content_owner_province_a1
-content_owner_province_a2
보고서로 대체되었습니다.content_owner_playback_location_a1
-content_owner_playback_location_a2
보고서로 대체되었습니다.content_owner_traffic_source_a1
-content_owner_traffic_source_a2
보고서로 대체되었습니다.content_owner_device_os_a1
-content_owner_device_os_a2
보고서로 대체되었습니다.content_owner_subtitles_a1
-content_owner_subtitles_a2
보고서로 대체되었습니다.content_owner_combined_a1
-content_owner_combined_a2
보고서로 대체되었습니다.content_owner_asset_basic_a1
-content_owner_asset_basic_a2
보고서로 대체되었습니다.content_owner_asset_province_a1
-content_owner_asset_province_a2
보고서로 대체되었습니다.content_owner_asset_playback_location_a1
-content_owner_asset_playback_location_a2
보고서로 대체되었습니다.content_owner_asset_traffic_source_a1
-content_owner_asset_traffic_source_a2
보고서로 대체되었습니다.content_owner_asset_device_os_a1
-content_owner_asset_device_os_a2
보고서로 대체되었습니다.content_owner_asset_combined_a1
-content_owner_asset_combined_a2
보고서로 대체되었습니다.
API 참조 문서의 현재 보고서 유형 목록도 업데이트되었습니다.
2016년 11월 11일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
-
최종 화면 보고서
- 채널 동영상에 대한 최종 화면 보고서에는 채널의 모든 동영상에 대한 통계가 포함됩니다.
- 콘텐츠 소유자 동영상의 최종 화면 보고서에는 콘텐츠 소유자 채널에 있는 동영상에 대한 통계가 포함됩니다.
- 콘텐츠 소유자 애셋의 최종 화면 보고서에는 최종 화면이 표시된 동영상과 연결된 저작물에 대한 통계가 포함됩니다.
-
최종 화면 크기
end_screen_element_type
: 통계와 관련된 최종 화면 요소의 유형입니다.end_screen_element_id
: YouTube가 최종 화면 요소를 고유하게 식별하는 데 사용하는 ID입니다.
최종 화면 측정항목
참고: 최종 화면 측정항목 데이터는 2016년 5월 1일부터 사용할 수 있습니다.
end_screen_element_impressions
: 최종 화면 요소의 총 노출수입니다. 표시되는 최종 화면 요소마다 1회의 노출이 기록됩니다.end_screen_element_clicks
: 최종 화면 요소가 클릭된 횟수입니다.end_screen_element_click_rate
: 최종 화면 요소의 클릭률입니다.
-
다음 보고서는 더 이상 지원되지 않으며 문서에서 삭제되었습니다. 각 보고서의 최신 버전을 사용할 수 있습니다. (이 보고서에 대한 지원 중단 공지는 2016년 6월 22일에 발표되었습니다.)
content_owner_ad_performance_a1
-content_owner_ad_rates_a1
보고서로 대체되었습니다.content_owner_estimated_earnings_a1
-content_owner_estimated_revenue_a1
보고서로 대체되었습니다.content_owner_asset_estimated_earnings_a1
-content_owner_asset_estimated_revenue_a1
보고서로 대체되었습니다.
-
다음 목록의 측정항목은 완전히 지원 중단되었으며 더 이상 지원되지 않습니다. 2016년 8월 10일에 발표된 바와 같이 동일한 데이터를 참조하는 새 측정항목은 이미 지원되고 있습니다. 아래 표에는 지원 중단된 측정항목 이름과 새 측정항목 이름이 나와 있습니다.
지원 중단된 측정항목 새 측정항목 adEarnings
estimatedAdRevenue
impressionBasedCpm
cpm
impressions
adImpressions
redPartnerRevenue
estimatedRedPartnerRevenue
- 동영상별 월별 전 세계 광고 수익
- 동영상별 일일 국가별 광고 수익
- 저작물별 월간 전 세계 광고 수익
- 저작물별 국가별 일일 광고 수익
- 소유권 주장 (이 보고서에는 수익 데이터가 포함되지 않음)
-
이 API는 YouTube Red 시청률과 관련된 두 가지 새로운 측정항목을 지원합니다.
red_views
: YouTube Red 회원이 동영상을 시청한 횟수입니다.red_watch_time_minutes
: YouTube Red 회원이 동영상을 시청한 시간(분)입니다.
-
API는 새로운 버전의 20개 보고서를 지원합니다. 모든 새 버전은 새로운
red_views
및red_watch_time_minutes
측정항목을 지원합니다.각 보고서에서 새 보고서 유형 ID의 숫자는 이전 보고서 유형 ID의 숫자보다 하나 더 높습니다. (이 보고서의 이전 버전은 후반부 업데이트 내역에 설명된 대로 이제 지원이 중단되었습니다.) 예를 들어
channel_basic_a1
보고서는 이제 지원 중단되고channel_basic_a2
보고서로 대체되었습니다.다음 목록은 새 보고서 유형 ID를 나타냅니다.
채널 동영상 보고서
콘텐츠 소유자 동영상 보고서
콘텐츠 소유자 저작물 보고서
-
참고: 이 메시지는 지원 중단에 대한 공지입니다.
위에 나열된 이전 버전의 보고서를 만드는 작업이 이미 있는 경우 이름이 변경된 보고서에 대해 새 작업을 만들어야 합니다. 새 보고서 버전의 출시와 함께 다음 보고서 버전이 지원 중단되었습니다.
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년 12월 15일 이후에는 YouTube에서 해당 작업에 대한 새 보고서를 생성하지 않습니다. 생성된 보고서는 생성된 후 180일 동안 계속 사용할 수 있습니다.
-
content_owner_basic_a1
보고서는 완전히 지원 중단되었으며 문서에서 삭제되었습니다. YouTube에서는 더 이상 해당 유형의 새 보고서를 생성하지 않지만 이미 생성된 보고서는 생성된 날로부터 180일 동안 계속 사용할 수 있습니다.content_owner_basic_a1
보고서는 2016년 5월 19일의 업데이트 기록 항목에 설명된 대로content_owner_basic_a2
보고서입니다. -
새로 게시된 YouTube API 서비스 약관 ('업데이트된 약관')은 YouTube 엔지니어링 및 개발자 블로그에서 자세히 논의했으며, 현재 서비스 약관에 대한 다양한 업데이트 내용이 포함되어 있습니다. 이 업데이트에는 2017년 2월 10일부터 적용될 업데이트된 약관 외에도 개발자가 따라야 하는 정책을 설명하는 데 도움이 되는 몇 가지 지원 문서가 포함되어 있습니다.
새로운 문서의 전체 내용은 업데이트된 약관의 업데이트 내역에서 확인할 수 있습니다. 또한 업데이트된 약관 또는 지원 문서에 대한 향후 변경도 해당 업데이트 내역에 설명되어 있습니다. 문서의 링크에서 업데이트 기록의 변경사항이 나열된 RSS 피드 목록을 구독할 수 있습니다.
-
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
측정기준은 새로운 측정기준 값 2개를 지원합니다.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초의 동영상 광고입니다.
- 이제
-
YouTube Analytics API (타겟팅된 쿼리)
- 다음 채널 보고서에서 지원되는 측정항목 목록이 카드 측정항목을 포함하도록 업데이트되었습니다. 이 보고서의 카드 측정항목 지원은 실제로 2016년 6월 28일에 추가되었으며 해당 날짜의 업데이트 기록 항목에서 변경사항에 대해 자세히 설명합니다. 보고서는 다음과 같습니다.
- 미국 주의 기본 사용자 활동
- 특정 기간 동안의 미국 여러 주의 사용자 활동
- 행정구역별 사용자 활동
- 구독 상태별 사용자 활동
- 지방의 구독 상태별 사용자 활동
- 주별 인기 동영상
- 구독 또는 구독하지 않은 시청자의 인기 동영상
-
video
필터가 필요하고group
필터가 지원되지 않음을 반영하도록 채널 시청 지속 시간 보고서 및 콘텐츠 소유자 시청 지속 시간 보고서의 필터 목록이 수정되었습니다.이전에는 두 보고서의 문서에 이 두 필터 중 하나를 사용하거나 두 필터 중 하나를 사용하지 않으면 보고서를 검색할 수 있다고 잘못 명시되어 있었습니다.
- 다음 채널 보고서에서 지원되는 측정항목 목록이 카드 측정항목을 포함하도록 업데이트되었습니다. 이 보고서의 카드 측정항목 지원은 실제로 2016년 6월 28일에 추가되었으며 해당 날짜의 업데이트 기록 항목에서 변경사항에 대해 자세히 설명합니다. 보고서는 다음과 같습니다.
-
YouTube Reporting API (일괄 보고서)
- API 개요에서 보고서의 다운로드 URL을 검색하는 방법을 설명하는 섹션은 YouTube에서 데이터가 없는 날짜에 대해 다운로드 가능한 보고서를 생성한다고 명시하도록 수정되었습니다. 이러한 보고서에는 헤더 행이 있지만 추가 데이터는 포함되어 있지 않습니다. 이 정보는 2016년 4월 12일에 동일한 문서의 보고서 특성 섹션에서 이미 업데이트되었습니다.
content_owner_asset_cards_a1
보고서의 측정기준 목록은 보고서에서card_id
측정기준을 사용하는 것으로 수정되었습니다. 이전에는 문서에 측정기준 이름이card_title
로 잘못 표시되었습니다.
- 기본 통계(채널, 콘텐츠 소유자)
- 시간 기반(채널, 콘텐츠 소유자)
- 사용자 지역 (채널, 콘텐츠 소유자)
- 구독 상태별 사용자 활동 (채널, 콘텐츠 소유자)
- 인기 동영상 (채널, 콘텐츠 소유자)
-
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
입니다.
새로 이름이 변경된 두 보고서 모두 이전 버전과 다른 점은 다음과 같습니다.
- YouTube Red 구독에서 발생하는 총 수입을 추정하는 새로운
estimated_partner_red_revenue
측정항목을 추가합니다. - 유료 콘텐츠 및 팬 후원과 같은 거래에서 발생한 수익을 추정하고 파트너가 청구한 환불 금액을 뺀 새로운
estimated_partner_transaction_revenue
측정항목을 추가합니다. estimated_partner_ad_sense_revenue
측정항목의 이름을estimated_partner_ad_auction_revenue
로 변경합니다.estimated_partner_double_click_revenue
측정항목의 이름을estimated_partner_ad_reserved_revenue
로 변경합니다.
이러한 보고서의 이전 버전을 만드는 작업이 이미 있는 경우 이름이 변경된 보고서에 대한 새 작업을 만들어야 합니다. 새 보고서 버전이 출시됨에 따라
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를 통해 제공되는 보고서에서는 지원되지 않습니다. -
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 요청 실패의 원인이 되는 여러 다른 이유가 나열됩니다. -
이제 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
입니다.
-
- 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 시스템 활동 대화상자
playback_location_type
측정기준은 새로운 측정기준 값 2개를 지원합니다.7
: YouTube 홈페이지나 홈 화면, 사용자의 구독 피드 또는 다른 YouTube 탐색 기능에서 발생한 조회수와 관련된 데이터입니다.8
: YouTube 검색결과 페이지에서 직접 발생한 조회수와 관련된 데이터입니다.
- 이제
traffic_source_type
측정기준은18
를 크기 값으로 지원합니다. 이 값은 재생목록에 있는 모든 동영상을 나열한 페이지에서 동영상 조회수가 발생했음을 나타냅니다. 이 소스는 동영상이 재생목록의 일부로 재생되는 동안 조회수가 발생했음을 나타내는 소스 유형14
와 다릅니다. insightPlaybackLocationType
측정기준은 새로운 측정기준 값 2개를 지원합니다.BROWSE
: YouTube 홈페이지나 홈 화면, 사용자의 구독 피드 또는 다른 YouTube 탐색 기능에서 발생한 조회수와 관련된 데이터입니다.SEARCH
: YouTube 검색결과 페이지에서 직접 발생한 조회수와 관련된 데이터입니다.
- 이제
insightTrafficSourceType
측정기준은YT_PLAYLIST_PAGE
를 크기 값으로 지원합니다. 이 값은 재생목록에 있는 모든 동영상을 나열한 페이지에서 동영상 조회수가 발생했음을 나타냅니다. 이 소스는 동영상이 재생목록의 일부로 재생되는 동안 조회수가 발생했음을 나타내는PLAYLIST
소스 유형과 다릅니다. - YouTube Reporting API에서
operating_system
측정기준은21
값을 사용하여 Chromecast를 통해 발생하는 조회수를 식별합니다. - YouTube Analytics API에서
operatingSystem
측정기준은CHROMECAST
값을 사용하여 Chromecast를 통해 발생하는 조회수를 식별합니다. -
이제 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
필터가 20개의 동영상 ID를 나열하는 API 요청을 제출한다고 가정해 보겠습니다. 사용자가 동영상 18개를 소유합니다. 그러나 한 동영상 ID는 다른 채널에서 소유한 동영상을 식별하고 다른 ID는 삭제되어 더 이상 존재하지 않는 동영상을 식별합니다. 이 경우, 이제 API 서버는 오류를 반환하는 대신 사용자가 액세스할 수 없는 동영상 2개를 삭제하고 API 응답에는 API 사용자가 소유한 동영상 18개에 대한 데이터가 포함됩니다. -
비어 있는 YouTube 분석
group
에 대한 데이터를 요청하면 이제 API에서 오류가 아닌 빈 데이터 세트를 반환합니다. -
항목을 그룹에 추가하려고 하지만 해당 항목에 액세스할 수 없는 경우 이제 YouTube Analytics API의
groupItems.insert
메서드가 승인되지 않은 (403
HTTP 응답 코드) 오류를 반환합니다. 이전에는 API를 사용하여 항목을 그룹에 추가할 수 있었지만 이후 해당 그룹에 대한 보고서 데이터를 검색하려고 하면 승인되지 않은 오류가 반환되었습니다. -
이제 YouTube Analytics API의
groups.list
메서드가 페이지로 나누기를 지원합니다. API 응답에 사용 가능한 그룹 중 일부가 포함되지 않은 경우 응답의nextPageToken
매개변수가 다음 결과 페이지를 검색하는 데 사용할 수 있는 토큰을 지정합니다. 메서드의pageToken
매개변수를 이 값으로 설정하여 추가 결과를 검색합니다. -
이제 YouTube Analytics API에서
redPartnerRevenue
측정항목을 지원합니다. 이 측정항목은 선택한 보고서 측정기준에 대해 YouTube Red 구독에서 발생한 총 예상 수익을 보고합니다. 측정항목 값은 음악 및 음악 외 콘텐츠 모두에서 발생한 수익을 반영하며 월말에 조정될 수 있습니다.redPartnerRevenue
측정항목을 지원하는 동영상 보고서를 식별할 수 있도록 YouTube Analytics API의 콘텐츠 소유자 보고서 목록이 업데이트되었습니다. -
이제 YouTube Analytics API의 인기 동영상 보고서 정의에 이 보고서에서
earnings
,adEarnings
,grossRevenue
,monetizedPlaybacks
,playbackBasedCpm
,impressions
,impressionBasedCpm
과 같은 수익 측정항목도 지원된다는 사실이 반영됩니다. -
날짜가 태평양 표준시 (UTC-8) 오전 12시에 시작되는 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
속성 정의가 모두 수정되어 속성 값이 나노초가 아닌 마이크로초 단위로 정확하다는 점을 언급합니다. 또한 이제 모든 정의에서 속성 값이 타임스탬프임을 정확하게 반영합니다. -
가능한 측정기준 값의 목록을 포함하도록 YouTube Analytics API의
sharingService
측정기준 관련 문서가 업데이트되었습니다. 이 목록에는 새로 지원되는 여러 서비스가 포함되어 있습니다.YouTube Reporting API의
sharing_service
측정기준의 정의도 새로 지원되는 값을 나열하도록 업데이트되었습니다.59
보다 큰 열거형 값은 목록에 새로 추가된 값입니다. -
새로운 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 문서를 재구성했습니다. 따라서 이러한 변경사항은 새로운 기능에 대해 설명하지 않습니다.
-
이제 문서에는 사용 가능한 모든 채널 보고서를 표시하는 한 페이지와 사용 가능한 모든 콘텐츠 소유자 보고서가 나열된 다른 페이지가 포함됩니다. 이전에는 이 문서에 채널 동영상 보고서, 채널 재생목록 보고서 등을 위한 별도의 페이지가 있었습니다.
-
새로운 데이터 모델 개요에서는 API의 작동 방식을 보다 명확하게 설명합니다. 특히 이 문서에서는 YouTube가 측정항목, 측정기준, 필터를 사용하여 보고서 값을 계산하는 방법을 보다 잘 설명합니다.
-
보고서를 검색하는 데 사용하는 API의
reports.query
메서드는 이제 별도로 문서화됩니다. 해당 페이지의 정보는 이전에 다른 일부 페이지에 있었습니다. 새 페이지에서 보고서를 검색하기 위해 전송해야 하는 정보를 더 쉽게 확인할 수 있습니다.
-
-
새로운
adEarnings
측정항목에는 모든 Google 판매 광고 소스의 예상 총 수익 (순수익)이 포함됩니다. 핵심 측정항목이 아닙니다. API는 이미earnings
측정항목을 지원한 모든 보고서에서adEarnings
측정항목을 지원합니다.또한 이 측정항목의 값에는 모든 Google 판매 광고 소스 및 광고 이외의 소스에서 발생한 총 예상 수입이 포함되어 있다는 사실이 반영되도록
earnings
측정항목의 정의가 수정되었습니다. 이전에는 측정항목에 광고 소스의 수입만 포함되었다고 잘못 정의되었습니다. -
primaryAdGrossRevenue
측정항목은 지원 중단되었습니다. 대신grossRevenue
측정항목을 사용하여 수익 데이터를 가져오세요. -
지원 중단된
primaryAdGrossRevenue
측정항목 외에도 광고 실적 보고서에서monetizedPlaybacks
및playbackBasedCpm
측정항목을 더 이상 지원하지 않습니다. 하지만 일부 동영상 보고서에서는 이러한 측정항목을 계속 지원합니다. -
이제 API는 동영상 보고서에 대해 두 가지 새로운 측정항목인
videosAddedToPlaylists
및videosRemovedFromPlaylists
를 지원합니다. 채널 및 콘텐츠 소유자에 대한 동영상 보고서 목록이 모두 업데이트되어 새로운 측정항목을 지원하는 보고서를 확인할 수 있습니다.videosAddedToPlaylists
– 쿼리 범위에 있는 동영상이 YouTube 재생목록에 추가된 횟수입니다. 동영상이 동영상 소유자의 재생목록이나 다른 채널의 재생목록에 추가되었을 수 있습니다.videosRemovedFromPlaylists
– 쿼리 범위에 속하는 동영상이 YouTube 재생목록에서 삭제된 횟수입니다. 동영상이 동영상 소유자의 재생목록이나 다른 채널의 재생목록에서 삭제되었을 수 있습니다.
두 측정항목 모두 '나중에 볼 동영상' 재생목록과 같은 기본 재생목록을 포함합니다. 하지만 채널의 업로드 재생목록이나 사용자의 시청 기록 등 동영상이 자동으로 추가된 재생목록은 포함되지 않습니다. 또한 이러한 측정항목은 추가 및 삭제의 절댓값을 반영합니다. 따라서 사용자가 재생목록에 동영상을 추가했다가 삭제한 후 다시 추가하는 경우 측정항목은 동영상이 두 개의 재생목록에 추가되고 한 재생목록에서 삭제된 것으로 표시됩니다.
이러한 측정항목에 대한 데이터는 2014년 10월 1일부터 제공됩니다.
-
favoritesAdded
및favoritesRemoved
측정항목은 이 공지부터 지원 중단됩니다. 모두 핵심 측정항목이며 서비스 약관에 명시된 지원 중단 정책이 적용됩니다. -
새
currency
매개변수를 사용하면 미국 달러 (USD
) 이외의 통화로 수익 측정항목을 가져올 수 있습니다. 매개변수가 설정되면 API에서earnings
,grossRevenue
,playbackBasedCpm
,impressionBasedCpm
측정항목의 값을 지정된 통화로 변환합니다. 반환되는 값은 매일 변화하는 환율을 사용하여 계산한 추정치입니다.매개변수 값은 3자리 ISO 4217 통화 코드입니다. 기본값은
USD
입니다. 매개변수 정의에는 지원되는 통화 코드 목록이 포함됩니다. -
이제 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 고객센터를 참조하세요.
-
-
API에서 더 이상
show
측정기준을 지원하지 않습니다. -
이제 API는
video
,playlist
,channel
,show
측정기준이 필터로 사용될 때 해당 측정기준에 여러 값을 지정할 수 있는 기능을 지원합니다. 여러 값을 지정하려면filters
매개변수 값을 API 응답을 필터링해야 하는 동영상, 재생목록, 채널 또는 프로그램 ID의 쉼표로 구분된 목록으로 설정합니다. 매개변수 값은 최대 200개의 ID를 지정할 수 있습니다.동일한 필터에 여러 값을 지정하는 경우 요청에 지정하는 측정기준 목록에 해당 필터를 추가할 수도 있습니다. 이는 필터가 특정 보고서에서 지원되는 측정기준으로 등록되지 않은 경우에도 마찬가지입니다. 측정기준 목록에 필터를 추가하면 API에서도 필터 값을 사용하여 결과를 그룹화합니다.
이 기능에 관한 자세한 내용은
filters
매개변수 정의를 참고하세요. -
채널 보고서를 가져올 때 이제
ids
매개변수의 값을channel==MINE
로 설정하여 인증된 사용자 채널의 데이터를 검색할 수 있습니다.ids
매개변수를channel==CHANNEL_ID
로 설정하여 지정된 채널의 데이터를 검색할 수도 있습니다. -
이제 API가 재생목록 보고서를 지원합니다. 보고서에는 재생목록과 관련된 동영상 조회수와 관련된 통계가 포함됩니다. 재생목록 보고서는 채널 및 콘텐츠 소유자에게 제공됩니다.
모든 재생목록 보고서는
views
및estimatedMinutesWatched
측정항목을 지원하며 일부 보고서는averageViewDuration
측정항목도 지원합니다.또한 모든 재생목록 보고서는 다음과 같은 새 측정항목을 지원합니다. 이러한 각 측정항목은 웹에서 발생한 재생목록 조회수만 반영합니다.
playlistStarts
: 시청자가 재생목록의 재생을 시작한 횟수입니다.viewsPerPlaylistStart
: 재생목록이 시작될 때마다 발생한 평균 동영상 조회수입니다.averageTimeInPlaylist
: 재생목록이 시작된 후 시청자가 재생목록의 동영상을 시청한 예상 평균 시간(분)입니다.
재생목록 보고서 검색 요청은
isCurated
필터를 사용해야 하며 이 필터는1
(isCurated==1
)로 설정해야 합니다. -
이제 API에서 시청 지속 시간 보고서를 지원합니다. 이 보고서는 동영상의 잠재고객 보유 능력을 측정합니다. 보고서의 새로운
elapsedVideoTimeRatio
측정기준은 해당 측정항목 값에 대해 경과된 동영상의 양을 측정합니다.-
audienceWatchRatio
측정항목은 동영상의 특정 지점에서 동영상을 시청한 시청자의 절대 비율을 확인합니다. 비율은 동영상의 특정 부분을 시청한 횟수를 동영상의 총 조회수와 비교하여 계산합니다.동영상의 일부는 특정 동영상 보기에서 2회 이상 시청하거나 전혀 보지 않을 수 있습니다. 예를 들어 사용자가 동영상의 같은 부분을 여러 번 되감아 보는 경우 해당 부분의 절대 비율은
1
보다 클 수 있습니다. -
relativeRetentionPerformance
측정항목은 동영상 재생 중 시청자 보유율이 비슷한 길이의 모든 YouTube 동영상과 비교하여 표시됩니다. 값이 0인 경우 동영상의 시청자 보유율이 비슷한 길이의 다른 어떤 동영상보다 낮다는 것을 나타내고, 1 값은 동영상이 비슷한 길이의 다른 어떤 동영상보다 시청 지속 시간이 더 높다는 것을 나타냅니다. 중앙값이 0.5이면 길이가 비슷한 동영상 중 절반은 시청 지속 시간이 더 길고 절반은 시청 지속 시간이 더 낮다는 것을 나타냅니다.
또한
audienceType
필터를 사용하여 자연 조회수, TrueView 인스트림 광고에서 발생한 조회수 또는 TrueView 디스플레이 광고의 조회수와 관련된 데이터만 반환하도록 보고서를 설정할 수 있습니다. 자연 조회수는 동영상 검색 또는 추천 동영상 클릭과 같은 사용자 액션의 직접적인 결과입니다. -
-
이 API는 주석과 관련된 여러 가지 새로운 측정항목을 지원합니다. 아래 나열된 측정항목은 이전에
annotationClickThroughRate
및annotationCloseRate
측정항목을 지원했던 모든 보고서에서 가져올 수 있습니다.annotationImpressions
: 총 특수효과 노출수입니다.annotationClickableImpressions
: 표시되어 클릭 가능한 특수효과 수annotationClosableImpressions
: 표시되어 닫을 수 있는 특수효과의 수입니다.annotationClicks
: 클릭된 주석의 총 개수입니다.annotationCloses
: 종료 특수효과의 총 개수입니다.
새로운 측정항목은 모두 핵심 측정항목이며 지원 중단 정책이 적용됩니다. 하지만 2013년 7월 16일부터 새 측정항목에 대한 데이터를 사용할 수 있습니다.
annotationClickThroughRate
및annotationCloseRate
측정항목은 2012년 6월 10일부터 사용할 수 있습니다. -
GOOGLE_SEARCH
는 더 이상insightTrafficSourceType
측정기준에 대한 별도의 값으로 보고되지 않습니다. 대신 Google 검색결과에서 발생한 추천은EXT_URL
트래픽 소스 유형으로 표시됩니다. 따라서insightTrafficSourceType
필터를GOOGLE_SEARCH
로 설정하는insightTrafficSourceDetail
보고서를 더 이상 검색할 수 없습니다. -
이제 콘텐츠 소유자가 소유권을 주장하거나 업로드한 콘텐츠에 대해
subscribersGained
및subscribersLost
측정항목을 가져올 수 있음을 반영하도록 콘텐츠 소유자 보고서 문서가 업데이트되었습니다.변경사항은 콘텐츠 소유자의 첫 번째 기본 통계 보고서에서 확인할 수 있으며 이제
claimedStatus
및uploaderType
필터를 지원합니다. -
채널 및 콘텐츠 소유자 보고서에 최근 출시된 탭 형식과 유사한 탭 형식을 사용하여 샘플 요청 문서가 카테고리별로 그룹화되도록 새롭게 디자인되었습니다. 새 디자인에서 예는 다음 카테고리로 그룹화됩니다.
- 기본 통계
- 시간 기준
- 지역
- 재생 위치
- 트래픽 소스
- 기기/운영체제
- 인구통계
- 소셜
- 수입/광고 (콘텐츠 소유자 보고서 전용)
-
샘플 요청 문서에는 이제 채널 보고서 또는 콘텐츠 소유자 보고서에서 지방별 데이터를 검색하는 새로운 예가 포함됩니다.
-
미국 및 워싱턴 D.C.의 지역별 측정항목 이 보고서는 채널 동영상의 조회수 및 기타 통계를 지방별로 분석한 결과를 가져옵니다. 데이터는 미국과 워싱턴 D.C에 적용됩니다. 이 예에서는
province
측정기준을 사용하며, 미국에 대한 결과만 포함하도록filters
매개변수를 사용하여 응답을 제한합니다. -
캘리포니아 시청자 인구통계(연령대 및 성별): 이 보고서는 캘리포니아에 거주하며 채널의 동영상을 시청한 시청자 또는 콘텐츠 소유자의 소유권 주장이 제기된 콘텐츠(콘텐츠 소유자 보고서인 경우)의 연령대와 성별에 대한 통계를 가져옵니다. 이 예시에서는
filters
매개변수를 사용하여 응답에 특정 지역의 데이터만 포함하도록 합니다.
-
-
dimensions
매개변수 값에province
가 포함된 경우 요청에서filters
매개변수 값에country==US
를 포함하여 데이터를 미국으로 제한해야 한다는 내용을 포함하도록province
측정기준의 정의가 업데이트되었습니다. -
지원되는 채널 및 콘텐츠 소유자 보고서가 나열된 문서의 디자인이 변경되었습니다. 가능한 모든 보고서가 나열된 표를 제공하는 대신 각 문서에서는 보고서를 카테고리로 그룹화합니다.
- 기본 통계
- 시간 기준
- 지역
- 재생 위치
- 트래픽 소스
- 기기/운영체제
- 인구통계
- 소셜
- 인기 동영상
각 문서는 이러한 카테고리를 탭 목록으로 표시하며, 탭을 클릭하면 해당 카테고리에서 지원되는 보고서를 볼 수 있습니다.
-
이제 API는
province
,continent
,subContinent
라는 3가지 새로운 지리적 측정기준을 지원합니다.-
province
측정기준을 사용하면 미국의 주 및 콜롬비아 특별구에 대한 통계를 검색할 수 있습니다. API는 이 측정기준에 대해 두 가지 용도를 지원합니다.-
API는 상태별로 통계를 분석하는 두 가지 보고서를 지원합니다. 두 보고서 모두 채널 및 콘텐츠 소유자에 사용할 수 있습니다.
- 중요 통계 보고서는 조회수, 예상 시청 시간(분)을 비롯한 여러 통계를 제공합니다.
- 시간 기반 보고서도 동일한 통계를 제공하지만 일별, 7일, 30일 또는 월별로 데이터를 집계합니다.
-
filters
쿼리 매개변수를 사용하여 특정 상태에 관한 통계만 포함하도록 보고서를 제한할 수 있습니다. 지역 보고서, 재생 위치 보고서, 트래픽 소스 보고서, 기기 보고서, 운영체제 보고서, 인구통계 보고서, 인기 동영상 보고서 등 여러 보고서에서 이러한 유형의 필터링을 지원합니다.
-
-
continent
측정기준은 대륙을 식별하는 유엔 (UN) 통계 지역 코드를 지정합니다. 이 측정기준은 필터로만 사용할 수 있습니다. -
subContinent
측정기준은 대륙의 하위 지역을 식별하는 UN (UN) 통계 지역 코드를 지정합니다. 이 측정기준은 필터로만 사용할 수 있습니다.각 하위 지역은 하나의 대륙에만 연결되므로
subContinent
필터를 사용할 때는continent
필터도 사용할 필요가 없습니다. (실제로 요청에서 두 측정기준을 모두 사용하면 API가 오류를 반환합니다.)
-
-
insightTrafficSourceDetail
측정기준에 유효한 필터 값으로insightTrafficSourceType
값PROMOTED
이(가) 포함되지 않도록 문서가 수정되었습니다. -
이제 YouTube Analytics API에는 서비스 약관에 설명된 지원 중단 정책이 적용됩니다. 하지만 API의 비핵심 측정기준 및 비핵심 측정항목에는 지원 중단 정책이 적용되지 않습니다. 측정기준 및 metrics 페이지가 핵심 측정기준 및 핵심 측정항목을 포함하도록 업데이트되었습니다. 또한 핵심 측정기준 및 측정항목을 명시적으로 식별할 수 있도록 해당 페이지의 정의가 업데이트되었습니다.
-
이제 API에서
insightPlaybackLocationType
측정기준의 값으로EXTERNAL_APP
를 지원합니다. 이 업데이트와 함께 2013년 9월 10일부터 재생은 더 이상MOBILE
재생으로 분류되지 않지만 이 날짜 이전에 발생한 모바일 재생은 해당 값으로 분류됩니다.이 업데이트를 통해 이제 모바일 재생은 재생이 발생하는 애플리케이션의 유형에 따라
WATCH
,EMBEDDED
또는EXTERNAL_APP
재생으로 분류됩니다. -
이제 API에서
insightTrafficSourceType
측정기준의 값으로PLAYLIST
를 지원합니다. 이 값은 재생목록에서 동영상 조회수를 추천했음을 나타냅니다. 이전에는 이러한 보기가 측정기준의YT_OTHER_PAGE
카테고리를 사용하여 분류되었습니다. -
API는 이제 여러 측정기준 및 측정항목을 기준으로 보고서를 정렬할 수 있는 기능을 지원합니다. 샘플 요청 문서에는 새로운 예인 여러 측정기준/측정항목으로 요청 정렬하기가 포함되어 이 기능을 보여줍니다. 이 요청은 트래픽 소스 데이터를 검색하며
sort
매개변수 값은day,-views
입니다. 결과는 시간순으로 정렬되지만 하루의 결과 집합에서는 첫째 행에 조회수가 제일 높은 트래픽 소스 데이터를 포함하고 둘째 행에 그 다음으로 조회수가 높은 소스의 데이터를 포함하는 등 조회수가 높은 순서로 포함합니다. -
이제 API는 두 가지 새로운 측정기준인
deviceType
와operatingSystem
를 지원합니다. 이 측정기준은 시청자가 동영상을 시청하는 기기에 관한 데이터를 검색하는 데 사용할 수 있습니다. API는 측정 기준 하나를 사용하거나 둘 다 사용하는 보고서를 지원합니다.-
deviceType
보고서를 통해 데스크톱, 휴대기기, 태블릿 기기 등 다양한 유형의 기기에 대한 조회수 및 예상 시청 시간을 검색할 수 있습니다. 또한operatingSystem
필터를 사용하여 특정 운영체제(예: Android 또는 iOS)를 실행하는 기기의 통계만 포함하도록 기기 유형 보고서를 제한할 수도 있습니다. -
operatingSystem
보고서를 사용하면 Android, iOS, Linux 등 다양한 운영체제의 조회수 및 예상 시청 시간을 검색할 수 있습니다. 또한deviceType
필터를 사용하여 휴대기기 또는 태블릿과 같은 특정 기기 유형의 통계만 포함하도록 운영체제 보고서를 제한할 수 있습니다.
-
-
샘플 요청 문서가 업데이트되어 채널에 대한 기기 보고서 3개와 콘텐츠 소유자에 대한 기기 보고서 3개를 포함합니다.
-
insightPlaybackLocationType
측정기준은 측정기준의 다른 값 중 하나를 사용하여 분류되지 않은 조회수를 식별하는 값YT_OTHER
를 반환할 수 있습니다. -
인기 동영상 보고서를 수익의 내림차순으로 정렬하여 수익이 가장 높은 동영상을 파악할 수 있도록 콘텐츠 소유자 보고서 문서가 업데이트되었습니다. 이 보고서는 사용자 활동 및 수익 보고서 섹션에서 두 번째 표의 첫 번째 보고서입니다.
-
YouTube에서는 더 이상 실험용 API 기능과 서비스를 식별하지 않습니다. 대신에 사용 중단 정책에 따라 달라지는 YouTube API 목록을 제공합니다.
-
이제 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
-
-
-
새로운 샘플 API 요청 문서에서는 YouTube Analytics API를 사용하여 다양한 유형의 보고서를 검색하는 방법을 보여주는 예를 제공합니다. 각 예제에는 요청에서 검색하는 보고서에 대한 간단한 설명이 포함되어 있으며 요청에 대한 측정기준, 측정항목, 필터, 정렬 매개변수가 표시됩니다.
-
이제
insightTrafficSourceType
측정기준은SUBSCRIBER
를 유효한 값으로 지원합니다. 이 값은 YouTube 홈페이지의 피드 또는 YouTube 구독 기능에서 추천된 동영상 조회수를 식별합니다. 이 트래픽 소스를 기준으로 필터링하면insightTrafficSourceDetail
입력란에 조회수가 발생한 홈페이지 피드 또는 다른 페이지가 지정됩니다. -
이제 API는 동영상 중에 표시되는 특수효과와 시청자 상호작용과 관련된 두 가지 새로운 측정항목
annotationClickThroughRate
및annotationCloseRate
를 지원합니다. 채널 보고서 및 콘텐츠 소유자 보고서 목록이 모두 업데이트되어 새 측정항목을 지원하는 보고서를 확인할 수 있습니다.annotationClickThroughRate
– 클릭 가능한 특수효과 총 노출수에 대한 시청자가 클릭한 특수효과의 비율입니다.annotationCloseRate
– 전체 특수효과 노출수에 대한 시청자가 닫은 특수효과의 비율입니다.
-
이제 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 문서가 재구성되어 서로 다른 유형의 보고서에 대한 설명이 별도의 페이지에 나와 있습니다. 따라서 이제 다른 유형의 채널 보고서 및 콘텐츠 소유자 보고서를 설명하는 별도의 페이지가 있습니다.
-
API 참조 가이드에는 이제 예 섹션이 있습니다. 이 섹션에는 Java, JavaScript, Python, Ruby 클라이언트 라이브러리를 사용하여 API를 호출하는 방법을 보여주는 코드 샘플이 포함되어 있습니다. 자바스크립트 코드 샘플은 샘플 애플리케이션 문서에 자세히 설명된 코드와 동일합니다.
-
이제 API 참조 가이드에는 응답에서 API를 호출하고 API 요청을 확인하며 실제 데이터를 검색할 수 있게 해 주는 APIs Explorer가 포함되어 있습니다.
-
API는 채널 및 콘텐츠 소유자 모두에 대해 아래에 설명된 여러 새 보고서를 지원합니다. 각 보고서를 채널 보고서 또는 콘텐츠 소유자 보고서로 사용할 수 있습니다. 이에 따라 측정기준 및 metrics 페이지도 업데이트되었습니다.
-
재생 위치 보고서는 다른 유형의 페이지 또는 애플리케이션에서 발생한 동영상 조회수를 지정합니다.
-
재생 위치 세부정보 보고서는 지정된 동영상의 조회수가 가장 많이 발생한 내장 플레이어를 확인합니다. 이 보고서에서는 최상위 내장 플레이어와 연결된 URL을 식별하여 재생 위치 보고서보다 더 자세하게 볼 수 있습니다.
-
트래픽 소스 보고서는 다른 종류의 리퍼러에서 발생한 동영상 조회수를 확인합니다.
-
트래픽 소스 세부정보 보고서는 지정된 동영상 및 지정된 트래픽 소스 유형에 대한 조회수가 가장 많이 발생한 리퍼러를 확인합니다. 예를 들어 이 보고서를 통해 특정 동영상으로 가장 많은 트래픽을 보낸 관련 동영상을 확인할 수 있습니다. 여러 가지 트래픽 소스에 대해 지원되는 보고서입니다.
-
시청 시간 보고서는 시청자가 내 콘텐츠를 시청한 시간을 제공합니다. 보고서에서는 일, 이전 7일, 이전 30일 등 특정 기간 또는 국가 데이터를 집계할 수 있습니다. 보고서에서 기간 또는 국가로 데이터를 집계한 경우 사용자가 시청한 각 동영상의 평균 비율과 각 동영상 조회의 평균 시간도 지정할 수 있습니다.
-
-
이제 모든 개발자가 YouTube Analytics API를 사용할 수 있습니다. 먼저 액세스를 요청할 필요 없이 APIs console의 서비스 패널에서 프로젝트의 API를 활성화할 수 있습니다.
-
새로운 시작하기 섹션에서는 YouTube Analytics API를 사용하는 애플리케이션을 빌드하기 위한 기본 요건과 기본 단계를 간략히 설명합니다.
-
새로운 할당량 사용 이해하기 섹션에서는 API 할당량 사용을 최적화하기 위한 가이드라인을 제공합니다. API 서버는 각 요청에 대한 쿼리 비용을 계산하고 API 사용 할당량에서 해당 비용을 차감합니다. 보고서 유형에 따라 쿼리 비용이 크게 차이가 날 수 있으므로 할당량을 효율적으로 사용하도록 계획하고 애플리케이션에서 실제로 필요한 측정항목과 데이터만 사용해야 합니다.
-
일시적 측정기준 섹션이 업데이트되어 이 측정기준이 애널리틱스 보고서에서 기간을 기준으로 데이터를 집계해야 함을 설명합니다. 이제 API는 다음과 같은 일시적 측정기준을 추가로 지원합니다.
7DayTotals
– 보고서의 데이터가 집계되어 각 행에 7일 간의 데이터가 포함됩니다.30DayTotals
– 보고서의 데이터가 집계되어 각 행에 30일 간의 데이터가 포함됩니다.month
– 보고서의 데이터는 월별로 집계됩니다.
사용 가능한 보고서 섹션도 마찬가지로 업데이트되어 일시적 측정기준을 사용하는 보고서에 대한 API의 지원을 설명합니다.
-
콘텐츠 소유자 보고서를 검색하는 API 요청은 이러한 측정기준 (
video
,channel
,show
) 중 하나 또는 지원되는claimedStatus
및uploaderType
측정기준의 조합을 사용하여 데이터를 필터링해야 한다는 내용을 포함하도록 보고 항목 측정기준 섹션이 업데이트되었습니다. -
이제 API는 인기 동영상 보고서에 두 가지 새로운 정렬 옵션을 지원합니다. 채널 보고서 또는 콘텐츠 소유자 보고서로 제공되는 이 보고서는 국가별 측정항목 (조회수, 댓글, 좋아요 등)을 포함하고 있으며 동영상별로 측정항목을 분류합니다. 또한 동영상 보기 페이지의 채널에 구독하거나 구독하지 않은 사용자 수를 기준으로 보고서를 정렬할 수 있습니다.
-
subscribersGained
및subscribersLost
metrics의 정의가 업데이트되어 동영상 보기 페이지, 채널 페이지, YouTube 홈페이지에 표시되는 가이드 등 여러 위치에서 채널이 구독자를 얻거나 잃을 수 있음을 설명합니다. 동영상 전용 보고서에 이러한 측정항목이 표시될 경우에는 지정한 동영상의 보기 페이지에 대한 측정항목만 포함됩니다.
YouTube Reporting API는 3가지 새로운 최종 화면 보고서와 이러한 보고서의 새로운 측정기준 및 측정항목을 지원합니다. 이 보고서에서는 동영상 재생이 중지된 후 표시되는 최종 화면의 노출수 및 클릭연결 통계를 제공합니다.
동영상에 최종 화면을 추가하는 방법에 대한 자세한 내용은 YouTube 고객센터를 참조하세요.
2016년 11월 8일
이번 업데이트에는 YouTube Analytics API가 다음과 같이 변경되었습니다.
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 변경사항이 포함되어 있습니다.
2016년 8월 11일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2016년 8월 10일
이 업데이트에는 다음과 같은 변경사항이 포함되어 있습니다.
2016년 7월 18일
이 업데이트에는 다음과 같은 변경사항이 포함되어 있습니다.
2016년 6월 28일
여러 채널 및 콘텐츠 소유자 보고서에서 카드 측정항목에 대한 지원을 반영하도록 YouTube Analytics API 문서가 업데이트되었습니다. 새로 지원되는 측정항목은 다음과 같습니다.
측정항목은 다음 유형의 보고서에서 지원됩니다.
2016년 6월 22일
이 업데이트에는 다음과 같은 YouTube Reporting API 변경사항이 포함되어 있습니다. 첫 번째 변경사항은 일반적으로 API와 관련이 있으며 나머지 변경사항은 콘텐츠 소유자 보고서에만 영향을 미칩니다.
2016년 5월 19일
이 업데이트에는 다음과 같은 YouTube Reporting API 변경사항이 포함되어 있습니다.
2016년 4월 12일
이 업데이트에는 다음과 같은 변경사항이 포함되며 모든 변경사항은 YouTube Reporting API에만 영향을 미칩니다.
2016년 3월 28일
이제 YouTube Reporting API 및 YouTube Analytics API에서 여러 추가 공유 서비스에 대한 조회 통계를 반환합니다.
2016년 3월 16일
이 업데이트에는 YouTube Reporting API 및 YouTube Analytics API 모두에 영향을 미치는 다음과 같은 변경사항이 포함되어 있습니다.
YouTube 보고 API
YouTube 분석 API
2016년 2월 8일
YouTube Analytics API에서 지원되는 측정항목 목록이 업데이트되어 카드 측정항목이 더 이상 해당 API에서 지원되는 측정항목으로 표시되지 않습니다. (해당 API의 어떤 보고서도 카드 측정항목을 지원하는 것으로 기록되지 않았습니다.)
여러 채널 및 콘텐츠 소유자 보고서에서 이러한 측정항목을 지원하는 YouTube Reporting API를 사용하여 여전히 카드 측정항목을 검색할 수 있다는 점에 유의하세요.
2016년 1월 6일
이제 YouTube Reporting API와 YouTube Analytics API가 Chromecast 기기를 통해 발생하는 조회수를 구체적으로 식별합니다.
2015년 12월 21일
문서에서 annotation_clickable_impressions
및 annotation_closable_impressions
측정항목의 이름이 보고서에 반환되는 이름과 일치하도록 업데이트되었습니다. 이전에는 이름이 clickable_annotation_impressions
및 closable_annotation_impressions
로 문서화되었습니다.
2015년 12월 18일
유럽연합 (EU) 법규에 따라 EU의 최종 사용자에게 특정 정보를 공개하고 사용자의 동의를 얻어야 합니다. 따라서 유럽 연합의 최종 사용자에게는 EU 사용자 동의 정책을 준수해야 합니다. YouTube API 서비스 약관에 이 요건에 관한 알림을 추가했습니다.
2015년 12월 15일
이 업데이트에는 다음과 같은 변경사항이 포함되며 모두 YouTube Analytics API에 영향을 미칩니다.
2015년 11월 10일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2015년 10월 29일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2015년 10월 8일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2015년 9월 24일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2015년 8월 20일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2015년 7월 22일
이번 업데이트에는 몇 가지 변경사항이 포함되어 있으며, 모든 변경사항은 콘텐츠 소유자에게만 적용됩니다.
2015년 6월 1일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2015년 3월 31일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2015년 3월 16일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2015년 2월 25일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2015년 2월 13일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2014년 8월 28일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2014년 7월 16일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2014년 1월 31일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2014년 1월 16일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2014년 1월 6일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2013년 9월 30일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2013년 7월 16일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2013년 5월 23일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2013년 5월 10일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2013년 5월 6일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2013년 5월 3일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2013년 3월 28일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2013년 3월 21일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2013년 2월 4일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2012년 11월 14일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2012년 10월 2일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.
2012년 9월 12일
이번 업데이트에서 이루어진 변경내용은 다음과 같습니다.