샘플 API 요청

동영상 보고서

채널 동영상의 일별 시청 시간 측정항목

이 쿼리는 채널 동영상의 일일 조회수, 시청 시간 측정항목, 새 구독자 수를 검색합니다. 보고서는 요청된 기간의 각 날짜에 대해 데이터 한 행을 반환합니다. 행은 시간순으로 정렬됩니다.

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

채널 동영상의 일별 특수효과 측정항목

이 요청은 채널 콘텐츠의 일일 조회수, 특수효과 클릭률, 특수효과 닫기 비율, 특수효과 노출수를 검색합니다. 시간순으로 정렬됩니다.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

재생목록 보고서

채널의 일일 재생목록 조회수

이 요청은 인증된 사용자 채널의 일일 조회수(집계된 동영상 측정항목), 재생목록 조회수(재생목록 내 측정항목), 재생목록 시작 횟수, 예상 시청 시간(분) 및 재생목록 시작당 조회수를 검색합니다. 시간순으로 정렬됩니다.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

동영상 보고서

채널 동영상의 국가별 시청 시간 측정항목

이 쿼리는 채널 동영상의 국가별 조회수, 시청 시간 측정항목, 구독자 수를 가져옵니다. 이 보고서는 채널의 동영상이 시청된 국가마다 데이터 행 하나를 반환합니다. 시청한 시간(분)의 내림차순으로 행이 정렬됩니다.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

채널 동영상의 국가별 특수효과 통게

이 요청은 채널 동영상의 국가별 조회수, 특수효과 클릭률, 특수효과 닫기 비율, 특수효과 노출수를 검색합니다. 결과는 특수효과 클릭률을 기준으로 내림차순으로 정렬되어 가장 높은 특수효과 클릭률이 첫 번째로 나열됩니다.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

미국 주 및 워싱턴 D.C.의 도별 측정항목

이 요청은 채널 동영상의 조회수, 예상 시청 시간, 평균 시청 지속 시간을 지역별로 분류하여 가져옵니다. 이 데이터는 미국 주와 워싱턴 D.C.를 대상으로 합니다. 결과는 도 ISO 3166-2 코드별로 알파벳순으로 정렬됩니다.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

상위 10개 – 특정 국가에서 최다 조회 동영상

이 쿼리는 지정된 국가에서 지정된 기간 동안의 조회수를 기준으로 채널의 가장 많이 시청된 동영상 10개를 가져옵니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다.

참고: 이 보고서에서는 sort 요청 매개변수의 값을 지정하고 maxResults 매개변수를 10 이하의 정수 값으로 설정해야 합니다.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

총 조회수 기준 미국 내 인기 도시 10곳

이 쿼리는 지정된 기간 동안 채널 콘텐츠의 조회수가 가장 많은 미국 도시 10곳의 목록을 가져옵니다. 해당 필터의 유효한 다른 값을 선택하여 다른 국가의 데이터를 요청하도록 쿼리를 수정할 수 있습니다. 마찬가지로 subContinent 필터와 유효한 값 중 하나를 사용하여 서유럽 또는 동남아시아와 같은 아대륙의 데이터를 검색하도록 쿼리를 수정할 수 있습니다. 다른 필터도 지원됩니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다.

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

콘텐츠 유형별 총 조회수 기준 상위 10개 미국 도시

이 쿼리는 지원되는 각 creatorContentType에 대해 지정된 기간 동안 채널 콘텐츠의 조회수가 가장 많은 미국 도시 10곳의 목록을 가져옵니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다.

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

총 시청 시간 기준 미국 내 상위 10개 도시

이 쿼리는 지정된 기간 동안 미국 도시 중 채널 콘텐츠의 일일 총 시청 시간이 가장 많은 상위 10일의 목록을 가져옵니다. 쿼리 결과는 총 시청 시간, 시청 시간이 발생한 날짜, 콘텐츠가 시청된 것으로 추정되는 도시를 식별합니다. 결과는 총 시청 시간의 내림차순으로 정렬됩니다.

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

인기 급상승 – 유럽에서 가장 많이 본 동영상

이 쿼리는 지정된 기간 동안의 조회수로 측정된 유럽에서 채널의 최다 조회 동영상 상위 10개를 검색합니다. 해당 필터에 유효한 다른 값을 선택하여 다른 대륙의 데이터를 요청하도록 쿼리를 수정할 수 있습니다. 마찬가지로 subContinent 필터와 유효한 값 중 하나를 사용하여 서유럽 또는 동남아시아와 같은 아대륙의 데이터를 검색하도록 쿼리를 수정할 수 있습니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다.

