업데이트 기록

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

2026년 10월 30일

이제 YouTube Reporting API는 콘텐츠 소유자를 위해 다음과 같은 시스템 관리 보고서를 지원합니다.

카테고리 보고서 이름 보고서 유형 ID
재무 요약 월간 채널 조정 요약 content_owner_channel_adjustments_summary_a1
재무 요약 월간 유료 기능 거래 수익 content_owner_transactions_paid_features_revenue_a1
재무 요약 국가별 콘텐츠별 월간 TVOD 거래 수익 tvod_content_owner_country_title_tvod_revenue_a1
재무 요약 국가별 월간 TVOD 거래 수익 tvod_content_owner_country_transactions_tvod_revenue_a1
Shorts 동영상 월간 음반사 Shorts 저작물 제작 music_content_owner_shorts_asset_creations_a1
Shorts 동영상 월간 음반사 Shorts 저작물 조회수 music_content_owner_shorts_asset_views_a1
Shorts 동영상 월간 음반 제작사 Shorts 저작물 제작 publisher_content_owner_shorts_asset_creations_a1
Shorts 동영상 월간 음반 제작사 Shorts 저작물 조회수 publisher_content_owner_shorts_asset_views_a1
세금 월간 MCN 제휴사 세금 환급 요약 보고서 content_owner_affiliate_tax_refund_summary_a1
애셋 주간 SRMF 보고서 publisher_content_owner_weekly_srmf
애셋 일일 공식 아티스트 채널 요청 상태 보고서 content_owner_oac_request_status_a1
애셋 일일 OAC 요청 품질 보고서 content_owner_oac_quality_status_a1

2026년 9월 13일

이제 YouTube Reporting API에서 콘텐츠 소유자 (content_owner_active_references_a2)를 위한 주간 참조 보고서의 버전 1.1을 지원합니다.

버전 1.1에는 다음과 같은 변경사항이 도입되었습니다.

  • 참조 파일의 상태에 관한 추가 세부정보 또는 이유를 제공하는 status_detail 필드를 추가합니다.
  • 파트너 코드 대신 콘텐츠 소유자 표시 이름 또는 외부 ID를 사용하도록 asset_owners 필드를 업데이트합니다.

이전 버전의 보고서인 버전 1.0 (content_owner_active_references_a1)은 계속 사용할 수 있습니다.

2026년 9월 9일

YouTube Analytics API 및 YouTube Reporting API 문서가 업데이트되어 다음과 같은 내용이 추가되고 명확해졌습니다.

  • 데이터 기록 빈도 및 지연 시간 SLA: 데이터 모델에 전용 섹션을 추가하여 48~72시간의 데이터 처리 지연, 마지막으로 완전히 처리된 날짜로 종료일 자르기를 설명하고 실시간 동영상 통계를 위해 YouTube Data API videos.list 메서드를 권장합니다.

  • 채널 보고서의 금전적 측정항목: 채널이 YouTube 파트너 프로그램 (YPP) 회원인 경우 https://www.googleapis.com/auth/yt-analytics-monetary.readonly 범위로 승인된 채널 보고서에 예상 수익 및 광고 실적 측정항목이 지원되고 수익 창출이 불가능한 채널은 HTTP 403 Forbidden를 반환한다는 점을 명확히 하기 위해 채널 보고서 승인 문서를 업데이트했습니다.

  • 쿼리 제약 조건 및 매개변수 호환성: 보고서 표 이해하기에 잘못되었거나 상호 배타적인 측정기준, 측정항목, 필터 조합이 HTTP 400 badRequest ("The query is not supported.")를 반환한다는 점을 명확히 하는 권고 사항을 추가했습니다.

  • 일괄 보고서의 빈 측정기준 값: YouTube Reporting API 보고서 특성을 업데이트하여 video_id 또는 channel_id와 같은 측정기준 열에 빈 문자열이 포함되어 삭제된 리소스의 집계 측정항목 수를 보존하고 채널 수준 이벤트를 나타낸다는 점을 설명했습니다.

2026년 8월 27일

YouTube는 긴 형식 동영상, 라이브, Shorts 동영상 등 모든 동영상 형식의 공개 조회수 집계 방식을 일치시킬 예정입니다. YouTube는 동영상 재생이 시작되는 순간 공개 조회수를 집계합니다.

수익 창출 자격 요건과 대부분의 핵심 실적 측정항목은 참여도 측정항목을 기준으로 하므로 영향을 받지 않습니다. 크리에이터 수입은 YouTube 분석 > 고급 모드에서 확인할 수 있는 '유효 Shorts 조회수'와 '유효 시청 시간'을 기준으로 계속 산정됩니다.

YouTube 파트너 프로그램 자격 요건은 변경되지 않습니다. 또한 YouTube 파트너 프로그램 가입 요건의 기존 명칭인 '공개 Shorts 동영상의 유효 조회수' 및 '공개 동영상의 유효 시청 시간'이 각각 '유효 Shorts 조회수' 및 '유효 시청 시간'으로 변경됩니다.

자세한 내용은 YouTube 콘텐츠 실적 이해하기를 참고하세요.

측정항목 상태 트리거 사용 대상
View 업데이트됨 동영상이 첫 번째 프레임부터 재생됩니다(자동재생, 포인터 가져가기, 클릭/탭하여 재생 포함). 표준 공개 조회수
조회 충족 변경되지 않음 첫 프레임 이후에도 재생이 계속되거나 사용자가 클릭/탭하여 재생합니다. YouTube 파트너 프로그램을 통한 수익 창출, 대부분의 핵심 분석(클릭률, 평균 시청 지속 시간), 참여 보고서
썸네일 노출 변경되지 않음 썸네일은 상호작용이나 자동재생 없이 표시됩니다. 피드 수준 노출 및 패키징을 측정합니다.

API 문서 업데이트: YouTube Analytics API 측정항목 및 YouTube Reporting API 측정항목 문서에서 engagedViews 측정항목의 정의를 업데이트했습니다.

2026년 6월 25일

콘텐츠 소유자의 도시별 사용자 활동 보고서를 삭제하도록 YouTube Analytics API (타겟팅된 쿼리) 문서가 업데이트되었습니다. 이 보고서는 콘텐츠 소유자에게 지원되지 않습니다. 콘텐츠 소유자가 도시별 사용자 활동을 쿼리하면 빈 결과가 반환됩니다.

2026년 3월 9일

이제 ageGroup (YouTube Analytics API) 및 age_group (YouTube Reporting API) 측정기준에 YouTube에서 만 18세 미만으로 추정하는 사용자가 포함됩니다.

2026년 1월 15일

이제 YouTube Reporting API에서 채널 및 콘텐츠 소유자의 도달범위 보고서를 지원합니다. 도달범위 보고서는 동영상 썸네일 노출수 및 클릭률에 대한 통계를 제공합니다.

  • 채널에서 channel_reach_basic_a1 및 channel_reach_combined_a1 보고서를 사용할 수 있습니다.
  • content_owner_reach_basic_a1 및 content_owner_reach_combined_a1 보고서는 콘텐츠 소유자에게 제공됩니다.

이 보고서는 다음과 같은 새로운 측정항목을 지원합니다.

  • video_thumbnail_impressions
  • video_thumbnail_impressions_ctr

2025년 9월 22일

이전에 발표된 보고서 지원 중단이 2025년 9월 30일에서 2025년 10월 31일로 연기되었습니다. Shorts 조회수 변경사항에 맞게 업데이트된 이전 버전의 보고서는 그때까지 계속 사용할 수 있습니다. 단, 소유권 주장 보고서 v1.0 (content_owner_active_claims_a1) 및 소유권 주장 보고서 v1.1 (content_owner_active_claims_a2)은 9월 30일에 지원 중단됩니다.

2025년 6월 24일

2025년 3월 26일에 발표된 바와 같이, 새로운 Shorts 조회수 변경사항의 일환으로 일괄 보고서 API가 업데이트될 예정입니다. 다음과 같은 변경사항이 적용되었습니다.

  • 조회수가 포함된 각 보고서(대부분의 보고서)에 대해 새 보고서 버전이 생성되었습니다. 영향을 받는 각 보고서의 버전이 1씩 증가했습니다(예: 버전 a2에서 버전 a3).
  • 이제 Shorts 동영상의 경우 Shorts 동영상의 재생 또는 다시보기가 시작된 횟수가 조회수로 집계됩니다. 동영상의 경우 변경사항이 없습니다.
  • 업데이트된 보고서에는 이전 조회수 집계 방식을 반영하는 새로운 열인 engaged_views가 포함됩니다.

이 변경사항은 2025년 6월 30일부터 일괄 보고서 API에 적용됩니다. 이에 따라 보고서 처리를 조정해야 합니다.

이전 보고서 버전은 2025년 9월 30일까지 사용할 수 있습니다. 2025년 9월 30일 이후에는 이전 버전이 지원 중단됩니다. 최신 버전으로 마이그레이션해야 합니다.

마지막으로, 향후 보고서 변경으로 인해 처리 파이프라인이 중단되지 않도록 보고서를 처리할 때 권장사항을 따르세요.

다음 표에는 각 보고서 유형의 새 보고서 버전이 나와 있습니다.

YouTube 분석의 대량 데이터 보고서

