샘플 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개 – 유럽에서 가장 많이 조회된 동영상

이 쿼리는 지정된 기간 동안의 조회수로 측정된 유럽에서 채널의 최다 조회 동영상 상위 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 Explorer에서 이 쿼리를 실행하려면 filters 매개변수 값의 VIDEO_ID 문자열을 업로드한 동영상에 대한 하나 이상의 동영상 ID가 쉼표로 구분된 목록으로 대체해야 합니다.

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 Explorer에서 이 쿼리를 실행하려면 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 Explorer에서 이 쿼리를 실행하려면 filters 매개변수 값의 VIDEO_ID 문자열을 업로드한 동영상에 대해 최대 500개의 동영상 ID가 쉼표로 구분된 목록으로 바꿔야 합니다.

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

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

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

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 Explorer에서 이 쿼리를 실행하려면 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개 – 유럽에서 가장 많이 시청한 동영상

이 쿼리는 지정된 기간 동안의 조회수로 측정된 콘텐츠 소유자가 소유권을 주장한 동영상 중에서 유럽에서 가장 많이 시청한 동영상 상위 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개 – 미국에서 가장 많이 시작된 재생목록

이 쿼리는 YouTube 채널의 시청자가 미국은 지정된 기간 동안 가장 자주 시청을 시작했습니다. 결과: 재생 목록 시작 수에 따라 내림차순으로 정렬됩니다.

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

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

동영상 보고서

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

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

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

동영상 보고서

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

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

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

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

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

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

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

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

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

참고: 다음 두 개의 샘플 보고서는 특정 트래픽 소스에 대해서만 지원됩니다. 예를 들어 NO_LINK_EMBEDDED 트래픽 소스에는 추가 세부정보가 없으므로 해당 소스에는 해당 보고서를 사용할 수 없습니다. 이러한 유형의 보고서를 사용할 수 있는 트래픽 소스에 대한 자세한 내용은 insightTrafficSourceType 정의를 참고하세요.

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

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

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

상위 10개 – 동영상에 가장 많은 트래픽을 생성한 외부 웹사이트

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

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 Explorer에서 이 쿼리를 실행하려면 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 문자열을 바꿔야 합니다. 매개변수 값을 쉼표로 구분하여 채널용 채널 ID를 최대 500개까지 포함할 수 있습니다.

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 Explorer에서 이 쿼리를 실행하려면 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