참고: 이 보고서를 사용하려면 sort 요청 매개변수의 값을 지정하고 maxResults 매개변수를 10 이하의 정수 값으로 설정해야 합니다.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

재생목록 보고서

채널 재생목록의 국가별 시청 시간 측정항목

이 쿼리는 국가별 조회수(집계된 동영상 측정항목), 재생목록 조회수(재생목록 내 측정항목), 채널 재생목록의 시청 시간 측정항목을 가져옵니다. 이 보고서는 채널의 재생목록을 시청한 각 국가에 대해 데이터 한 행을 반환합니다. 시청한 시간(분)의 내림차순으로 행이 정렬됩니다.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

인기 급상승 – 미국에서 가장 많이 시작한 재생목록 10개

이 쿼리는 지정된 기간 동안 미국의 시청자가 가장 자주 시청하기 시작한 재생목록 10개를 검색합니다. 결과는 재생목록 시작 횟수별로 내림차순으로 정렬됩니다.

참고: 이 보고서는 playlist 측정기준을 사용하므로 sort 요청 매개변수의 값을 지정하고 maxResults 매개변수를 10 이하의 정수 값으로 설정해야 합니다.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

동영상 보고서

다른 재생 위치의 조회수 및 시청 시간

이 쿼리는 특정 채널 동영상의 조회수와 예상 시청 시간을 검색합니다. 결과는 동영상 재생이 발생한 페이지 또는 애플리케이션의 유형을 기준으로 집계되며 조회수를 기준으로 내림차순으로 정렬됩니다.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

다양한 재생 위치의 일일 조회수 및 시청 시간

이 쿼리는 특정 채널 동영상에 대한 미국에서의 일일 조회수와 예상 시청 시간을 검색합니다. 결과는 동영상이 재생되는 페이지 또는 애플리케이션의 각 유형에 대해 일별로 그룹화됩니다. 시간순으로 정렬됩니다.

    dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

상위 10개 – 삽입된 동영상에 대한 조회수가 가장 많이 발생한 타사 사이트

이 쿼리는 특정 동영상 또는 동영상 그룹의 조회수와 예상 시청 시간을 가져옵니다. 결과는 동영상이 삽입된 서드 파티 사이트별로 그룹화됩니다. 결과는 조회수 기준으로 내림차순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 VIDEO_ID 문자열을 업로드한 동영상의 동영상 ID 1개 이상으로 구성된 쉼표로 구분된 목록으로 바꿔야 합니다.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

재생목록 보고서

재생 위치별 재생목록 조회수 및 시청 시간

이 쿼리는 조회수(집계된 동영상 측정항목), 재생목록 조회수(재생목록 내 측정항목), 예상 시청 시간, 특정 채널의 재생목록에 대한 재생목록 시작 횟수를 가져옵니다. 결과는 동영상 재생이 발생한 페이지 또는 애플리케이션 유형에 따라 집계되며 재생목록 시작 횟수에 따라 내림차순으로 정렬됩니다.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

다양한 재생 위치의 일일 재생목록 조회수 및 시청 시간

이 쿼리는 특정 채널의 재생목록에 대한 미국의 일일 재생목록 시작 횟수, 조회수(집계된 동영상 측정항목), 재생목록 조회수(재생목록 내 측정항목), 예상 시청 시간을 가져옵니다. 결과는 재생목록 조회가 발생한 페이지 또는 애플리케이션 유형별로 일별로 그룹화됩니다. 결과는 시간순으로 정렬됩니다.

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day

동영상 보고서

콘텐츠 유형별 좋아요 및 싫어요

이 쿼리는 채널의 콘텐츠 유형별 좋아요 수와 싫어요 수를 가져옵니다.

dimensions=creatorContentType
metrics=likes,dislikes

동영상 보고서

한 국가 내 다른 트래픽 소스의 조회수 및 시청 시간

이 요청은 지정된 국가에서 채널 동영상의 조회수와 예상 시청 시간을 검색합니다. 이 측정항목은 사용자가 동영상을 어떤 경로로 보게 되는지 알려주는 트래픽 소스에서 집계됩니다.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

다양한 트래픽 소스의 일일 조회수 및 시청 시간