채널 보고서 - 동영상 보고서
보고서 이름 이전 버전 최신 버전
사용자 활동 channel_basic_a2 channel_basic_a3
행정구역별 사용자 활동 channel_province_a2 channel_province_a3
재생 위치 channel_playback_location_a2 channel_playback_location_a3
트래픽 소스 channel_traffic_source_a2 channel_traffic_source_a3
기기 유형 및 운영체제 channel_device_os_a2 channel_device_os_a3
자막 channel_subtitles_a2 channel_subtitles_a3
결합 channel_combined_a2 channel_combined_a3
채널 보고서 - 재생목록 보고서
보고서 이름 이전 버전 최신 버전
사용자 활동 playlist_basic_a1 playlist_basic_a2
행정구역별 사용자 활동 playlist_province_a1 playlist_province_a2
재생 위치 playlist_playback_location_a1 playlist_playback_location_a2
트래픽 소스 playlist_traffic_source_a1 playlist_traffic_source_a2
기기 유형 및 운영체제 playlist_device_os_a1 playlist_device_os_a2
결합 playlist_combined_a1 playlist_combined_a2
콘텐츠 소유자 보고서 - 동영상 보고서
보고서 이름 이전 버전 최신 버전
사용자 활동 content_owner_basic_a3 content_owner_basic_a4
행정구역별 사용자 활동 content_owner_province_a2 content_owner_province_a3
재생 위치 content_owner_playback_location_a2 content_owner_playback_location_a3
트래픽 소스 content_owner_traffic_source_a2 content_owner_traffic_source_a3
기기 유형 및 운영체제 content_owner_device_os_a2 content_owner_device_os_a3
자막 content_owner_subtitles_a2 content_owner_subtitles_a3
결합 content_owner_combined_a2 content_owner_combined_a3
콘텐츠 소유자 보고서 - 재생목록 보고서
보고서 이름 이전 버전 최신 버전
사용자 활동 content_owner_playlist_basic_a1 content_owner_playlist_basic_a2
행정구역별 사용자 활동 content_owner_playlist_province_a1 content_owner_playlist_province_a2
재생 위치 content_owner_playlist_playback_location_a1 content_owner_playlist_playback_location_a2
트래픽 소스 content_owner_playlist_traffic_source_a1 content_owner_playlist_traffic_source_a2
기기 유형 및 운영체제 content_owner_playlist_device_os_a1 content_owner_playlist_device_os_a2
결합 content_owner_playlist_combined_a1 content_owner_playlist_combined_a2
콘텐츠 소유자 보고서 - 애셋 보고서
보고서 이름 이전 버전 최신 버전
사용자 활동 content_owner_asset_basic_a2 content_owner_asset_basic_a3
행정구역별 사용자 활동 content_owner_asset_province_a2 content_owner_asset_province_a3
동영상 재생 위치 content_owner_asset_playback_location_a2 content_owner_asset_playback_location_a3
트래픽 소스 content_owner_asset_traffic_source_a2 content_owner_asset_traffic_source_a3
기기 유형 및 운영체제 content_owner_asset_device_os_a2 content_owner_asset_device_os_a3
결합 content_owner_asset_combined_a2 content_owner_asset_combined_a3

시스템 관리 보고서 - 재무 (음악 외)

콘텐츠 소유자 보고서 - Shorts 보고서 (음악 외)
보고서 이름 이전 버전 최신 버전
글로벌 광고 수익 요약 content_owner_shorts_global_ad_revenue_summary_a1 content_owner_shorts_global_ad_revenue_summary_a2
일일 광고 수익 요약 content_owner_shorts_day_ad_revenue_summary_a1 content_owner_shorts_day_ad_revenue_summary_a2
국가 광고 수익 요약 content_owner_shorts_country_ad_revenue_summary_a1 content_owner_shorts_country_ad_revenue_summary_a2
광고 수익 요약 content_owner_shorts_ad_revenue_summary_a1 content_owner_shorts_ad_revenue_summary_a2

시스템 관리 보고서 - 비재무

콘텐츠 소유자 보고서 - 소유권 주장 보고서
보고서 이름 이전 버전 최신 버전
활성 상태인 소유권 주장 content_owner_active_claims_a2 content_owner_active_claims_a3
콘텐츠 소유자 보고서 - 동영상 메타데이터 보고서
보고서 이름 이전 버전 최신 버전
동영상 메타데이터 content_owner_video_metadata_a3 content_owner_video_metadata_a4
콘텐츠 소유자 보고서 - 애셋 보고서
보고서 이름 이전 버전 최신 버전
애셋 content_owner_asset_a2 content_owner_asset_a3
저작물 분쟁 content_owner_asset_conflict_a2 content_owner_asset_conflict_a3

2025년 4월 24일

2025년 3월 26일에 발표된 바와 같이, 새로운 Shorts 조회수 변경사항의 일환으로 타겟팅된 쿼리 API가 업데이트될 예정입니다.

  • 이제 Shorts 동영상의 경우 Shorts 동영상의 재생 또는 다시보기가 시작된 횟수가 views로 집계됩니다.
  • 새로운 측정항목인 engagedViews는 이전 조회수 집계 방식을 반영합니다. engagedViews은 views와 함께 모든 보고서에서 사용할 수 있습니다.

타겟팅된 쿼리 API의 경우 이러한 변경사항은 2025년 4월 30일부터 적용됩니다. 이에 따라 쿼리를 조정해야 합니다.

이 업데이트 기록을 확인하여 일괄 보고서 API에 어떤 변경사항이 언제 적용되는지 알아보세요.

2025년 4월 22일

2024년 4월 7일에 발표된 바와 같이 채널 보고서 및 콘텐츠 소유자 재생목록 보고서에서 isCurated 측정기준이 지원 중단되었습니다. 2024년 12월 31일부터 이 측정기준은 더 이상 지원되지 않습니다. 이 측정기준은 보고서 및 문서에서 삭제되었습니다.

2025년 3월 26일

이 업데이트에는 YouTube 분석 및 Reporting API와 관련된 다음과 같은 변경사항이 포함되어 있습니다.

2025년 3월 31일부터 YouTube에서 Shorts 조회수를 집계하는 방식이 변경됩니다. 이전에는 Shorts 동영상이 일정 시간 재생된 후에 조회수를 집계했습니다. 이제는 최소 시청 시간 요건 없이 Shorts 동영상의 재생 또는 다시보기가 시작되면 바로 조회수로 집계됩니다. 자세히 알아보기

YouTube 분석 (타겟팅된 쿼리) 및 Reporting (일괄 보고서) API가 다음과 같이 업데이트됩니다.

  • Shorts 동영상의 경우 Shorts 동영상의 재생 또는 다시보기가 시작되는 횟수가 views로 집계됩니다.
  • 이전 조회수 집계 방식을 반영하는 새로운 측정항목인 engagedViews가 제공됩니다.
  • 채널 소유자 또는 채널 데이터에 액세스할 권한이 있는 사용자는 업데이트된 조회수와 유효 조회수를 모두 쿼리할 수 있습니다.

타겟팅된 쿼리는 4월 30일까지 업데이트되고 일괄 보고서는 6월 30일까지 업데이트됩니다. 그때까지는 이전 방식에 따라 조회수가 집계됩니다. Shorts 및 채널 조회수가 스튜디오의 분석과 일치하지 않습니다.

또한 이전에 공지된 일일 소유권 주장 (버전 1.0) 보고서의 지원 중단이 연기되었습니다.

이 업데이트 기록을 확인하여 API가 변경된 시점을 알아보세요.

2025년 3월 3일

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

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

일일 소유권 주장 (버전 1.0) 보고서는 파트너에게 지원 중단되었습니다. 2025년 4월 30일부터는 더 이상 지원되지 않습니다. 이에 따라 해당 보고서의 정의가 업데이트되었습니다. 대신 최신 일일 소유권 주장 보고서를 사용하세요.

2024년 11월 15일

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

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

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

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

2024년 5월 6일

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

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

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

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

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

또한 시청 지속 시간 보고서가 개선되어 다음과 같은 세 가지 새로운 측정항목을 지원합니다.

2024년 4월 7일

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

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

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

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

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

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

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

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

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

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

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

    • 요청에 isCurated 측정기준이 포함된 경우 views 측정항목은 콘텐츠 소유자의 재생목록 컨텍스트에서 동영상이 조회된 횟수를 나타내는 재생목록 내 측정항목입니다.
    • 요청에 isCurated 측정기준이 포함되지 않은 경우 views 측정항목은 콘텐츠 소유자의 재생목록에 있는 동영상이 시청된 총 횟수를 지정하는 집계된 동영상 측정항목입니다. 이때 재생목록 컨텍스트에서 시청이 발생했는지 여부는 고려되지 않습니다. 집계된 총계에는 재생목록을 소유한 채널과 연결된 콘텐츠 소유자가 소유한 동영상의 조회수만 포함됩니다.

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

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

2024년 1월 19일

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

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

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

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

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

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

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

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

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

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

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

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

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

2023년 12월 4일

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

2022년 12월 15일

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

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

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

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

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

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

2022년 8월 26일

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

  • YouTube Analytics API (타겟팅된 쿼리) API에서 insightTrafficSourceType 측정기준의 값이 SUBSCRIBER인 경우 insightTrafficSourceDetail 값을 podcasts로 설정할 수 있습니다. 이는 트래픽이 팟캐스트 도착 페이지에서 참조되었음을 나타냅니다.
  • YouTube Reporting (일괄 보고서) API에서 traffic_source_type 측정기준의 값이 3인 경우 traffic_source_detail 값을 podcasts로 설정할 수 있으며, 이는 트래픽이 팟캐스트 도착 페이지에서 참조되었음을 나타냅니다.

2022년 2월 11일

2022년 8월 11일 이후에 gender 측정기준의 유효한 값 집합이 변경됩니다. 이는 API 구현에서 이전 버전과 호환되지 않는 변경사항일 수 있습니다. YouTube API 서비스 약관의 이전 버전과 호환되지 않는 변경사항 섹션에 따라 이 변경사항은 시행 6개월 전에 발표됩니다. 새로운 값 집합으로 원활하게 전환하려면 2022년 8월 11일 전에 API 구현을 업데이트하세요.

구체적인 변경사항은 다음과 같습니다.

  • YouTube 분석 (타겟팅된 쿼리) API에서 gender 측정기준은 현재 female 및 male의 두 값을 지원합니다. 2022년 8월 11일 이후에는 이 측정기준에서 female, male, user_specified의 세 가지 값을 지원합니다.
  • YouTube Reporting (일괄 보고서) API에서 gender 측정기준은 현재 FEMALE, MALE, GENDER_OTHER의 세 가지 값을 지원합니다. 2022년 8월 11일 이후에는 지원되는 값 집합이 FEMALE, MALE, USER_SPECIFIED로 변경됩니다.

2022년 2월 9일

2021년 12월 13일부터 연속 재생 클립 트래픽을 제외하도록 두 가지 측정항목이 업데이트되었습니다. 이 변경사항은 YouTube 분석 (타겟팅된 쿼리) API와 YouTube Reporting (일괄 보고서) API 모두에 영향을 미칩니다.

