이 페이지에는 샘플 YouTube Analytics API 요청이 표시됩니다. 각 예에서는 검색되는 보고서를 간단히 설명한 다음 해당하는 dimensions, metrics, filters, sort 매개변수 값을 보여줍니다. 채널 보고서 및 콘텐츠 소유자 보고서 문서에서 API가 지원하는 보고서를 확인할 수 있습니다.
각 예시는 Google API 탐색기에 연결하고 표시된 값으로 채웁니다. 또한 이 예에서는 기본 시작일과 종료일(YYYY-MM-DD)인 2023-09-01 및 2024-03-31을 사용합니다.
API 탐색기에 연결한 후에도 보고서를 가져올 채널 또는 콘텐츠 소유자를 지정해야 합니다. API 탐색기에서는 클릭한 쿼리에 따라 ids 매개변수 값을 channel==MINE 또는 contentOwner==CONTENT_OWNER_ID로 채웁니다. 채널 보고서의 경우 MINE를 인증된 사용자의 채널 ID로 변경할 수 있습니다. 콘텐츠 소유자 보고서의 경우 CONTENT_OWNER_ID를 콘텐츠 소유자 ID로 바꿔야 합니다.
또한 API 탐색기가 OAuth 2.0를 사용하여 API 요청을 승인할 수 있도록 지정된 채널 또는 콘텐츠 소유자로 인증을 받아야 합니다.
여러 측정기준/측정항목을 기준으로 정렬 요청
이 API는 여러 측정기준 또는 측정항목을 사용하여 응답 데이터를 정렬하는 기능을 지원합니다. 예를 들어 아래 요청은 특정 채널의 동영상에 대한 일일 트래픽 소스 데이터를 검색합니다. 결과 집합의 각 행은 특정 유형의 트래픽 소스(예: EXT_URL)에서 발생한 조회수 및 예상 시청 시간을 특정 날짜에 식별합니다.
dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-views응답에서 결과는 시간순으로 정렬됩니다. 각 날짜의 결과 집합 내에서 결과는 조회수를 기준으로 내림차순으로 정렬됩니다. 따라서 결과 집합의 첫 번째 행에는 요청된 기간의 첫 번째 날에 조회수가 가장 많은 트래픽 소스의 데이터가 포함됩니다. 둘째 행은 첫째 날에 그 다음으로 조회수가 많은 트래픽 소스의 데이터를 포함합니다.
채널 보고서
동영상 보고서
채널의 총 조회수, 예상 시청 시간 등
이 쿼리는 채널 콘텐츠의 집계된 측정항목을 가져옵니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration채널의 국가별 조회수 등
이 쿼리는 채널 동영상의 특정 국가에 대한 측정항목을 검색합니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==US상위 10개 – 채널의 가장 많이 본 동영상
이 쿼리는 지정된 기간 동안의 예상 시청 시간으로 측정한 채널의 가장 많이 시청된 동영상 10개를 가져옵니다. 결과는 예상 감상 시간(분)을 기준으로 내림차순으로 정렬됩니다.
참고: 이 보고서를 사용하려면 sort 요청 매개변수의 값을 지정하고 maxResults 매개변수를 10 이하의 정수 값으로 설정해야 합니다.
dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatched상위 10개 – 채널에서 가장 많이 조회된 동영상의 특수효과 클릭률
이 요청은 채널에서 가장 많이 본 10개의 동영상의 조회수, 특수효과 클릭률, 특수효과 닫기 비율, 특수효과 노출수를 가져옵니다. 결과는 조회수를 기준으로 내림차순으로 정렬되므로 조회수가 가장 많은 동영상이 먼저 표시됩니다.
참고: 이 보고서를 사용하려면 sort 요청 매개변수의 값을 지정하고 maxResults 매개변수를 10 이하의 정수 값으로 설정해야 합니다.
dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views재생목록 보고서
채널의 총 재생목록 조회수
이 요청은 인증된 사용자의 채널에 있는 재생목록의 총 재생목록 시작 횟수, 예상 시청 시간(분), 조회수(집계된 동영상 측정항목), 재생목록 조회수(재생목록 내 측정항목), 재생목록 시작당 조회수를 가져옵니다.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart특정 재생목록의 통계
이 요청은 특정 재생목록의 총 재생목록 시작 횟수, 예상 시청 시간, 조회수(집계된 동영상 측정항목), 재생목록 조회수(재생목록 내 측정항목), 재생목록 시작당 조회수를 가져옵니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 PLAYLIST_ID 문자열을 인증된 사용자의 채널에 있는 재생목록의 재생목록 ID로 바꿔야 합니다.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID여러 재생목록의 집계 통계를 가져오려면 PLAYLIST_ID 문자열을 인증된 사용자의 채널에 있는 재생목록의 재생목록 ID를 쉼표로 구분하여 최대 500개까지 나열한 목록으로 대체할 수도 있습니다.
인기 급상승 – 채널에서 가장 많이 시청된 재생목록
이 쿼리는 지정된 기간 동안 재생목록 조회수로 측정한 채널에서 가장 많이 시청한 재생목록 상위 10개를 검색합니다. 또한 시청자가 각 재생목록의 재생을 시작한 횟수, 재생이 시작된 후 시청자가 재생목록의 동영상을 시청한 평균 시간과 같은 다른 여러 재생목록 측정항목도 가져옵니다. 결과는 재생목록 조회수를 기준으로 내림차순으로 정렬됩니다.
참고: 이 보고서는 playlist 측정기준을 사용하므로 sort 요청 매개변수의 값을 지정하고 maxResults 매개변수를 10 이하의 정수 값으로 설정해야 합니다.
dimensions=playlist
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves
maxResults=10
sort=-playlistViews동영상 보고서
채널 동영상의 일별 시청 시간 측정항목
이 쿼리는 채널 동영상의 일일 조회수, 시청 시간 측정항목, 새 구독자 수를 검색합니다. 보고서는 요청된 기간의 각 날짜에 대해 데이터 한 행을 반환합니다. 행은 시간순으로 정렬됩니다.
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콘텐츠 소유자 보고서
동영상 보고서
소유권 주장이 제기된 모든 콘텐츠의 총 조회수, 예상 시청 시간 등
이 쿼리는 콘텐츠 소유자의 소유권 주장이 제기된 콘텐츠에 관해 집계된 측정항목을 검색합니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed직접 업로드한 모든 동영상의 국가별 조회수 등
이 쿼리는 콘텐츠 소유자가 업로드한 동영상에 대한 특정 국가의 측정항목을 가져옵니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.
metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FR소유권 주장이 제기된 모든 서드 파티 콘텐츠의 총 조회수 등
이 쿼리는 콘텐츠 소유자가 소유권을 주장했지만 업로드하지 않은 동영상의 집계된 측정항목을 가져옵니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.
metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimed직접 업로드한 모든 콘텐츠의 총 조회수 등
이 쿼리는 콘텐츠 소유자가 업로드한 동영상의 집계된 측정항목을 가져옵니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self직접 업로드한 모든 소유권 주장이 제기된 콘텐츠의 총 조회수 등
이 쿼리는 콘텐츠 소유자가 업로드하고 소유권을 주장한 동영상의 집계된 측정항목을 가져옵니다. 보고서는 지정된 기간 동안 요청된 각 측정항목의 총계가 포함된 데이터 한 행을 반환합니다.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimed상위 10개 – 콘텐츠 소유자의 최다 조회 동영상
이 쿼리는 콘텐츠 소유자가 업로드한 동영상 중 지정된 기간 동안 조회수로 측정한 가장 많이 조회된 동영상 10개를 가져옵니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다.
dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views상위 10개 – 콘텐츠 소유자의 가장 많이 본 동영상
이 쿼리는 지정된 기간 중 예상 시청 시간(분)으로 측정한 콘텐츠 소유자가 업로드한 가장 많이 본 동영상 상위 10개를 검색합니다. 결과는 예상 감상 시간(분)을 기준으로 내림차순으로 정렬됩니다.
dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched상위 10개 – 콘텐츠 소유자 채널에서 가장 많이 조회된 동영상
이 쿼리는 콘텐츠 소유자가 관리하는 특정 채널 또는 채널 그룹에서 가장 많이 본 동영상 10개를 가져옵니다. 결과는 조회수를 기준으로 내림차순으로 정렬됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 CHANNEL_ID 문자열을 채널의 채널 ID를 쉼표로 구분하여 최대 500개까지 나열한 목록으로 바꿔야 합니다.
dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views상위 10개 – 채널에서 가장 많이 본 동영상의 특수효과 클릭률
이 요청은 지정된 채널 또는 채널 그룹에서 가장 많이 조회된 동영상 10개의 조회수, 특수효과 클릭률, 특수효과 닫기 비율, 특수효과 노출수를 가져옵니다. 결과는 조회수를 기준으로 내림차순으로 정렬되므로 조회수가 가장 많은 동영상이 먼저 표시됩니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 CHANNEL_ID 문자열을 채널의 채널 ID를 쉼표로 구분하여 최대 500개까지 나열한 목록으로 바꿔야 합니다.
dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views재생목록 보고서
콘텐츠 소유자 채널의 재생목록 조회수
이 요청은 콘텐츠 소유자 채널의 재생목록에 대한 총 재생목록 시작 횟수, 재생목록 예상 시청 시간(분), 재생목록 조회수, 재생목록 시작당 조회수를 검색합니다. playlistViews 측정항목은 재생목록의 맥락에서 발생한 동영상 조회수만 계산합니다. 요청된 모든 측정항목이 재생목록 내 측정항목이므로 요청에 재생목록 또는 그룹 필터도 포함할 필요가 없습니다.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart특정 재생목록의 통계
이 요청은 특정 재생목록의 총 재생목록 시작 횟수, 예상 시청 시간, 조회수(집계된 동영상 측정항목), 재생목록 조회수(재생목록 내 측정항목), 재생목록 시작당 조회수를 가져옵니다. API 탐색기에서 이 쿼리를 실행하려면 filters 매개변수 값의 PLAYLIST_ID 문자열을 콘텐츠 소유자의 채널 중 하나에 있는 재생목록의 재생목록 ID로 바꿔야 합니다.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID여러 재생목록의 집계 통계를 검색하려면 PLAYLIST_ID 문자열을 콘텐츠 소유자 채널의 재생목록에 대한 최대 500개의 재생목록 ID를 쉼표로 구분한 목록으로 대체할 수도 있습니다.
동영상 보고서
직접 업로드한 콘텐츠에 대한 일별 시청 시간 측정항목
이 쿼리는 콘텐츠 소유자가 업로드한 동영상의 일일 시청 시간 측정항목과 조회수, 수익 창출 재생수, 노출수를 가져옵니다. 이 보고서는 요청한 데이터 범위에서 하루에 데이터 한 행을 반환하며 행은 시간순으로 정렬됩니다.
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