이 요청은 채널 동영상의 일일 조회수와 일별 예상 시청 시간을 검색합니다. 이 측정항목은 트래픽 소스에서 매일 집계되며 시간순으로 정렬됩니다.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

상위 10개 – 동영상에 가장 많은 트래픽을 만드는 YouTube 검색어

이 쿼리는 하나 이상의 특정 동영상에 대한 YouTube 검색 결과에서 가장 많은 조회수를 생성한 검색어 10개를 검색합니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 문자열 VIDEO_ID를 최대 500개의 동영상 ID로 구성된 쉼표로 구분된 목록으로 바꿔야 합니다.

예를 들어 단일 동영상에 대해 쿼리를 실행하거나 VIDEO_ID를 대체하여 해당 동영상에 가장 많은 트래픽을 유도하는 검색어를 파악할 수 있습니다. 특정 재생목록의 모든 동영상을 나열하여 재생목록의 동영상에서 가장 많은 트래픽을 발생시키는 검색어를 확인할 수도 있습니다.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

상위 10개 – 동영상에서 가장 많은 트래픽을 발생시킨 외부 웹사이트

이 쿼리는 특정 동영상 또는 동영상 그룹에서 가장 많은 조회수를 발생시킨 외부 웹사이트 10개를 가져옵니다. 결과는 예상 시청 시간별로 내림차순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 VIDEO_ID 문자열을 업로드된 동영상의 동영상 ID 최대 500개를 쉼표로 구분한 목록으로 바꿔야 합니다.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

재생목록 보고서

국가의 여러 트래픽 소스에서 발생한 재생목록 조회수 및 시청 시간

이 요청은 지정된 국가의 조회수(집계된 동영상 측정항목), 재생목록 조회수(재생목록 내 측정항목), 재생목록 시작 횟수, 재생목록 조회수의 예상 시청 시간을 가져옵니다. 측정항목은 사용자가 재생목록에 도달한 방식을 설명하는 트래픽 소스별로 집계됩니다.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

다양한 트래픽 소스의 일일 재생목록 조회수 및 시청 시간

이 요청은 채널의 일일 재생목록 조회수 (재생목록 내 측정항목), 재생목록 시작 횟수, 예상 시청 시간을 검색합니다. 또한 총 조회수 (집계된 동영상 측정항목)도 검색합니다. 이 측정항목은 트래픽 소스에서 매일 집계되며 시간순으로 정렬됩니다.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

동영상 보고서

Android 운영체제의 일별 기기 유형 측정항목

이 쿼리는 특정 채널의 동영상에 대한 Android 기기의 일일 조회수 및 예상 시청 시간을 가져옵니다. 결과는 동영상이 재생되는 기기 유형별로 일별로 그룹화됩니다. 시간순으로 정렬됩니다.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

모바일 기기의 일별 운영체제 측정항목

이 쿼리는 특정 채널의 동영상에 대한 휴대기기의 일일 조회수 및 예상 시청 시간을 가져옵니다. 결과는 동영상 재생이 발생한 각 운영체제별로 일별로 그룹화됩니다. 시간순으로 정렬됩니다.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

일별 운영체제 및 기기 유형 측정항목

이 쿼리는 채널의 일일 조회수와 예상 시청 시간을 검색합니다. 통계는 운영체제 및 기기 유형별로 그룹화됩니다. 시간순으로 정렬됩니다.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

재생목록 보고서

Android 운영체제의 재생목록 조회수에 대한 일일 기기 유형 측정항목

이 쿼리는 특정 채널의 재생목록에 대한 Android 기기의 일일 조회수 (집계된 동영상 측정항목), 재생목록 조회수 (재생목록 내 측정항목), 예상 시청 시간을 검색합니다. 재생목록 조회가 발생한 기기 유형별로 일별로 그룹화된 결과가 표시됩니다. 시간순으로 정렬됩니다.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

휴대기기의 재생목록 조회수에 대한 일별 운영체제 측정항목

이 쿼리는 특정 채널 재생목록의 일일 조회수 (집계된 동영상 측정항목), 재생목록 조회수 (재생목록 내 측정항목), 휴대기기에서의 예상 시청 시간을 검색합니다. 결과는 재생목록 조회수가 발생한 각 운영체제의 일별로 그룹화됩니다. 시간순으로 정렬됩니다.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day

동영상 보고서

캘리포니아의 시청자 인구통계(연령대 및 성별)