2022년 2월 2일

이 YouTube Reporting (일괄 보고서) API는 Live Redirect에서 발생한 조회수를 나타내는 새로운 트래픽 소스 측정기준 값을 지원합니다.

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

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

2020년 9월 23일

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

  • YouTube Analytics API (타겟팅된 쿼리) API에서 insightTrafficSourceType 측정기준은 SHORTS 값을 지원합니다.
  • YouTube Reporting (일괄 보고서) API에서 traffic_source_type 측정기준은 24 값을 지원합니다.

이 새로운 트래픽 소스 유형에는 트래픽 소스 세부정보 측정기준(YouTube Analytics API의 insightTrafficSourceDetail 또는 YouTube Reporting API의 traffic_source_detail)이 채워지지 않습니다.

2020년 7월 20일

이번 업데이트에는 YouTube 분석 (타겟팅된 쿼리) API에 영향을 미치는 두 가지 변경사항이 포함되어 있습니다.

  • YouTube 분석 보고서 그룹의 최대 크기가 200개에서 500개 항목으로 증가했습니다.
  • reports.query 메서드의 filters 매개변수는 YouTube 분석 데이터를 가져올 때 적용해야 하는 필터 목록을 식별합니다. 이 매개변수는 video, playlist, channel 필터에 여러 값을 지정하는 기능을 지원하며, 이러한 필터에 지정할 수 있는 최대 ID 수가 200개에서 500개로 늘어났습니다.

2020년 2월 13일

이번 업데이트에는 YouTube 분석 (타겟팅된 쿼리) API 및 YouTube Reporting (일괄 보고서) API와 관련된 다음과 같은 변경사항이 포함되어 있습니다. 이러한 변경사항에 대한 자세한 내용은 YouTube 고객센터를 참고하세요.

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

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

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

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

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

2019년 10월 15일

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

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

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

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

    • 7일 동안의 조회수는 해당 기간의 각 날짜의 조회수를 집계하여 계산할 수 있습니다.
    • 7일 동안의 viewerPercentage는 각 날짜에 발생한 조회수에 해당 날짜의 viewerPercentage를 곱하여 해당 날짜에 동영상을 시청할 때 로그인한 시청자 수를 구하는 방식으로 계산할 수 있습니다. 그런 다음 전체 기간의 로그인한 시청자 수를 더하고 해당 기간의 총 조회수로 나누어 전체 기간의 viewerPercentage를 구할 수 있습니다.
    • 동일한 시청자가 서로 다른 날짜에 순 시청자로 계산될 수 있으므로 7일 동안의 순 시청자 수는 계산할 수 없습니다. 하지만 30DayTotals 측정기준 대신 month 측정기준을 사용하여 30일 동안의 순 시청자 수에 관한 데이터를 추정할 수 있습니다. month 측정기준은 달력상의 월을 나타내지만 30DayTotals 측정기준은 지정된 시작일과 종료일을 기준으로 30일 기간을 계산합니다.

2019년 6월 27일

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

  • 이제 API 버전 1이 완전히 지원 중단되었으므로 지원 중단 알림과 버전 2로 업데이트하는 방법을 설명하는 이전 가이드를 포함하여 해당 버전에 대한 참조를 삭제하도록 문서가 업데이트되었습니다.

2018년 11월 1일

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

  • API 버전 1은 이제 지원 중단되었습니다. 아직 업데이트하지 않았다면 서비스 중단을 최소화하기 위해 가능한 한 빨리 API 버전 2를 사용하도록 API 클라이언트를 업데이트하세요. 자세한 내용은 이전 가이드를 참고하세요.

    이 지원 중단 일정은 원래 2018년 4월 26일에 발표되었습니다.

2018년 9월 17일

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

  • 데이터 모델 개요 문서의 새로운 데이터 익명 처리 섹션에서는 측정항목이 특정 기준을 충족하지 않는 경우 일부 YouTube 분석 데이터가 제한된다고 설명합니다. 이는 다양한 경우에 발생할 수 있습니다. 실제로 다음과 같은 경우 보고서에 데이터가 일부 또는 전부 포함되지 않을 수 있습니다.

    1. 지정된 기간 동안 동영상 또는 채널의 트래픽이 제한된 경우

      또는

    2. 값이 특정 기준점에 도달하지 않는 트래픽 소스 또는 국가와 같은 필터 또는 측정기준을 선택한 경우

    새 섹션에는 YouTube 분석 보고서에서 제한될 수 있는 데이터 유형에 관한 설명도 포함되어 있습니다.

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

2018년 6월 18일

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

  • 다음 메서드의 범위 요구사항이 변경되었습니다.
    • reports.query 메서드에 대한 요청은 https://www.googleapis.com/auth/youtube.readonly 범위에 액세스할 수 있어야 합니다.
    • groupItems.list 메서드에 대한 요청은 다음 중 하나에 액세스할 수 있어야 합니다.
      • https://www.googleapis.com/auth/youtube 범위
        또는
      • https://www.googleapis.com/auth/youtube.readonly 범위
        및
        https://www.googleapis.com/auth/yt-analytics.readonly 범위

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

2018년 5월 23일

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

  • API 개요에 집계 측정항목 및 삭제된 항목이라는 새로운 섹션이 추가되었습니다. 이 섹션에서는 API 응답이 동영상, 재생목록, 채널과 같은 삭제된 리소스와 연결된 데이터를 처리하는 방법을 설명합니다.
  • 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 (일괄 보고서) API와 관련된 다음과 같은 변경사항이 포함되어 있습니다.

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

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

      이 공지 전에는 모든 API 보고서를 생성 후 180일 동안 사용할 수 있었습니다. 명확히 말씀드리자면, 이 정책 변경사항이 적용되면 30일이 지난 이전 데이터 보고서도 더 이상 API를 통해 액세스할 수 없습니다. 60일이 지난 다른 모든 보고서도 더 이상 액세스할 수 없습니다. 따라서 이제 문서에는 정책 변경 전에 생성된 보고서를 최대 180일 동안 사용할 수 있다고 명시되어 있습니다.

    • 변경 후 보고 작업을 예약하면 YouTube는 해당 날짜부터 보고서를 생성하고 작업이 예약된 시간 이전의 30일 기간을 포함합니다. 변경 전에는 보고 작업을 예약하면 YouTube에서 작업이 예약된 시점 이전 180일 동안의 보고서를 생성했습니다.

  • 권장사항 섹션이 업데이트되어 YouTube Data API를 사용하여 보고서에서 식별된 리소스의 추가 메타데이터를 가져올 수 있음을 알려드립니다. YouTube API 서비스 개발자 정책 (섹션 III.E.4.b~III.E.4.d)에 명시된 바와 같이 API 클라이언트는 30일이 지나면 해당 API에서 저장된 리소스 메타데이터를 삭제하거나 새로고침해야 합니다.

  • 보고서 특성 섹션이 업데이트되어 보고서 데이터가 필터링되지 않더라도 2018년 6월 1일 이후의 기간에 대한 데이터가 포함된 보고서에는 보고서가 생성된 날짜로부터 최소 30일 전에 삭제된 YouTube 리소스에 대한 참조가 포함되지 않습니다.

  • 새 보고 작업을 예약하면 일반적으로 며칠 이내에 이전 보고서가 게시된다는 점을 명시하도록 API 개요의 이전 데이터 섹션이 업데이트되었습니다. 이전에는 문서에 이러한 보고서를 사용할 수 있게 되는 데 최대 30일이 걸릴 수 있다고 명시되어 있었습니다.

  • API 개요의 백필 데이터 섹션이 업데이트되어 백필 데이터를 이전에 전송된 세트를 대체하는 데이터 세트로 더 명확하게 정의합니다.

2018년 4월 26일

YouTube 분석 (타겟팅된 쿼리) API 버전 2 (v2)가 이제 공개적으로 제공됩니다. 다음 목록은 새 API 버전과 관련된 제품 및 문서 변경사항을 보여줍니다.

  • v2 API는 v1 API와 거의 동일합니다. 하지만 아래에 나열된 변경사항을 반영하도록 코드를 업데이트해야 할 수 있습니다. 이러한 모든 변경사항은 새로운 이전 가이드에 자세히 설명되어 있습니다.

    • API 버전이 v1에서 v2(으)로 변경되었습니다.
    • API 요청의 기준 URL이 https://www.googleapis.com/youtube/analytics/v1에서 https://youtubeanalytics.googleapis.com/v2로 변경되었습니다.
    • reports.query 메서드의 여러 매개변수 이름이 업데이트되었습니다. 특히 v1 API의 end-date와 같이 하이픈이 포함된 매개변수 이름은 v2 API에서 하이픈 대신 카멜 표기법 (endDate)을 사용합니다. 그룹을 만들고 관리하는 API 메서드에서 이미 매개변수 이름에 카멜 표기법을 사용하고 있으므로 이 변경사항을 통해 API 전체에서 매개변수 이름이 일관되게 유지됩니다.
    • v2 API는 Google의 전역 HTTP 일괄 엔드포인트 (www.googleapis.com/batch)로 전송되는 일괄 요청을 지원하지 않습니다. v2 API에서 일괄 요청을 전송하는 경우 대신 https://youtubeanalytics.googleapis.com/v2 엔드포인트를 사용해야 합니다.

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

    • reports.query 메서드는 더 이상 alt, quotaUser, userIp 요청 매개변수를 지원하지 않습니다.
    • v2 API는 서로 다른 API에 대한 요청으로 구성된 일괄 처리를 지원하는 일괄 엔드포인트를 제공하지 않습니다. 하지만 일괄은 동일한 API의 다른 메서드에 대한 요청으로 구성될 수 있습니다. 이 지원 중단은 YouTube Analytics API에만 국한되지 않으며 Google은 모든 API에서 전역 일괄 엔드포인트를 지원 중단합니다.
    • v2 API는 API v1에서 지원되었던 JSON-RPC 프로토콜을 지원하지 않습니다. 이 지원 중단은 YouTube Analytics API에만 국한되지 않습니다.

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

    API 버전 1 (v1)은 현재 지원 중단되었으며 2018년 10월 31일까지 지원됩니다. 이 날짜 이후에는 v1 API에 대한 모든 요청이 작동을 중지합니다. 따라서 API를 통해 YouTube 분석 데이터에 액세스하는 데 지장이 없도록 2018년 10월 31일까지 v2 API로 업그레이드하시기 바랍니다.