이 보고서는 캘리포니아에서 채널의 동영상을 본 시청자의 연령대 및 성별에 대한 통계를 검색합니다. 결과는 성별을 기준으로 정렬된 후 연령대별로 정렬됩니다. 이 쿼리는 filters 매개변수 값을 조정하여 전 세계 모든 시청자 또는 국가, 대륙, 아대륙, 다른 미국 주에 거주하는 모든 시청자에 대해 동일한 통계를 가져오도록 수정할 수 있습니다.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

재생목록 보고서

캘리포니아의 재생목록 시청자 인구통계 (연령대 및 성별)

이 보고서는 캘리포니아에서 채널의 재생목록을 시청한 연령 그룹 및 성별에 대한 통계를 검색합니다. 결과는 성별을 기준으로 정렬된 후 연령대별로 정렬됩니다. filters 매개변수 값을 조정하여 전 세계 모든 뷰어 또는 국가, 대륙, 아대륙 또는 다른 미국 주의 모든 뷰어에 대해 동일한 통계를 가져오도록 이 쿼리를 수정할 수 있습니다.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

동영상이 공유된 서비스에서 집계한 공유 측정항목

이 요청은 사용자가 Share 버튼을 사용하여 채널의 동영상을 공유한 횟수를 가져옵니다. 결과는 공유 서비스(Google+, Twitter 등)에서 집계되며 공유 횟수를 내림차순으로 정렬합니다.

dimensions=sharingService
metrics=shares
sort=-shares

동영상의 시청 지속 시간 측정항목

이 보고서는 동영상이 시청자의 관심을 얼마나 끌고 있는지를 측정합니다. 보고서는 한 번에 하나의 동영상에 대해서만 검색할 수 있습니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 VIDEO_ID 문자열을 업로드한 동영상 중 하나의 동영상 ID로 바꿔야 합니다. 시청 지속 시간 보고서에서는 video 필터에 여러 값을 지정하는 기능을 지원하지 않습니다.

이 예에서는 보고서가 audienceType 필터를 사용하여 동영상 검색 또는 추천 동영상 클릭과 같은 직접적인 사용자 작업의 결과인 자연 조회 데이터만 포함되도록 응답을 제한합니다. 따라서 보고서에는 TrueView 인스트림 광고 또는 TrueView 인디스플레이 광고에서 발생한 조회수 데이터가 포함되지 않습니다. 필터를 삭제하여 모든 잠재고객 유형에서 동영상의 시청 지속 시간 데이터를 가져올 수 있습니다.

audienceType 필터의 데이터는 2013년 9월 25일부터 사용할 수 있습니다. API는 필터를 사용하여 이전 날짜의 데이터를 검색하려는 쿼리의 데이터를 반환하지 않습니다. 필터를 사용하지 않는 쿼리는 2008년 7월 1일 이후의 날짜에 작동합니다.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

채널 수익 및 광고 실적 측정항목

이 요청은 채널의 수익 및 광고 실적 측정항목을 가져옵니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

일일 수익 및 광고 실적 측정항목

이 요청은 채널의 일일 수익 및 광고 실적 측정항목을 가져옵니다.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

국가별 수익 및 광고 실적 측정항목

이 요청은 채널의 국가별 수익 및 광고 실적 측정항목을 검색합니다. 결과는 수익 금액을 기준으로 내림차순으로 정렬됩니다. 즉, 표시되는 첫 번째 국가는 파트너의 순수익이 가장 큰 국가입니다.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

상위 10개 – 수익이 가장 높은 동영상

이 요청은 채널에서 수익이 가장 많은 10개의 동영상에 대한 수익 및 광고 실적 측정항목을 가져옵니다. 결과는 수익 금액을 기준으로 내림차순으로 정렬되므로 예상 수익이 가장 높은 동영상이 첫 번째 동영상입니다.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

다른 광고 유형의 광고 실적 측정항목

이 요청은 콘텐츠 소유자가 소유권을 주장한 콘텐츠의 광고 실적 측정항목을 가져옵니다. 결과는 광고 유형별로 그룹화되므로 여러 광고 유형 간의 수익 및 CPM 값을 비교할 수 있습니다.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

동영상 보고서

직접 업로드한 콘텐츠에 대한 일별 시청 시간 측정항목

이 쿼리는 콘텐츠 소유자가 업로드한 동영상의 일일 시청 시간 측정항목과 조회수, 수익 창출 재생수, 노출수를 가져옵니다. 이 보고서는 요청한 데이터 범위에서 하루에 데이터 한 행을 반환하며 행은 시간순으로 정렬됩니다.

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

소유권이 주장된 콘텐츠에 대한 특수효과 측정항목

이 요청은 콘텐츠 소유자가 소유권을 주장한 콘텐츠의 일일 조회수, 특수효과 클릭률, 특수효과 닫기 비율, 특수효과 노출수를 검색합니다. 시간순으로 정렬됩니다.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

재생목록 보고서

콘텐츠 소유자의 일일 재생목록 조회수

이 요청은 콘텐츠 소유자의 재생목록에 있는 동영상과 관련된 일일 사용자 상호작용에 대한 측정항목을 가져옵니다. 보고서에서 가져온 측정항목은 playlistViews, playlistStarts, playlistEstimatedMinutesWatched, viewsPerPlaylistStart입니다. 이러한 측정항목은 모두 재생목록 내 측정항목입니다. 요청된 모든 측정항목이 재생목록 내 측정항목이므로 요청에 재생목록 또는 그룹 필터를 포함할 필요가 없습니다.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

동영상 보고서

직접 업로드한 콘텐츠에 대한 국가별 시청 시간 측정항목

이 쿼리는 각 국가의 조회수, 시청 시간 측정항목, 예상 광고 수익을 가져옵니다. 측정항목은 콘텐츠 소유자가 업로드한 동영상에 대한 것입니다. 이 보고서는 동영상이 시청된 각 국가에 대한 데이터 한 행을 반환하며 행은 시청한 시간(분)을 기준으로 내림차순으로 정렬됩니다.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

직접 업로드한 콘텐츠에 대한 국가별 특수효과 측정항목

이 요청은 콘텐츠 소유자가 업로드한 동영상의 국가별 조회수, 주석 클릭률, 주석 닫기 비율, 주석 노출수를 가져옵니다. 결과는 특수효과 클릭률을 기준으로 내림차순으로 정렬되어 가장 높은 특수효과 클릭률이 첫 번째로 나열됩니다.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

미국 주 및 워싱턴 D.C.의 도별 측정항목

이 요청은 콘텐츠 소유자의 소유권 주장이 제기된 동영상의 조회수, 예상 시청 시간(분), 평균 시청 지속 시간(분)을 지역별로 분류하여 검색합니다. 데이터는 미국 주와 워싱턴 D.C를 포함합니다. 결과는 각 주의 ISO 3166-2 코드에 따라 알파벳순으로 정렬됩니다.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

총 조회수 기준 미국 내 인기 도시 10곳

이 쿼리는 지정된 기간 동안 콘텐츠 소유자의 소유권 주장이 제기된 동영상의 조회수가 가장 많은 미국 도시 10곳의 목록을 가져옵니다. 해당 필터의 유효한 다른 값을 선택하여 다른 국가의 데이터를 요청하도록 쿼리를 수정할 수 있습니다. 마찬가지로 subContinent 필터와 유효한 값 중 하나를 사용하여 서유럽 또는 동남아시아와 같은 아대륙의 데이터를 검색하도록 쿼리를 수정할 수 있습니다. 다른 필터도 지원됩니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다.

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

콘텐츠 유형별 총 조회수 기준 미국 내 상위 10개 도시

이 쿼리는 지원되는 각 creatorContentType에 대해 지정된 기간 동안 콘텐츠 소유자의 소유권 주장이 제기된 콘텐츠의 조회수가 가장 많은 미국 도시 10곳의 목록을 가져옵니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다.

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

총 시청 시간 기준 미국 내 상위 10개 도시

이 쿼리는 지정된 기간 동안 미국 도시 중 콘텐츠 소유자의 소유권 주장이 제기된 콘텐츠의 일일 총 시청 시간이 가장 많은 상위 10일의 목록을 가져옵니다. 쿼리 결과에는 총 시청 시간, 시청 시간이 발생한 날짜, 콘텐츠가 시청된 것으로 추정되는 도시가 표시됩니다. 결과는 총 시청 시간을 기준으로 내림차순으로 정렬됩니다.

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

인기 급상승 – 유럽에서 가장 많이 본 동영상