2018년 2월 21일

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

  • 시청자의 연령대 및 성별을 기준으로 시청 통계를 집계하는 시청자 인구통계 보고서에서 사용자 활동이 발생한 YouTube 서비스를 식별하는 youtubeProduct 측정기준을 더 이상 지원하지 않습니다.

2018년 1월 18일

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

  • YouTube Reporting API (일괄 보고서)

    • 조회수가 발생한 기기의 소프트웨어 시스템을 식별하는 operating_system 측정기준은 이제 다음 값을 지원합니다.
      • 25: KaiOS

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

    • operatingSystem 측정기준은 측정기준 값 KAIOS을 지원합니다.

2017년 12월 20일

이 업데이트에는 YouTube Reporting API와 관련된 두 가지 변경사항이 포함되어 있습니다.

  • 이제 API 서버에서 보고서를 다운로드하는 요청에 대해 gzip 압축을 지원합니다. gzip 압축은 다른 유형의 API 요청에는 지원되지 않습니다. gzip 압축을 사용 설정하면 각 API 응답에 필요한 대역폭이 줄어듭니다. 또한 애플리케이션에서 API 응답의 압축을 풀려면 추가 CPU 시간이 필요하지만, 네트워크 리소스를 적게 사용하는 이점이 일반적으로 그 비용보다 큽니다.

    gzip으로 인코딩된 응답을 받으려면 다음 예시와 같이 Accept-Encoding HTTP 요청 헤더를 gzip로 설정합니다.

    Accept-Encoding: gzip

    이 기능은 API 개요와 report 리소스의 downloadUrl 속성 정의에 설명되어 있습니다.

  • age group 및 gender 측정기준의 문서가 수정되어 API가 해당 측정기준에 대해 반환하는 실제 값이 표시됩니다. 이는 문서 수정사항이며 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월 4일에 제공되는 경우에도 마찬가지입니다.)

    • 이제 adType 측정기준은 동영상을 시청하기 전에 재생되는 최대 6초 길이의 건너뛸 수 없는 동영상 광고를 나타내는 reservedBumperInstream 값을 지원합니다. 광고 형식은 auctionBumperInstream 광고와 동일하지만 이 유형은 입찰이 아닌 예약 기반으로 판매되는 광고를 의미합니다.

  • YouTube Reporting API (일괄 보고서)

    • 이제 ad_type 측정기준은 예약 기반으로 판매되는 범퍼 광고를 나타내는 20 값을 지원합니다. 범퍼 광고는 건너뛸 수 없는 동영상 광고로, 최대 6초 길이이며 동영상을 시청하기 전에 재생됩니다. 이 측정기준의 값 19는 예약이 아닌 입찰을 통해 판매되는 범퍼 광고를 나타냅니다.

    • 다음 YouTube Reporting API 보고서의 보고서 작업이 삭제되었습니다.

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      이러한 보고서 유형은 2016년 9월 15일에 지원 중단이 발표되었으며 2016년 12월 15일 이후에는 해당 보고서 유형에 대한 보고서가 더 이상 생성되지 않습니다. 이전에 생성된 보고서는 생성된 시점부터 180일 동안 계속 사용할 수 있었습니다. 따라서 일부 보고서는 2017년 6월 15일까지 액세스할 수 있었습니다. 하지만 보고서를 더 이상 사용할 수 없으므로 보고서와 연결된 작업도 필요하지 않습니다.

2017년 5월 24일

다음 YouTube Reporting API 보고서의 모든 보고서 작업이 삭제되었습니다.

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

이러한 보고서 유형은 2016년 6월 22일에 지원 중단이 발표되었으며 2016년 9월 22일 이후에는 해당 보고서 유형의 보고서가 더 이상 생성되지 않습니다. 이전에 생성된 보고서는 생성된 시점부터 180일 동안 계속 사용할 수 있었습니다. 따라서 일부 보고서는 2017년 3월 22일까지 액세스할 수 있었습니다. 하지만 보고서를 더 이상 사용할 수 없으므로 보고서와 연결된 작업도 필요하지 않습니다.

2017년 5월 22일

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

  • YouTube Reporting API (일괄 보고서)

    • 동영상을 공유하는 데 사용된 서비스를 식별하는 sharing_service 측정기준은 이제 다음 값을 지원합니다.
      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      또한 값 52를 식별하는 데 사용되는 이름이 문서에서 Kakao (Kakao Talk)로 업데이트되어 값 73 (Kakao Story)와 더 명확하게 구분됩니다. 이 변경사항은 API 동작이나 이러한 서비스와 공유되는 동영상의 분류에 영향을 미치지 않습니다.

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

    • 이제 sharingService 측정기준은 다음 값을 지원합니다.
      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

2017년 3월 28일

크리에이터 스튜디오의 YouTube 분석을 통해 수익 데이터에 액세스할 수 있는 채널 소유자는 이제 YouTube Analytics API를 통해서도 수익 데이터에 액세스할 수 있습니다.

2017년 3월 17일

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

  • YouTube Analytics API는 YouTube Red 시청률과 관련된 redViews 및 estimatedRedMinutesWatched 측정항목을 지원합니다. 실제로 API는 한동안 이러한 측정항목을 지원해 왔으며 YouTube Reporting API는 2016년 9월 15일에 발표된 대로 이미 두 측정항목을 모두 지원합니다.

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

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

2017년 3월 3일

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

  • YouTube Reporting API (일괄 보고서)

    • date 측정기준의 정의가 수정되어 측정기준 값이 지정된 날짜, 월, 연도의 오전 12시(태평양 표준시)부터 오후 11시 59분(태평양 표준시)까지의 기간을 나타낸다는 점이 명시되었습니다. 연중 시기에 따라 태평양 표준시는 UTC-7 또는 UTC-8입니다.

      날짜는 일반적으로 24시간을 나타내지만, 시계가 앞으로 조정되는 날짜는 23시간을 나타내고 시계가 뒤로 조정되는 날짜는 25시간을 나타냅니다. (이전에는 문서에 각 날짜가 고유한 24시간을 나타내며 태평양 표준시는 항상 UTC-8이라고 명시되어 있었습니다.)

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

    • 조회수가 발생한 기기의 소프트웨어 시스템을 식별하는 operating_system 측정기준은 이제 다음 값을 지원합니다.
      • 22: 타이젠
      • 23: Firefox
      • 24: RealMedia

    • content_owner_basic_a1 보고서 유형의 모든 보고서 작업이 삭제되었습니다. 이 보고서 유형은 2016년 8월 19일에 완전히 지원 중단되었지만 이전에 생성된 content_owner_basic_a1 보고서는 생성된 후 180일 동안 계속 사용할 수 있었습니다. 따라서 일부 보고서는 2017년 2월 19일까지 액세스할 수 있었습니다. 하지만 보고서를 더 이상 사용할 수 없으므로 보고서와 연결된 작업도 필요하지 않습니다.

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

    • time periods와 관련된 측정기준의 설명이 수정되어 측정기준 값이 지정된 날짜, 월, 연도의 오전 12시(태평양 표준시)에 시작하여 오후 11시 59분(태평양 표준시)에 종료되는 기간을 나타낸다는 점이 명시되었습니다. 연중 시기에 따라 태평양 표준시는 UTC-7 또는 UTC-8입니다.

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

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

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

    • operatingSystem 측정기준은 세 가지 새로운 측정기준 값을 지원합니다.
      • FIREFOX
      • REALMEDIA
      • TIZEN

2017년 2월 8일

이제 YouTube Analytics API에서 선택적 include-historical-channel-data 매개변수를 지원합니다. 이 매개변수는 콘텐츠 소유자 보고서를 가져올 때만 관련이 있습니다.

이 매개변수를 사용하면 콘텐츠 소유자가 채널이 콘텐츠 소유자에게 연결되기 전 기간의 채널 시청 시간 및 조회수 데이터를 API 응답에 포함하도록 지정할 수 있습니다. 기본 파라미터 값은 false입니다. 즉, 기본적으로 API 응답에는 채널이 콘텐츠 소유자에 연결된 시점의 시청 시간 및 조회수 데이터만 포함됩니다.

이러한 규칙은 API 요청이 여러 채널의 데이터를 가져오는 경우에도 적용됩니다.

  • 매개변수 값이 false이면 특정 채널에 대해 반환되는 시청 시간 및 조회수 데이터는 해당 채널이 콘텐츠 소유자에게 연결된 날짜를 기준으로 합니다.

    채널마다 콘텐츠 소유자에게 연결된 날짜가 다를 수 있다는 점을 기억해야 합니다. API 요청이 여러 채널의 데이터를 가져오고 매개변수 값이 false인 경우 API 응답에는 각 채널의 연결 날짜를 기준으로 한 시청 시간 및 조회수 데이터가 포함됩니다.
  • 매개변수 값이 true이면 API 요청에 지정된 시작일과 종료일을 기준으로 모든 채널의 시청 시간 및 조회수 데이터를 반환합니다.

2016년 12월 15일

다음 YouTube Reporting API 보고서는 더 이상 지원되지 않으며 문서에서 삭제되었습니다. 각 보고서의 최신 버전을 사용할 수 있습니다. 이러한 보고서의 지원 중단 공지는 2016년 9월 15일에 발표되었습니다.

API 참고 문서의 현재 보고서 유형 목록도 업데이트되었습니다.

2016년 11월 11일

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

YouTube Reporting API는 세 가지 새로운 최종 화면 보고서와 이러한 보고서의 새로운 측정기준 및 측정항목을 지원합니다. 이 보고서는 동영상 재생이 중지된 후 표시되는 최종 화면의 노출수 및 클릭률 통계를 제공합니다.