이 쿼리는 콘텐츠 소유자가 소유권을 주장한 동영상 중에서 지정된 기간 동안 조회수로 측정한 유럽에서 가장 많이 시청된 동영상 10개를 가져옵니다. 해당 필터의 유효한 다른 값을 선택하여 다른 대륙의 데이터를 요청하도록 쿼리를 수정할 수 있습니다. 마찬가지로 subContinent 필터와 유효한 값 중 하나를 사용하여 서유럽 또는 동남아시아와 같은 아대륙의 데이터를 검색하도록 쿼리를 수정할 수 있습니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

재생목록 보고서

콘텐츠 소유자의 재생목록에 대한 국가별 시청 시간 측정항목

이 쿼리는 콘텐츠 소유자의 채널에 있는 모든 재생목록의 국가별 재생목록 조회수 및 재생목록 시청 시간 측정항목을 가져옵니다. 이 보고서는 재생목록이 시청된 국가마다 데이터 행 하나를 반환합니다. 행은 시청 시간의 내림차순으로 정렬됩니다.

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

인기 급상승 – 미국에서 가장 많이 시작한 재생목록 10개

이 쿼리는 콘텐츠 소유자 채널에서 미국 시청자가 지정된 기간 동안 가장 자주 시청하기 시작한 재생목록 10개를 검색합니다. 결과는 재생목록 시작 횟수에 따라 내림차순으로 정렬됩니다.

참고: 이 보고서에서는 playlist 측정기준을 사용하므로 sort 요청 매개변수의 값을 지정하고 maxResults 매개변수를 10 이하의 정수 값으로 설정해야 합니다.

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

동영상 보고서

콘텐츠 유형별 좋아요 및 싫어요

이 쿼리는 특정 채널 또는 채널 그룹의 콘텐츠 유형별로 좋아요 및 싫어요 수를 검색합니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 CHANNEL_ID 문자열을 채널의 채널 ID 최대 500개를 쉼표로 구분한 목록으로 바꿔야 합니다.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

동영상 보고서

다른 재생 위치의 조회수 및 시청 시간

이 쿼리는 특정 채널 또는 채널 그룹에 업로드된 동영상의 조회수와 예상 시청 시간을 검색합니다. 결과는 동영상이 재생되는 페이지 또는 애플리케이션 유형에 따라 집계되며 조회수를 기준으로 내림차순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 CHANNEL_ID 문자열을 채널의 채널 ID를 쉼표로 구분하여 최대 500개까지 나열한 목록으로 바꿔야 합니다.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

다양한 재생 위치의 일일 조회수 및 시청 시간

이 쿼리는 특정 채널 또는 채널 그룹에 업로드된 동영상의 미국 일일 조회수 및 예상 시청 시간을 가져옵니다. 결과는 동영상이 재생되는 페이지 또는 애플리케이션의 각 유형에 대해 일별로 그룹화됩니다. 시간 역순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 CHANNEL_ID 문자열을 채널의 채널 ID를 쉼표로 구분하여 최대 500개까지 나열한 목록으로 바꿔야 합니다.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

상위 10개 – 삽입된 동영상에 대한 조회수가 가장 많이 발생한 타사 사이트

이 쿼리는 특정 동영상 또는 동영상 그룹의 조회수와 예상 시청 시간을 검색합니다. 결과는 동영상이 삽입된 서드 파티 사이트를 기준으로 그룹화됩니다. 결과는 조회수 기준으로 내림차순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 VIDEO_ID 문자열을 업로드된 동영상의 동영상 ID를 쉼표로 구분하여 최대 500개까지 나열한 목록으로 바꿔야 합니다.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

재생목록 보고서

재생 위치별 재생목록 조회수 및 시청 시간

이 쿼리는 콘텐츠 소유자의 채널에 있는 모든 재생목록의 재생목록 조회수, 재생목록 예상 시청 시간, 재생목록 시작 횟수를 가져옵니다. 결과는 동영상 재생이 발생한 페이지 또는 애플리케이션 유형에 따라 집계되고 재생목록이 재생될 때 내림차순으로 정렬됩니다.

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

재생 위치별 재생목록 조회수 및 시청 시간

이 쿼리는 콘텐츠 소유자의 채널에 있는 모든 재생목록의 미국 내 일일 재생목록 시작 횟수, 재생목록 조회수, 재생목록 예상 시청 시간을 가져옵니다. 재생목록 조회가 발생한 각 페이지 또는 애플리케이션 유형에 대한 결과가 반환됩니다.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

동영상 보고서

다른 트래픽 소스의 조회수 및 시청 시간

이 요청은 콘텐츠 소유자의 동영상 조회수 및 예상 시청 시간을 가져옵니다. 이 측정항목은 사용자가 동영상을 어떤 경로로 보게 되는지 알려주는 트래픽 소스에서 집계됩니다.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

다양한 트래픽 소스의 일일 조회수 및 시청 시간

이 요청은 콘텐츠 소유자의 동영상에 대한 일일 조회수 및 일일 예상 시청 시간을 가져옵니다. 이 측정항목은 트래픽 소스에서 매일 집계되며 역시간순으로 최근 항목부터 정렬됩니다.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

참고: 다음 두 가지 샘플 보고서는 특정 트래픽 소스에만 지원됩니다. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES, NO_LINK_EMBEDDED 트래픽 소스는 지원되지 않는 소스 중 일부입니다.

상위 10개 – 동영상에 가장 많은 트래픽을 만드는 YouTube 검색어

이 쿼리는 특정 동영상 또는 동영상 그룹의 YouTube 검색결과에서 조회수가 가장 많은 검색어 10개를 가져옵니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 VIDEO_ID 문자열을 업로드한 동영상의 동영상 ID 최대 500개를 쉼표로 구분한 목록으로 바꿔야 합니다.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

상위 10개 – 동영상에서 가장 많은 트래픽을 발생시킨 외부 웹사이트

이 쿼리는 특정 동영상 또는 동영상 그룹의 Google 검색 결과에서 조회수가 가장 많은 외부 웹사이트 10개를 가져옵니다. 결과는 예상 시청 시간을 기준으로 내림차순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 VIDEO_ID 문자열을 업로드된 동영상의 동영상 ID 최대 500개를 쉼표로 구분한 목록으로 바꿔야 합니다.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

재생목록 보고서

국가 내 다양한 트래픽 소스의 재생목록 조회수 및 시청 시간

이 요청은 지정된 국가의 재생목록 조회수, 재생목록 시작 횟수, 재생목록 조회수에 대한 재생목록 예상 시청 시간을 가져옵니다. 이 측정항목은 사용자가 재생목록에 도달한 방식을 설명하는 트래픽 소스별로 집계됩니다.

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

다양한 트래픽 소스의 재생목록 조회수 및 시청 시간

이 요청은 콘텐츠 소유자의 채널 중 하나 이상의 재생목록에 대한 재생목록 조회수, 재생목록 시작 횟수, 재생목록 예상 시청 시간을 가져옵니다. 측정항목은 트래픽 소스별로 집계됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 문자열 CHANNEL_ID를 채널의 채널 ID 최대 500개로 구성된 쉼표로 구분된 목록으로 대체해야 합니다.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

동영상 보고서

소유권이 주장된 동영상의 일별 기기 유형 측정항목

이 쿼리는 특정 콘텐츠 소유자가 소유권을 주장한 동영상의 일일 조회수 및 기기 유형별 예상 시청 시간을 가져옵니다. 결과는 동영상이 재생되는 기기 유형별로 일별로 그룹화됩니다. 시간순으로 정렬됩니다.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

모바일 기기에서 본 소유권이 주장된 동영상의 일별 운영체제 측정항목

이 쿼리는 휴대기기에서 발생한 특정 콘텐츠 소유자가 소유권을 주장한 동영상 조회수에 대한 운영체제별 일일 조회수 및 예상 시청 시간을 검색합니다. 결과는 동영상 재생이 발생한 각 운영체제별로 일별로 그룹화됩니다. 시간순으로 정렬됩니다.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

일별 운영체제 및 기기 유형 측정항목

이 쿼리는 특정 콘텐츠 소유자가 소유권을 주장한 동영상의 일일 조회수 및 예상 시청 시간을 가져옵니다. 통계는 운영체제 및 기기 유형별로 그룹화됩니다. 시간순으로 정렬됩니다.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

재생목록 보고서

Android 운영체제의 재생목록 조회 기기 유형 측정항목

이 쿼리는 콘텐츠 소유자의 하나 이상의 채널에 있는 재생목록의 Android 기기 재생목록 조회수 및 재생목록 예상 시청 시간을 가져옵니다. 재생목록 조회가 발생한 각 기기 유형에 대한 결과가 반환됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 CHANNEL_ID 문자열을 채널의 최대 500개 채널 ID를 쉼표로 구분한 목록으로 바꿔야 합니다.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