2016년 11월 8일

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

  • 다음 목록의 측정항목은 완전히 지원 중단되었으며 더 이상 지원되지 않습니다. 2016년 8월 10일에 발표된 바와 같이 동일한 데이터를 참조하는 새로운 측정항목은 이미 지원되고 있습니다. 아래 표에는 지원 중단된 측정항목 이름과 새 측정항목 이름이 나와 있습니다.

    지원 중단된 측정항목 새 측정항목
    adEarnings estimatedAdRevenue
    impressionBasedCpm cpm
    impressions adImpressions
    redPartnerRevenue estimatedRedPartnerRevenue

2016년 10월 27일

이제 YouTube는 YouTube 크리에이터 스튜디오의 보고서 섹션에서 해당 보고서에 액세스할 수 있는 콘텐츠 소유자를 위해 시스템 관리 광고 수익 보고서를 자동으로 생성합니다. 새로운 시스템 관리 API 보고서는 수동으로 다운로드할 수 있는 크리에이터 스튜디오 보고서에서도 제공되는 데이터에 프로그래매틱 방식으로 액세스할 수 있도록 설계되었습니다.

시스템 관리 보고서 개요에서는 새 보고서에 대한 간략한 개요를 제공하고 API를 통해 보고서를 가져오는 프로세스를 설명합니다. 이 프로세스는 파트너가 보고서를 생성하기 위해 작업을 예약할 필요가 없으므로 YouTube 분석의 일괄 보고서를 가져오는 프로세스와 약간 다릅니다.

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

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

2016년 9월 27일

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

YouTube Analytics API의 uniques 측정항목이 지원 중단되었습니다. 이 측정항목은 핵심 측정항목이 아니며 2016년 10월 31일까지 지원됩니다.

2016년 9월 15일

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

2016년 8월 19일

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

  • content_owner_basic_a1 보고서가 완전히 지원 중단되었으며 문서에서 삭제되었습니다. YouTube에서는 더 이상 해당 유형의 새 보고서를 생성하지 않지만, 이미 생성된 보고서는 생성된 시점부터 180일 동안 계속 사용할 수 있습니다.

    content_owner_basic_a1 보고서는 2016년 5월 19일 업데이트 기록 항목에 설명된 대로 content_owner_basic_a2 보고서로 대체됩니다.

2016년 8월 11일

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

  • YouTube 엔지니어링 및 개발자 블로그에서 자세히 설명한 새로 게시된 YouTube API 서비스 약관('업데이트된 약관')은 현재 서비스 약관에 대한 다양한 업데이트를 제공합니다. 2017년 2월 10일부터 적용되는 업데이트된 약관 외에도 이번 업데이트에는 개발자가 준수해야 하는 정책을 설명하는 데 도움이 되는 여러 지원 문서가 포함되어 있습니다.

    새 문서의 전체 세트는 업데이트된 약관의 업데이트 기록에 설명되어 있습니다. 또한 '업데이트된 약관' 또는 관련 지원 문서의 향후 변경사항도 해당 업데이트 기록에 설명됩니다.

2016년 8월 10일

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

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

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

      다음 표의 측정항목은 지원 중단될 예정입니다. 동시에 동일한 데이터를 참조하는 새로운 측정항목이 도입됩니다. 즉, 기존 측정항목의 이름이 변경되는 것이지만 YouTube Analytics API는 표에 나열된 지원 중단 날짜까지 두 측정항목 이름을 모두 지원합니다.

      이전 측정항목 이름 새 측정항목 이름 지원 날짜
      earnings estimatedRevenue 2017년 8월 10일
      adEarnings estimatedAdRevenue 2016년 11월 4일
      redPartnerRevenue estimatedRedPartnerRevenue 2016년 11월 4일
      impressionBasedCpm cpm 2016년 11월 4일
      impressions adImpressions 2016년 11월 4일

      earnings 측정항목은 핵심 측정항목이므로 이 공지일로부터 1년 동안 지원됩니다. 핵심 측정항목이 아닌 다른 측정항목은 2016년 11월 4일까지 3개월 동안 지원됩니다.

      예를 들어 2016년 11월 4일까지는 API 요청에서 impressionBasedCpm 측정항목, cpm 측정항목 또는 둘 다를 지정할 수 있습니다. 하지만 이 날짜 이후에는 cpm 측정항목만 지원됩니다.

    • insightTrafficSourceType 측정기준은 두 가지 새로운 측정기준 값을 지원합니다.
      • CAMPAIGN_CARD: 이 트래픽 소스는 콘텐츠 소유자 보고서에서만 지원됩니다. 콘텐츠 소유자가 시청된 콘텐츠를 홍보하는 데 사용한, 소유권 주장이 제기된 사용자 업로드 동영상에서 발생한 조회수를 나타냅니다.
      • END_SCREEN: 다른 동영상의 최종 화면에서 발생한 조회수와 관련된 데이터입니다.

      두 가지 새로운 트래픽 소스 모두에 대해 traffic source detail 보고서를 가져올 수도 있습니다. 두 경우 모두 insightTrafficSourceDetail 측정기준은 시청자가 추천된 동영상을 식별합니다.

    • 이제 adType 측정기준은 동영상을 시청하기 전에 재생되는 최대 6초 길이의 건너뛸 수 없는 동영상 광고를 나타내는 auctionBumperInstream 값을 지원합니다.

  • YouTube Reporting API (일괄 보고서)

    • 이제 traffic_source_type 측정기준은 다음 값을 지원합니다.
      • 19: 이 트래픽 소스는 콘텐츠 소유자 보고서에서만 지원됩니다. 콘텐츠 소유자가 시청된 콘텐츠를 홍보하는 데 사용한, 소유권 주장이 제기된 사용자 업로드 동영상에서 발생한 조회수를 나타냅니다.
      • 20: 다른 동영상의 최종 화면에서 발생한 조회수와 관련된 데이터입니다.

      두 가지 새로운 트래픽 소스 모두에서 traffic_source_detail 측정기준은 시청자가 추천된 동영상을 식별합니다.

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

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

2016년 7월 18일

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

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

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

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

      이전에는 두 보고서의 문서에 두 필터 중 하나를 사용하거나 두 필터를 모두 사용하지 않고 보고서를 가져올 수 있다고 잘못 명시되어 있었습니다.

  • YouTube Reporting API (일괄 보고서)

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

2016년 6월 28일

YouTube Analytics API 문서가 업데이트되어 수많은 채널 및 콘텐츠 소유자 보고서에서 카드 측정항목을 지원합니다. 새로 지원되는 측정항목은 다음과 같습니다.

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

2016년 6월 22일

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

  • API 개요의 보고서 특성 섹션이 업데이트되어 보고서가 생성된 시점부터 180일 동안 API를 통해 보고서를 사용할 수 있음을 명확히 했습니다.

    이전에는 API 요청이 전송된 날짜로부터 최대 180일 전까지 보고서를 사용할 수 있다고 문서에 명시되어 있었습니다. 이 역시 기술적으로는 사실이지만, 원래 텍스트는 기껏해야 다소 혼란스러운 수준이었습니다.

  • API는 세 가지 보고서의 새 버전을 지원합니다. 이 중 두 보고서에는 새 측정항목과 이름이 바뀐 측정항목도 포함되어 있습니다.

    • content_owner_ad_rates_a1 보고서는 content_owner_ad_performance_a1 보고서의 새 버전입니다. 새로 이름이 변경된 보고서는 이전 버전과 동일합니다.

    • 새 버전이 있는 두 보고서의 이름이 변경되었습니다.

      • content_owner_estimated_earnings_a1 보고서의 새 버전 이름은 content_owner_estimated_revenue_a1입니다.
      • content_owner_asset_estimated_earnings_a1 보고서의 새 버전 이름은 content_owner_asset_estimated_revenue_a1입니다.

      새로 이름이 변경된 두 보고서는 다음과 같은 점에서 이전 보고서와 다릅니다.

    이전 버전의 보고서를 만드는 작업이 이미 있는 경우 이름이 바뀐 보고서에 대한 새 작업을 만들어야 합니다. 새 보고서 버전 출시와 함께 content_owner_ad_performance_a1, content_owner_estimated_earnings_a1, content_owner_asset_estimated_earnings_a1 보고서가 지원 중단되었습니다.

    이러한 보고서에 대한 작업이 있는 경우 2016년 9월 22일 이후에는 YouTube에서 해당 작업에 대한 새 보고서를 생성하지 않습니다. 생성된 보고서는 생성된 시점부터 180일 동안 계속 사용할 수 있습니다.

  • 현재 사용 가능한 보고서 집합을 반영하도록 reportType 리소스의 id 속성 정의가 업데이트되었습니다.

  • 보고서에 표시되는 이름과 일치하도록 문서에서 두 측정항목의 이름이 수정되었습니다. 이는 순전히 문서 수정이며 실제 보고서 콘텐츠의 변경사항을 반영하지 않습니다.

    • estimated_partner_adsense_revenue 측정항목의 이름이 estimated_partner_ad_sense_revenue로 업데이트되었습니다. 하지만 이 측정항목은 이번 업데이트로 지원 중단되는 두 보고서에만 표시됩니다. 위에서 설명한 대로 이 측정항목은 최신 버전의 보고서에서 estimated_partner_ad_auction_revenue로 이름이 변경되었습니다.
    • estimated_partner_doubleclick_revenue 메트릭의 이름이 estimated_partner_double_click_revenue로 업데이트되었습니다. 이 측정항목은 이번 업데이트로 지원 중단되는 두 보고서에만 표시됩니다. 위에서 설명한 대로 이 측정항목은 최신 버전의 보고서에서 estimated_partner_ad_reserved_revenue로 이름이 변경되었습니다.

  • elapsed_video_time_percentage 및 audience_retention_type 속성이 더 이상 표시되지 않도록 Reporting API의 측정기준 문서가 업데이트되었습니다. 이러한 측정기준은 현재 API를 통해 사용할 수 있는 보고서에서 지원되지 않습니다.

2016년 5월 19일

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

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

    content_owner_basic_a1 보고서를 만드는 작업이 이미 있더라도 content_owner_basic_a2 보고서에 대한 새 작업을 만들어야 합니다. YouTube는 콘텐츠 소유자를 새 보고서 버전으로 자동 이전하거나 새 보고서 버전을 생성하는 작업을 자동으로 만들지 않습니다. 일부 구현에서는 예상치 못한 새 작업이 표시되면 브레이킹 체인지가 될 수 있습니다.

    새 보고서 출시와 함께 content_owner_basic_a1 보고서는 지원 중단되었습니다. 해당 보고서에 대한 작업이 있는 경우 2016년 8월 19일 이후에는 YouTube에서 해당 작업에 대한 새 보고서를 생성하지 않습니다. 생성된 보고서는 생성된 시점부터 180일 동안 계속 사용할 수 있습니다.

  • reportType, job, report 리소스는 모두 연결된 리소스가 지원 중단된 보고서 유형을 나타내는지 식별하는 새 속성을 지원합니다.

    • reportType 리소스의 deprecateTime 속성은 보고서 유형이 지원 중단되는 날짜와 시간을 지정합니다. 이 속성은 지원 중단이 발표된 보고서에만 값이 있으며, 이 값은 YouTube에서 해당 유형의 보고서 생성을 중단하는 날짜를 나타냅니다.

      보고서 유형이 지원 중단된 것으로 발표된 후에도 YouTube는 3개월 동안 해당 유형의 보고서를 생성합니다. 예를 들어 2016년 5월 19일 업데이트에서는 content_owner_basic_a1 보고서의 지원 중단을 발표합니다. 따라서 해당 보고서 유형의 deprecateTime는 2016년 8월 19일의 시간을 지정하며, 이 시간 이후 YouTube는 해당 유형의 보고서 생성을 중지합니다.

    • job 리소스의 expireTime 속성은 작업이 만료된 날짜와 시간 또는 만료될 날짜와 시간을 지정합니다. 이 속성은 작업과 연결된 보고서 유형이 지원 중단되었거나 작업에 대해 생성된 보고서가 장기간 다운로드되지 않은 경우에 값을 갖습니다. 이 날짜는 YouTube에서 더 이상 작업에 대한 새 보고서를 생성하지 않는 시점을 나타냅니다.

    • report 리소스의 jobExpireTime 속성은 보고서와 연결된 작업이 만료되었거나 만료될 날짜와 시간을 지정합니다. 이 속성에는 이 목록의 이전 항목에 설명된 대로 job 리소스의 expireTime 속성과 동일한 값이 포함됩니다.

  • 이제 지원 중단된 보고서의 작업을 만들려고 하면 jobs.create 메서드가 400 HTTP 응답 코드 (Bad Request)를 반환합니다. 또한 이제 메서드 문서에 API 요청이 실패하는 다른 여러 이유가 나열됩니다.

2016년 4월 12일

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

  • 이제 YouTube는 보고서 작업이 처음 예약된 시점 이전의 180일 기간을 포함하는 데이터를 생성합니다. 이전에는 Reporting API에서 이전 데이터를 제공하지 않았습니다. 이 변경사항은 이 공지 이전에 생성된 작업을 포함한 모든 작업에 영향을 미칩니다.

    이전 보고서는 사용 가능해지는 즉시 게시되지만, 작업의 모든 이전 데이터가 게시되는 데는 약 한 달이 걸립니다. 따라서 보고서 작업을 예약한 지 한 달이 지나면 약 7개월 분량의 데이터에 액세스할 수 있습니다. (이 공지 이전에 생성된 채용 정보의 모든 이전 데이터는 공지 후 한 달 이내에 게시되어야 합니다.)

    이전 데이터는 2015년 7월 1일 이후에 대해서만 제공됩니다. 따라서 2015년 12월 28일 이전에 생성된 작업에는 180일 미만의 이전 데이터가 포함됩니다.

    이러한 변경사항은 Reporting API 개요의 새로운 이전 데이터 섹션에 모두 설명되어 있습니다.

  • YouTube Reporting API 개요의 보고서 특성 섹션이 다음과 같이 업데이트되었습니다.

    • 이제 문서에 보고서가 생성된 후 180일 동안 제공되므로 API 클라이언트가 다운로드할 수 있다고 명시되어 있습니다. 이전에는 API 요청이 전송된 날짜로부터 최대 6개월 전까지의 보고서를 사용할 수 있다고 문서에 명시되어 있었습니다.

    • 이제 API가 데이터가 없는 날짜에 대해 다운로드 가능한 보고서를 생성한다는 사실을 반영하도록 문서가 업데이트되었습니다. 이러한 보고서에는 헤더 행이 포함되지만 추가 데이터는 포함되지 않습니다.

  • YouTube Reporting API는 광고 수익 데이터 또는 YouTube Red 구독 수익 데이터가 포함된 자동 생성 시스템 관리 보고서를 곧 지원할 예정입니다. 이 보고서는 YouTube 크리에이터 스튜디오에서 수동으로 다운로드 가능한 수익 보고서에 이미 액세스할 수 있는 콘텐츠 소유자에게 제공됩니다. 따라서 새로운 API 기능은 해당 데이터에 대한 프로그래매틱 액세스를 제공합니다.

    시스템 관리 보고서 출시를 준비하기 위해 다음과 같은 API 변경사항이 발표됩니다.

    • job 리소스의 새 systemManaged 속성은 리소스가 시스템 관리 보고서를 생성하는 작업을 설명하는지 여부를 나타냅니다. YouTube는 YouTube 콘텐츠 소유자를 위해 시스템 관리 보고서를 자동으로 생성하며, 콘텐츠 소유자는 이러한 보고서를 생성하는 작업을 수정하거나 삭제할 수 없습니다.

    • jobs.list 메서드의 새 includeSystemManaged 매개변수는 API 응답에 시스템 관리 보고서의 작업이 포함되어야 하는지 여부를 나타냅니다. 매개변수의 기본값은 false입니다.

    • jobs.reports.list 메서드의 새로운 startTimeAtOrAfter 매개변수는 보고서의 가장 이른 데이터가 지정된 날짜 또는 그 이후인 경우에만 API 응답에 보고서가 포함되어야 함을 나타냅니다. 마찬가지로 startTimeBefore 매개변수는 보고서의 가장 이른 데이터가 지정된 날짜 이전인 경우에만 API 응답에 보고서가 포함되어야 함을 나타냅니다.

      보고서가 생성된 시간과 관련된 메서드의 createdAfter 매개변수와 달리 새 매개변수는 보고서의 데이터와 관련이 있습니다.

    • reportType 리소스의 새 systemManaged 속성은 리소스가 시스템 관리 보고서를 설명하는지 여부를 나타냅니다.

    • reportTypes.list 메서드의 새로운 includeSystemManaged 매개변수는 API 응답에 시스템 관리 보고서를 포함할지 여부를 나타냅니다. 매개변수의 기본값은 false입니다.

2016년 3월 28일

이제 YouTube Reporting API 및 YouTube Analytics API에서 몇 가지 추가 공유 서비스의 조회수 통계를 반환합니다.

  • YouTube Reporting API에서 sharing_service 측정기준은 다음과 같은 새로운 값을 지원합니다.
    • 82: iOS 시스템 활동 대화상자
    • 83: Google Inbox
    • 84: Android Messenger
  • YouTube Analytics API에서 sharingService 측정기준은 다음과 같은 새로운 값을 지원합니다.
    • ANDROID_MESSENGER: Android Messenger
    • INBOX: Google Inbox
    • IOS_SYSTEM_ACTIVITY_DIALOG: iOS 시스템 활동 대화상자

2016년 3월 16일

이 업데이트에는 YouTube Reporting API와 YouTube Analytics API 모두에 영향을 미치는 다음과 같은 변경사항이 포함되어 있습니다.

YouTube Reporting API

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

YouTube Analytics API

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

2016년 2월 8일

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

YouTube Reporting API를 사용하면 여전히 카드 측정항목을 가져올 수 있습니다. 이 API는 수많은 채널 및 콘텐츠 소유자 보고서에 대해 이러한 측정항목을 지원합니다.

2016년 1월 6일

이제 YouTube Reporting API와 YouTube Analytics API 모두 Chromecast 기기를 통해 발생하는 조회수를 구체적으로 식별합니다.

  • YouTube Reporting API에서 operating_system 측정기준은 21 값을 사용하여 Chromecast를 통해 발생하는 조회수를 식별합니다.
  • YouTube Analytics API에서 operatingSystem 측정기준은 CHROMECAST 값을 사용하여 Chromecast를 통해 발생하는 조회수를 식별합니다.

2015년 12월 21일

문서에서 annotation_clickable_impressions 및 annotation_closable_impressions 측정항목의 이름이 보고서에 반환되는 이름과 일치하도록 업데이트되었습니다. 이전에는 이름이 clickable_annotation_impressions 및 closable_annotation_impressions로 문서화되었습니다.

2015년 12월 18일

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

2015년 12월 15일

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

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

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

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

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

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

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

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

    예를 들어 사용자가 video 필터에 동영상 ID 20개를 나열하는 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 매개변수를 해당 값으로 설정하여 추가 결과를 가져옵니다.

2015년 11월 10일

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

2015년 10월 29일

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

  • YouTube Reporting API의 date 측정기준에 대한 문서가 태평양 표준시 (UTC-8) 오전 12시부터 시작되는 24시간을 기준으로 날짜를 참조하도록 수정되었습니다. 이전에는 문서에 날짜가 오전 12시(GMT)에 시작된다고 명시되어 있었습니다.

    또한 모든 날짜 관련 측정기준 (day, 7DayTotals, 30DayTotals, month)이 태평양 표준시 (UTC-8) 오전 12시부터 시작되는 날짜를 나타낸다는 점을 명시하도록 YouTube Analytics API 문서가 업데이트되었습니다.

  • YouTube Reporting API의 jobs.reports.list() 메서드가 이제 createdAfter 쿼리 매개변수를 지원합니다. 이 매개변수를 지정하면 API 응답에 백필된 데이터가 포함된 새 보고서를 포함하여 지정된 날짜 및 시간 이후에 생성된 보고서만 나열됩니다. 파라미터 값은 보고서가 생성된 시간과 관련이 있으며 반환된 데이터와 연결된 날짜와는 관련이 없습니다.

    파라미터 값은 RFC3339 UTC 'Zulu' 형식의 타임스탬프로, 마이크로초 수준의 정밀도를 나타냅니다. 예: "2015-10-02T15:01:23.045678Z"

    YouTube Reporting API 권장사항도 업데이트되어 createdAfter 매개변수를 사용하여 동일한 보고서를 반복적으로 처리하지 않는 방법을 설명합니다.

  • job 리소스의 createTime 속성과 report 리소스의 startTime, endTime, createTime 속성의 정의가 모두 수정되어 속성 값이 나노초가 아닌 마이크로초 단위로 정확하다는 점을 명시합니다. 또한 이제 모든 정의에서 속성 값이 타임스탬프임을 정확하게 반영합니다.

2015년 10월 8일

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

  • YouTube Analytics API의 sharingService 측정기준에 관한 문서가 업데이트되어 가능한 측정기준 값 목록이 포함되었습니다. 목록에는 새로 지원되는 여러 서비스가 포함되어 있습니다.

    새로 지원되는 값을 나열하도록 YouTube Reporting API의 sharing_service 측정기준 정의도 업데이트되었습니다. 59보다 큰 enum 값은 목록의 새 값입니다.

2015년 9월 24일

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

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

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

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

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

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

2015년 8월 20일

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

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

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

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

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

2015년 7월 22일

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

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

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

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

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

2015년 6월 1일

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

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

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

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

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

2015년 3월 31일

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

2015년 3월 16일

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

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

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

2015년 2월 25일

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

  • 이제 API는 YouTube 분석 그룹을 만들고 관리하는 기능과 해당 그룹의 보고서 데이터를 가져오는 기능을 지원합니다.

    • 그룹 만들기 및 관리

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

      • group 리소스는 최대 200개의 채널, 동영상, 재생목록 또는 저작물로 구성된 맞춤 컬렉션인 분석 그룹을 나타냅니다. API는 이 리소스에 대해 list, insert, update, delete 메서드를 지원합니다.
      • groupItem 리소스는 분석 그룹의 항목을 나타냅니다. API는 이 리소스에 대해 list, insert, delete 메서드를 지원합니다.

      예를 들어 groups.insert 메서드를 사용하여 그룹을 만든 다음 groupItems.insert 메서드를 사용하여 해당 그룹에 항목을 추가할 수 있습니다.

    • 그룹의 보고서 데이터 가져오기

      측정기준 문서가 업데이트되어 group 측정기준이 포함되었습니다. 이 측정기준은 많은 채널 보고서 및 콘텐츠 소유자 보고서의 필터로 사용할 수 있습니다. group 필터를 사용하면 API는 해당 그룹의 모든 항목에 대한 데이터를 반환합니다. 현재 API는 애셋 그룹에 대한 보고서를 만드는 기능을 지원하지 않습니다.

    YouTube 분석 그룹에 대한 자세한 내용은 YouTube 고객센터를 참고하세요.

2015년 2월 13일

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

  • API에서 더 이상 show 측정기준을 지원하지 않습니다.

2014년 8월 28일

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

  • 이제 API는 video, playlist, channel, show 측정기준이 필터로 사용될 때 이러한 측정기준에 여러 값을 지정하는 기능을 지원합니다. 여러 값을 지정하려면 filters 매개변수 값을 API 응답을 필터링할 동영상, 재생목록, 채널 또는 프로그램 ID의 쉼표로 구분된 목록으로 설정합니다. 파라미터 값은 최대 200개의 ID를 지정할 수 있습니다.

    동일한 필터에 여러 값을 지정하는 경우 요청에 지정하는 측정기준 목록에 해당 필터를 추가할 수도 있습니다. 필터가 특정 보고서에서 지원되는 측정기준으로 표시되지 않는 경우에도 마찬가지입니다. 측정기준 목록에 필터를 추가하면 API는 필터 값을 사용하여 결과를 그룹화합니다.

    이 기능에 관한 자세한 내용은 filters 매개변수 정의를 참고하세요.

2014년 7월 16일

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

  • 채널 보고서를 가져올 때 이제 ids 매개변수의 값을 channel==MINE로 설정하여 인증된 사용자의 채널에 대한 데이터를 가져올 수 있습니다. (ids 매개변수를 channel==CHANNEL_ID로 설정하여 지정된 채널의 데이터를 가져올 수도 있습니다.)

  • 이제 API에서 재생목록의 맥락에서 발생하는 동영상 조회수와 관련된 통계가 포함된 재생목록 보고서를 지원합니다. 재생목록 보고서는 채널 및 콘텐츠 소유자에게 제공됩니다.

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

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

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

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

  • 이제 API에서 시청 지속 시간 보고서를 지원합니다. 이 보고서는 동영상의 시청 지속 능력을 측정합니다. 보고서의 새로운 elapsedVideoTimeRatio 측정기준은 해당 측정항목 값에 대해 경과된 동영상 시간을 측정합니다.

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

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

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

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

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

    모든 새로운 측정항목은 핵심 측정항목이며 지원 중단 정책이 적용됩니다. 하지만 2013년 7월 16일부터 새 측정항목의 데이터를 사용할 수 있습니다. (annotationClickThroughRate 및 annotationCloseRate 측정항목의 데이터는 2012년 6월 10일부터 사용할 수 있습니다.)

  • GOOGLE_SEARCH은(는) 더 이상 insightTrafficSourceType 측정기준의 별도 값으로 보고되지 않습니다. 대신 Google 검색 결과에서 발생한 추천은 이제 EXT_URL 트래픽 소스 유형으로 분류됩니다. 따라서 insightTrafficSourceType 필터를 GOOGLE_SEARCH로 설정하는 insightTrafficSourceDetail 보고서를 더 이상 가져올 수 없습니다.

2014년 1월 31일

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

2014년 1월 16일

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

  • 샘플 요청 문서는 최근에 출시된 채널 및 콘텐츠 소유자 보고서와 유사한 탭 형식을 사용하여 예시를 카테고리로 그룹화하도록 재설계되었습니다. 새로운 디자인에서는 예시가 다음 카테고리로 그룹화됩니다.

    • 기본 통계
    • 시간 기준
    • 지역
    • 재생 위치
    • 트래픽 소스
    • 기기/운영체제
    • 인구통계
    • 소셜
    • 수입/광고 (콘텐츠 소유자 보고서 전용)

  • 이제 샘플 요청 문서에 채널 보고서 또는 콘텐츠 소유자 보고서에서 주별 데이터를 가져오는 새로운 예시가 포함됩니다.

    • 미국 주 및 워싱턴 D.C.의 주별 측정항목: 이 보고서는 채널 동영상의 조회수 및 기타 통계를 주별로 분류하여 검색합니다. 이 데이터는 미국 주와 워싱턴 D.C.를 포함합니다. 이 예에서는 province 측정기준을 사용하고 filters 매개변수를 사용하여 응답을 미국 결과만 포함하도록 제한합니다.

    • 캘리포니아의 시청자 인구통계 (연령대 및 성별): 이 보고서는 채널의 동영상 또는 콘텐츠 소유자 보고서의 경우 콘텐츠 소유자의 소유권 주장이 제기된 콘텐츠를 시청한 캘리포니아 시청자의 연령대 및 성별에 관한 통계를 검색합니다. 이 예시에서는 filters 매개변수를 사용하여 응답에 특정 지역의 데이터만 포함되도록 합니다.

  • province 측정기준의 정의가 업데이트되어 province가 dimensions 매개변수 값에 포함된 경우 요청은 filters 매개변수 값에 country==US를 포함하여 데이터를 미국으로 제한해야 합니다.

2014년 1월 6일

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

  • 지원되는 채널 및 콘텐츠 소유자 보고서가 나열된 문서가 새롭게 디자인되었습니다. 가능한 모든 보고서를 나열하는 표를 제공하는 대신 각 문서에서는 보고서를 카테고리로 그룹화합니다.

    • 기본 통계
    • 시간 기준
    • 지역
    • 재생 위치
    • 트래픽 소스
    • 기기/운영체제
    • 인구통계
    • 소셜
    • 인기 동영상

    각 문서에는 이러한 카테고리가 탭 목록으로 표시되며, 탭을 클릭하면 해당 카테고리에서 지원되는 보고서를 확인할 수 있습니다.

  • 이제 API에서 세 가지 새로운 지리적 측정기준(province, continent, subContinent)을 지원합니다.

    • province 측정기준을 사용하면 미국 주 및 컬럼비아 특별구의 통계를 가져올 수 있습니다. API는 이 측정기준에 대해 두 가지 용도를 지원합니다.

      • 이 API는 주별로 통계를 분류하는 두 가지 보고서를 지원합니다. 두 보고서는 채널과 콘텐츠 소유자 모두 사용할 수 있습니다.

        • 주요 통계 보고서는 조회수, 예상 시청 시간(분)을 비롯한 여러 통계를 제공합니다.
        • 시간 기반 보고서는 동일한 통계를 제공하지만 일별, 7일, 30일 또는 월별로 데이터를 집계합니다.

      • filters 쿼리 매개변수를 사용하여 특정 상태의 통계만 포함하도록 보고서를 제한할 수 있습니다. 지역 보고서, 재생 위치 보고서, 트래픽 소스 보고서, 기기 보고서, 운영체제 보고서, 인구통계 보고서, 인기 동영상 보고서 등 여러 보고서에서 이 유형의 필터링을 지원합니다.

    • continent 측정기준은 대륙을 식별하는 UN 통계 지역 코드를 지정합니다. 이 측정기준은 필터로만 사용할 수 있습니다.

    • subContinent 측정기준은 대륙의 하위 지역을 식별하는 UN 통계 지역 코드를 지정합니다. 이 측정기준은 필터로만 사용할 수 있습니다.

      각 하위 지역은 하나의 대륙에만 연결되므로 subContinent 필터를 사용할 때 continent 필터를 사용할 필요가 없습니다. (실제로 요청에서 두 측정기준을 모두 사용하면 API에서 오류를 반환합니다.)

  • insightTrafficSourceDetail 측정기준에 insightTrafficSourceType 값 PROMOTED가 유효한 필터 값으로 포함되지 않도록 문서가 수정되었습니다.

2013년 9월 30일

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

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

  • 이제 API에서 insightPlaybackLocationType 측정기준의 값으로 EXTERNAL_APP를 지원합니다. 이 업데이트와 함께 2013년 9월 10일부터 재생은 더 이상 MOBILE 재생으로 분류되지 않지만, 해당 날짜 이전에 발생한 모바일 재생은 여전히 해당 값으로 분류됩니다.

    이번 업데이트를 통해 모바일 재생은 재생이 발생하는 애플리케이션 유형에 따라 WATCH, EMBEDDED 또는 EXTERNAL_APP 재생으로 분류됩니다.

  • 이제 API에서 insightTrafficSourceType 측정기준의 값으로 PLAYLIST를 지원합니다. 이 값은 동영상 조회수가 재생목록에서 참조되었음을 나타냅니다. 이전에는 이러한 조회수가 측정기준의 YT_OTHER_PAGE 카테고리를 사용하여 분류되었습니다.

2013년 7월 16일

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

  • 이제 API에서 여러 측정기준과 측정항목을 기준으로 보고서를 정렬하는 기능을 지원합니다. 샘플 요청 문서에는 이 기능을 보여주는 새로운 예인 여러 측정기준/측정항목별로 요청 정렬이 포함되어 있습니다. 요청은 트래픽 소스 데이터를 가져오며 sort 파라미터 값은 day,-views입니다. 결과는 시간순으로 정렬되지만 하루의 결과 집합에서는 첫째 행에 조회수가 제일 높은 트래픽 소스 데이터를 포함하고 둘째 행에 그 다음으로 조회수가 높은 소스의 데이터를 포함하는 등 조회수가 높은 순서로 포함합니다.

  • 이제 API에서 두 가지 새로운 측정기준인 deviceType 및 operatingSystem를 지원합니다. 이 측정기준을 사용하면 시청자가 동영상을 시청하는 기기에 관한 데이터를 가져올 수 있습니다. API는 측정 기준 하나를 사용하거나 둘 다 사용하는 보고서를 지원합니다.

    • deviceType 보고서를 사용하면 데스크톱, 모바일, 태블릿 기기를 비롯한 다양한 유형의 기기에 대한 조회수와 예상 시청 시간을 가져올 수 있습니다. operatingSystem 필터를 사용하여 Android 또는 iOS와 같은 특정 운영체제를 실행하는 기기의 통계만 포함하도록 기기 유형 보고서를 제한할 수도 있습니다.

    • operatingSystem 보고서를 사용하면 Android, iOS, Linux 등 다양한 운영체제의 조회수와 예상 시청 시간을 가져올 수 있습니다. deviceType 필터를 사용하여 운영체제 보고서에 휴대기기 또는 태블릿과 같은 특정 유형의 기기에 대한 통계만 포함하도록 제한할 수도 있습니다.

    새 기기 유형 및 운영체제 보고서는 채널 및 콘텐츠 소유자에 대해 사용할 수 있습니다.

  • 샘플 요청 문서가 업데이트되어 채널에 대한 기기 보고서 3개와 콘텐츠 소유자에 대한 기기 보고서 3개를 포함합니다.

  • insightPlaybackLocationType 측정기준은 측정기준의 다른 값 중 하나를 사용하여 분류되지 않은 조회수를 식별하는 YT_OTHER 값을 반환할 수 있습니다.

2013년 5월 23일

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

  • 수익이 가장 높은 동영상을 식별하기 위해 수익 내림차순으로 인기 동영상 보고서를 정렬할 수 있음을 반영하도록 콘텐츠 소유자 보고서 문서가 업데이트되었습니다. 이 보고서는 사용자 활동 및 수익 보고서 섹션의 두 번째 표에 나열된 첫 번째 보고서입니다.

2013년 5월 10일

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

2013년 5월 6일

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

  • 이제 API에서 시청 시간 측정항목(estimatedMinutesWatched, averageViewDuration, averageViewPercentage)을 조회 측정항목, 참여도 측정항목, 수입 측정항목, 광고 실적 측정항목 등 다른 측정항목과 함께 가져올 수 있습니다.

    이 변경사항을 반영하기 위해 사용 가능한 채널 보고서 및 콘텐츠 소유자 보고서 목록이 업데이트되었습니다. (시청 시간 측정항목이 다른 보고서의 일부로 검색되므로 실제 목록은 짧습니다.)

    샘플 API 요청 문서도 업데이트되었습니다.

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

    • 이제 선택적 country 필터를 지원합니다.

    • 이제 콘텐츠 소유자는 다음의 새로운 filter 조합을 사용하여 이러한 보고서를 검색할 수 있습니다. 이러한 모든 조합은 선택적 country 필터도 지원합니다.

      • 재생 위치 세부정보

        • channel,insightPlaybackLocationType==EMBEDDED
        • show,insightPlaybackLocationType==EMBEDDED
        • claimedStatus,insightPlaybackLocationType==EMBEDDED
        • uploaderType,insightPlaybackLocationType==EMBEDDED
        • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

      • 트래픽 소스 세부정보

        • channel,insightTrafficSourceType
        • show,insightTrafficSourceType
        • claimedStatus,insightTrafficSourceType
        • uploaderType,insightTrafficSourceType
        • uploaderType,claimedStatus,insightTrafficSourceType

2013년 5월 3일

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

  • 새로운 샘플 API 요청 문서에는 YouTube Analytics API를 사용하여 다양한 유형의 보고서를 가져오는 방법을 보여주는 예시가 나와 있습니다. 각 예시에는 요청이 검색하는 보고서에 대한 간략한 설명이 포함되어 있으며 요청의 측정기준, 측정항목, 필터, 정렬 매개변수가 표시됩니다.

  • 이제 insightTrafficSourceType 측정기준에서 SUBSCRIBER를 유효한 값으로 지원합니다. 이 값은 YouTube 홈페이지의 피드 또는 YouTube 구독 기능에서 추천된 동영상 조회수를 나타냅니다. 이 트래픽 소스를 기준으로 필터링하면 insightTrafficSourceDetail 필드에 홈페이지 피드 또는 조회수가 참조된 다른 페이지가 지정됩니다.

2013년 3월 28일

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

2013년 3월 21일

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

  • 이제 API에서 수입 및 광고 실적 측정항목과 새로운 광고 실적 보고서를 지원합니다. YouTube 파트너 프로그램에 참여하는 YouTube 콘텐츠 파트너만 측정항목과 보고서에 액세스할 수 있습니다.

    • 새로 지원되는 보고서는 재생 기반 광고 실적 측정항목과 노출 기반 광고 실적 측정항목을 지원합니다. 광고 실적 보고서에 대한 자세한 내용은 콘텐츠 소유자 보고서 문서를 참조하세요.

    • 새로 지원되는 측정항목은 다음과 같습니다. 콘텐츠 소유자 보고서 목록이 업데이트되어 아래 측정항목을 지원하는 2개의 새 보고서를 비롯해 여러 보고서를 확인할 수 있습니다.

      • earnings – Google에서 판매하는 모든 광고 소스에서 발생한 총 예상 수입입니다.
      • grossRevenue – Google 또는 DoubleClick 파트너의 예상 총수익입니다.
      • primaryAdGrossRevenue – 보고서에 포함된 동영상 재생의 기본 광고 유형으로 합산 및 분류된 Google 또는 DoubleClick 파트너의 예상 총수익입니다.
      • monetizedPlaybacks – 하나 이상의 광고 노출이 표시된 재생 횟수입니다.
      • playbackBasedCpm – 재생 1,000회당 예상 총수익입니다.
      • impressions – 게재된 확인된 광고 노출수입니다.
      • impressionBasedCpm – 광고 노출 1,000회당 예상 총수익입니다.

      참고: 보다 자세한 내용은 측정항목 정의를 참조하세요.

    • 수입 또는 광고 실적 측정항목을 가져오는 모든 요청은 새 https://www.googleapis.com/auth/yt-analytics-monetary.readonly 범위를 사용하여 액세스 권한을 부여하는 승인 토큰을 전송해야 합니다.

  • 다양한 유형의 보고서가 별도의 페이지에 설명되도록 API 참고 리소스가 재구성되었습니다. 따라서 이제 다른 유형의 채널 보고서 및 콘텐츠 소유자 보고서를 설명하는 별도의 페이지가 있습니다.

2013년 2월 4일

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

  • 이제 API 참조 가이드에 예시 섹션이 있으며, 여기에는 Java, JavaScript, Python, Ruby 클라이언트 라이브러리를 사용하여 API를 호출하는 방법을 보여주는 코드 샘플이 포함되어 있습니다. JavaScript 코드 샘플은 샘플 애플리케이션 문서에서 자세히 설명한 것과 동일합니다.

2012년 11월 14일

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

  • 이제 API 참조 가이드에 APIs Explorer가 포함되어 API를 호출하고, API 요청을 확인하고, 응답에서 실제 데이터를 가져올 수 있습니다.

  • 이 API는 채널과 콘텐츠 소유자 모두를 위한 여러 새로운 보고서를 지원하며, 이에 대한 설명은 아래와 같습니다. 각 보고서는 채널 보고서 또는 콘텐츠 소유자 보고서로 제공됩니다. 측정기준 및 측정항목 페이지도 이에 따라 업데이트되었습니다.

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

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

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

    • 트래픽 소스 세부정보 보고서는 지정된 동영상 및 지정된 트래픽 소스 유형에 대해 가장 많은 조회수를 생성한 리퍼러를 식별합니다. 예를 들어 이 보고서는 특정 동영상으로 가장 많은 트래픽을 보낸 관련 동영상을 보여줄 수 있습니다. 여러 가지 트래픽 소스에 대해 지원되는 보고서입니다.

    • 시청 시간 보고서는 시청자가 내 콘텐츠를 시청한 시간을 보여줍니다. 보고서는 특정 기간(일, 이전 7일, 이전 30일 등) 또는 국가의 데이터를 집계할 수 있습니다. 보고서에서 날짜 또는 국가별로 데이터를 집계하는 경우 각 동영상 조회수의 평균 길이와 사용자가 시청한 각 동영상의 평균 비율도 지정할 수 있습니다.

2012년 10월 2일

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

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

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

2012년 9월 12일

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

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

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

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

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

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

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

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