휴대기기에서 재생목록 조회수에 대한 운영체제 측정항목

이 쿼리는 콘텐츠 소유자의 채널에 있는 재생목록의 모바일 기기 재생목록 조회수 및 재생목록 예상 시청 시간을 가져옵니다. 재생목록 조회가 발생한 각 운영체제에 대한 결과가 반환됩니다.

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE

동영상 보고서

캘리포니아의 시청자 인구통계 (연령대 및 성별)

이 보고서는 콘텐츠 소유자의 소유권 주장이 제기된 콘텐츠를 시청한 캘리포니아 시청자의 연령대 및 성별에 관한 통계를 가져옵니다. 결과는 성별을 기준으로 정렬된 후 연령대별로 정렬됩니다. filters 매개변수 값을 조정하여 전 세계 모든 뷰어 또는 국가, 대륙, 아대륙 또는 다른 미국 주의 모든 뷰어에 대해 동일한 통계를 가져오도록 이 쿼리를 수정할 수 있습니다.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

동영상이 공유된 서비스에서 집계한 공유 측정항목

이 요청은 사용자가 Share 버튼을 사용하여 콘텐츠 소유자가 업로드한 동영상을 공유한 횟수를 가져옵니다. 결과는 공유 서비스(Google+, Twitter 등)에서 집계되며 공유 횟수를 내림차순으로 정렬합니다.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares

동영상의 시청 지속 시간 측정항목

이 보고서는 동영상이 시청자의 관심을 얼마나 끌고 있는지를 측정합니다. 보고서는 한 번에 하나의 동영상에 대해서만 검색할 수 있습니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 VIDEO_ID 문자열을 업로드한 동영상 중 하나의 동영상 ID로 바꿔야 합니다. 시청 지속 시간 보고서에서는 video 필터에 여러 값을 지정하는 기능을 지원하지 않습니다.

이 예에서는 보고서가 audienceType 필터를 사용하여 동영상 검색 또는 추천 동영상 클릭과 같은 직접적인 사용자 작업의 결과인 자연 조회 데이터만 포함되도록 응답을 제한합니다. 따라서 TrueView 인스트림 광고 또는 TrueView 디스플레이 광고의 조회수에 대한 데이터는 보고서에 포함되지 않습니다. 필터를 삭제하여 모든 잠재고객 유형에서 동영상의 시청 지속 시간 데이터를 가져올 수 있습니다.

audienceType 필터의 데이터는 2013년 9월 25일부터 사용할 수 있습니다. API는 필터를 사용하여 이전 날짜의 데이터를 검색하려는 쿼리의 데이터를 반환하지 않습니다. 필터를 사용하지 않는 쿼리는 2008년 7월 1일 이후의 날짜에 작동합니다.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

소유권 주장이 제기된 콘텐츠의 수익 및 광고 실적 측정항목

이 요청은 콘텐츠 소유자의 소유권이 주장된 콘텐츠에 대한 수익 및 광고 실적 측정항목을 검색합니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

일일 수익 및 광고 실적 측정항목

이 요청은 콘텐츠 소유자의 소유권이 주장된 콘텐츠에 대한 일일 수익 및 광고 실적 측정항목을 검색합니다.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

국가별 수익 및 광고 실적 측정항목

이 요청은 콘텐츠 소유자의 소유권 주장이 제기된 콘텐츠에 대한 국가별 수익 및 광고 실적 측정항목을 가져옵니다. 결과는 수익 금액을 기준으로 내림차순으로 정렬되므로 파트너의 예상 수익이 가장 높은 국가가 첫 번째로 나열됩니다.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

상위 10개 – 수익이 가장 높은 동영상

이 요청은 콘텐츠 소유자의 소유권을 주장하고 수익이 가장 높은 동영상 10개의 수익 및 광고 실적 측정항목을 검색합니다. 결과는 수익 금액을 기준으로 내림차순으로 정렬되므로 첫 번째 동영상이 예상 수익이 가장 높은 동영상입니다.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

다른 광고 유형의 광고 실적 측정항목

이 요청은 콘텐츠 소유자가 소유권을 주장한 콘텐츠의 광고 실적 측정항목을 가져옵니다. 결과는 광고 유형별로 그룹화되어 여러 광고 유형의 수익과 CPM 값을 비교할 수 있습니다.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType