이 페이지는 Cloud Translation API를 통해 번역되었습니다.

업데이트 기록
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이 페이지에는 YouTube Data API (v3) 변경사항 및 문서 업데이트가 표시됩니다. 이 변경 로그를 구독하세요.

2025년 3월 26일

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

2025년 3월 31일부터 Data API의 다음 필드에서 이 변경사항에 따라 Shorts 동영상의 조회수를 반환합니다.

channels.statistics.viewCount
videos.statistics.viewCount

2024년 10월 30일

이제 API에서 사실적인 변경되었거나 합성된 (A/S) 콘텐츠가 포함된 동영상을 식별하는 기능을 지원합니다. A/S 콘텐츠와 관련된 YouTube 정책을 자세히 알아보세요.

A/S 콘텐츠의 예로는 다음과 같은 동영상이 있습니다.

실제 인물이 실제로 하지 않은 말이나 행동을 한 것처럼 보이게 만듦
실제 사건 또는 장소의 영상을 변경
실제로는 발생하지 않았으나 진짜처럼 보이는 장면을 생성

동영상에 A/S 콘텐츠가 포함되어 있는지 나타내려면 status.containsSyntheticMedia 속성을 설정하세요. 이 속성은 videos.insert 또는 videos.update 메서드를 호출할 때 설정할 수 있습니다. 설정된 경우 이 속성은 video 리소스로 반환됩니다.

2024년 4월 30일

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

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

API에서 더 이상 채널 토론을 삽입하거나 검색하는 기능을 지원하지 않습니다. 이번 변경사항은 채널에 댓글을 게시하는 기능을 지원하지 않는 YouTube 웹사이트에서 지원되는 기능과 일치합니다.

2024년 3월 13일

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

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

captions.insert 및 captions.update 메서드의 sync 매개변수가 지원 중단되었습니다. 2024년 4월 12일부터 이 매개변수에 대한 YouTube 지원이 중단됩니다.

이번 변경으로 인해 개발자는 자막 트랙을 삽입하거나 업데이트할 때 타이밍 정보를 포함해야 합니다. 그렇지 않으면 업로드가 실패합니다.

2024년 3월 12일

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

snippet.name 필드의 최대 허용 길이가 150자(영문 기준)임을 명시하도록 captions 리소스의 문서가 업데이트되었습니다. 트랙 이름이 이보다 길면 API는 nameTooLong 오류를 반환합니다.

2024년 3월 7일

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

channel 리소스 속성 brandingSettings.channel.moderateComments가 지원 중단되었습니다. 2024년 3월 7일부터 YouTube에서 이 매개변수 지원이 중단됩니다.

2024년 1월 31일

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

channels.list 메서드의 새 forHandle 매개변수를 사용하면 YouTube 핸들을 지정하여 채널에 관한 정보를 검색할 수 있습니다.

2023년 11월 9일

videoId 리소스가 API 호출을 사용하여 반환되지 않으므로 Comments 아래의 videoId 리소스에 대한 모든 참조가 삭제되었습니다.

2023년 9월 12일

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

comments.markAsSpam 메서드는 수년 동안 지원 중단되었습니다. 이 메서드는 이미 YouTube에서 지원되지 않으며 API를 통해 더 이상 지원되지 않습니다.

comments.markAsSpam 메서드를 참조하는 모든 문서에 지원 중단 알림이 추가되었습니다.

2023년 8월 22일

이제 search.list 메서드에서 videoPaidProductPlacement 매개변수를 지원합니다. 이 매개변수를 사용하면 크리에이터가 유료 프로모션이 있다고 표시한 동영상만 포함하도록 검색 결과를 필터링할 수 있습니다.

2023년 8월 18일

YouTube Data API가 반환하는 동시 시청자 수가 YouTube 분석을 통해 확인할 수 있는 처리되고 스팸이 제거된 동시 시청자 수와 다를 수 있음을 나타내도록 video 리소스의 liveStreamingDetails.concurrentViewers 정의가 업데이트되었습니다. YouTube 고객센터에서 라이브 스트리밍 측정항목에 대해 자세히 알아보세요.

2023년 8월 7일

2023년 6월 12일에 발표된 대로 search.list 메서드의 relatedToVideoId 매개변수가 지원 중단되었습니다. 이 매개변수는 더 이상 지원되지 않으며 API 문서에서 이 매개변수에 대한 참조가 삭제되었습니다.

2023년 6월 28일

이제 thumbnails.set 메서드에서 uploadRateLimitExceeded 오류를 지원합니다. 이 오류는 채널이 지난 24시간 동안 썸네일을 너무 많이 업로드했으며 나중에 다시 시도해야 함을 나타냅니다.

2023년 6월 12일

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

search.list 메서드의 relatedToVideoId 매개변수가 지원 중단되었습니다. YouTube는 2023년 8월 7일부터 이 매개변수 지원을 중단합니다.

현재 search.list 메서드 문서에 지원 중단 알림이 추가되었습니다. 이 매개변수는 2023년 8월 7일 이후에 search.list 문서에서 완전히 삭제됩니다.

또한 관련 동영상을 검색하는 방법을 보여주는 예시가 API 구현 가이드에서 삭제되었습니다.

2022년 8월 22일

video.statistics 필드의 유형 주석을 문자열에서 unsigned long으로 수정했습니다.

2022년 8월 5일

YouTube는 캡션 ID가 생성되는 방식을 변경했으며, 그 일환으로 모든 캡션 트랙에 새 캡션 ID를 할당하고 있습니다. 이 변경사항은 caption_id 값을 저장하는 애플리케이션의 경우 이전 버전과 호환되지 않을 수 있지만 caption_id 값을 저장하지 않는 애플리케이션에는 영향을 미치지 않습니다.

지금부터 2022년 12월 1일까지 captions.list, captions.update, captions.download, captions.delete 메서드는 이전 자막 트랙 ID와 새 자막 트랙 ID를 모두 지원합니다. 하지만 2022년 12월 1일부터 YouTube에서 이전 자막 트랙 ID를 지원하지 않습니다. 이때 이전 자막 트랙 ID로 이러한 API 메서드를 호출하면 captionNotFound 오류가 발생합니다.

이 변경사항에 대비하려면 지금부터 2022년 12월 1일 사이에 저장된 모든 자막 트랙 데이터를 완전히 대체할 계획을 세워야 합니다. 즉, 자막 트랙 데이터를 저장하는 동영상의 경우 현재 저장된 데이터를 삭제한 다음 captions.list 메서드를 호출하여 동영상의 현재 자막 트랙 세트를 가져와 평소와 같이 API 응답에 데이터를 저장해야 합니다.

2022년 7월 12일

YouTube API 서비스 약관이 업데이트되었습니다. 자세한 내용은 YouTube API 서비스 서비스 약관 - 개정 내역을 참고하세요.

2022년 4월 27일

업로드된 동영상의 최대 파일 크기가 128GB에서 256GB로 늘어났다는 내용을 반영하도록 videos.insert 메서드 설명이 업데이트되었습니다.

2022년 4월 8일

API에서 반환하는 최대 구독자 수가 제한될 수 있음을 나타내도록 subscriptions.list 메서드의 myRecentSubscribers 및 mySubscribers 매개변수 정의가 모두 업데이트되었습니다. 이 변경사항은 API 동작의 변경이 아니라 문서 수정사항을 나타냅니다.

2021년 12월 15일

2021년 11월 18일에 발표된 대로 전체 YouTube 플랫폼에서 동영상 싫어요 수를 비공개로 변경하는 변경사항과 함께 video 리소스의 statistics.dislikeCount 속성이 이제 비공개로 설정됩니다.

이 변경사항에 대한 자세한 내용은 YouTube 공식 블로그를 참고하세요.

2021년 11월 18일

YouTube 플랫폼 전체에서 동영상 싫어요 수를 비공개로 변경과 함께 2021년 12월 13일부터 video 리소스의 statistics.dislikeCount 속성이 비공개로 전환됩니다. 즉, API 요청이 동영상 소유자가 인증한 경우에만 videos.list 엔드포인트의 API 응답에 속성이 포함됩니다.

videos.rate 엔드포인트는 이 변경사항의 영향을 받지 않습니다.

싫어요 수를 공개적으로 표시하지 않지만 API 클라이언트에 싫어요 수가 필요한 개발자는 예외를 위해 허용 목록에 추가해 달라고 신청할 수 있습니다. 예외를 신청하려면 이 신청 양식을 작성해야 합니다.

이 변경사항에 대한 자세한 내용은 YouTube 공식 블로그를 참고하세요.

2021년 7월 2일

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

commentThreads.update 엔드포인트는 지원 중단되었으며 더 이상 지원되지 않습니다. 이 엔드포인트는 다른 API 엔드포인트를 통해 제공되는 기능을 중복합니다. 대신 comments.update를 호출할 수 있습니다.

메서드를 호출하고 코드에 commentThreads 리소스가 필요한 경우 commentThreads.list 메서드를 다시 호출합니다.

2021년 7월 1일

YouTube API 서비스를 사용하는 모든 개발자는 기본 할당량인 10,000개를 초과하는 할당량을 받으려면 API 규정 준수 감사를 완료해야 합니다. 지금까지 규정 준수 감사 절차와 추가 할당량 단위 할당 요청은 개발자가 YouTube API 서비스 - 감사 및 할당량 확장 양식을 작성하고 제출하는 방식으로 진행되었습니다.

이러한 절차를 명확히 하고 Google API 서비스를 사용하는 개발자의 요구사항을 더 잘 충족하기 위해 새로운 양식 3개와 양식 작성 가이드를 추가합니다.

감사를 통과한 개발자 요청 양식: 이미 API 규정 준수 감사를 통과한 개발자는 이 간단한 양식을 작성하여 제출하여 할당된 할당량 연장을 요청할 수 있습니다.
이의신청 양식: API 프로젝트가 규정 준수 감사를 통과하지 못했거나 할당량 단위 증가가 거부된 개발자는 이 양식을 작성하여 제출할 수 있습니다.
지배권 변경 양식: API 프로젝트와 관련하여 지배권 변경 (예: 주식 매입 또는 매각, 합병 또는 기타 형태의 기업 거래)이 발생한 개발자 또는 개발자를 대신하여 API 클라이언트를 운영하는 당사자는 이 양식을 작성하여 제출해야 합니다. 이를 통해 YouTube API팀은 기록을 업데이트하고, 새 API 프로젝트의 사용 사례 규정 준수를 감사하며, 개발자의 현재 할당량을 검증할 수 있습니다.

새로운 양식을 제출하면 YouTube API를 어떻게 사용할지 알려주실 수 있으며, 이를 통해 YouTube에서 더 나은 지원을 제공할 수 있습니다.

자세한 내용은 새로운 API 규정 준수 감사 가이드를 참고하세요.

2021년 5월 12일

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

이 업데이트에서는 다음과 같은 API 변경사항을 다룹니다.

channel 리소스의 contentDetails.relatedPlaylists.favorites 속성이 지원 중단되었습니다. 즐겨찾는 동영상 기능은 2016년 4월 28일 버전 기록 항목에 설명된 대로 이미 수년 동안 지원 중단되었습니다.

이 업데이트 전에는 API 클라이언트가 존재하지 않는 즐겨찾기 재생목록에 동영상을 추가하려고 시도해도 API에서 새 재생목록을 만들었습니다. 앞으로는 이 경우 재생목록이 생성되지 않으며 API가 오류를 반환합니다. 항목을 추가, 수정 또는 삭제하여 즐겨찾기 재생목록을 수정하려고 시도하는 것도 이전 공지사항에 따라 모두 지원 중단되었으며 언제든지 오류가 반환될 수 있습니다.
다음 channel 리소스 속성은 지원 중단되었습니다. 이러한 속성은 이미 YouTube 스튜디오 UI 및 YouTube에서 지원되지 않습니다. 따라서 API를 통한 지원도 더 이상 제공되지 않습니다.
- brandingSettings.channel.defaultTab
- brandingSettings.channel.featuredChannelsTitle
- brandingSettings.channel.featuredChannelsUrls[]
- brandingSettings.channel.profileColor
- brandingSettings.channel.showBrowseView
- brandingSettings.channel.showRelatedChannels
모든 속성이 channel 리소스 표현에서 삭제되었으며 정의는 리소스의 속성 목록에서 삭제되었습니다. 또한 이러한 속성과 관련된 오류가 메서드별 문서에서 삭제되었습니다.
다음 channelSection 리소스 속성은 지원 중단되었습니다. 이러한 속성은 이미 YouTube 스튜디오 UI 및 YouTube에서 지원되지 않습니다. 따라서 API를 통한 지원도 더 이상 제공되지 않습니다.
- snippet.style
- snippet.defaultLanguage
- snippet.localized.title
- localizations
- localizations.(key)
- localizations.(key).title
- targeting
- targeting.languages[]
- targeting.regions[]
- targeting.countries[]
이 변경사항과 함께 channelSection.list 메서드의 hl 매개변수도 지원하는 기능이 지원되지 않으므로 지원 중단되었습니다.

모든 속성이 channelSection 리소스 표현에서 삭제되었으며 정의는 리소스의 속성 목록에서 삭제되었습니다. 또한 이러한 속성과 관련된 오류가 메서드별 문서에서 삭제되었습니다.
channelSection 리소스의 snippet.type 속성의 경우 다음 값이 지원 중단되었습니다. 이러한 값은 이미 YouTube 채널 페이지에서 지원되지 않으므로 API를 통한 지원도 더 이상 제공되지 않습니다.
- likedPlaylists
- likes
- postedPlaylists
- postedVideos
- recentActivity
- recentPosts
playlist 리소스의 snippet.tags[] 속성이 지원 중단되었습니다. 이 속성은 이미 YouTube에서 지원되지 않으므로 API를 통해 더 이상 지원되지 않습니다.

2021년 2월 9일

playlistItem 리소스는 다음 두 가지 새 속성을 지원합니다.

snippet.videoOwnerChannelId 속성은 재생목록 동영상을 업로드한 채널의 ID를 식별합니다.
snippet.videoOwnerChannelTitle 속성은 재생목록 동영상을 업로드한 채널의 이름을 식별합니다.

2021년 1월 28일

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

playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list, playlists.update 메서드는 모두 새 playlistOperationUnsupported 오류를 지원합니다. 이 오류는 요청이 특정 재생목록에 허용되지 않는 작업을 실행하려고 할 때 발생합니다. 예를 들어 사용자는 업로드한 동영상 재생목록에서 동영상을 삭제하거나 재생목록 자체를 삭제할 수 없습니다.

이 오류는 항상 400 HTTP 응답 코드 (잘못된 요청)를 반환합니다.
playlistItems.list 메서드의 watchHistoryNotAccessible 및 watchLaterNotAccessible 오류가 문서에서 삭제되었습니다. 사용자의 시청 기록 및 나중에 볼 목록은 API를 통해 액세스할 수 없지만 이러한 특정 오류는 API에서 반환되지 않습니다.

2020년 10월 15일

개발자 정책에 다음과 같은 두 가지 새로운 섹션이 추가되었습니다.

새로운 섹션 III.E.4.i에서는 YouTube 삽입 플레이어를 통해 수집 및 전송되는 데이터에 관한 추가 정보를 제공합니다. 사용자가 재생 의도를 나타내기 위해 플레이어와 상호작용하기 전에 YouTube 삽입 플레이어를 통해 Google에 전송하는 모든 사용자 데이터에 대한 책임은 개발자에게 있습니다. 자동재생을 false로 설정하여 사용자가 플레이어와 상호작용하기 전에 YouTube와 공유되는 데이터를 제한할 수 있습니다.
새 섹션 III.E.4.j는 콘텐츠를 사이트 및 앱에 삽입하기 전에 콘텐츠의 아동용 (MFK) 상태를 확인하는 것과 관련이 있습니다. API 클라이언트에 삽입하는 동영상이 아동용인지 여부를 확인하고 삽입된 플레이어에서 수집된 데이터를 적절하게 처리하는 것은 개발자의 책임입니다. 따라서 YouTube 삽입 플레이어를 통해 API 클라이언트에 콘텐츠를 삽입하기 전에 YouTube Data API 서비스를 사용하여 콘텐츠의 상태를 확인해야 합니다.

새로운 동영상의 아동용 설정 상태 확인 가이드에서는 YouTube Data API 서비스를 사용하여 동영상의 아동용 설정 상태를 조회하는 방법을 설명합니다.

이러한 변경사항과 함께 삽입된 플레이어 매개변수 문서에 자동재생을 사용 설정하면 플레이어와 사용자 상호작용 없이 재생이 이루어지며 따라서 페이지가 로드될 때 재생 데이터 수집 및 공유가 이루어진다는 알림이 추가되었습니다.

2020년 10월 8일

이 업데이트는 channel 리소스와 관련된 세 가지 사소한 변경사항을 다룹니다.

채널의 썸네일 이미지를 식별하는 snippet.thumbnails 객체는 새로 만든 채널의 경우 비어 있을 수 있으며 채우는 데 최대 1일이 걸릴 수 있습니다.
statistics.videoCount 속성은 소유자에게도 채널의 공개 동영상 수만 반영합니다. 이 동작은 YouTube 웹사이트에 표시되는 수치와 일치합니다.
brandingSettings.channel.keywords 속성에서 식별되는 채널 키워드는 허용되는 최대 길이인 500자를 초과하거나 이스케이프 처리되지 않은 따옴표 (")가 포함된 경우 잘릴 수 있습니다. 500자 제한은 키워드별 제한이 아니라 모든 키워드의 총 길이에 대한 제한입니다. 이 동작은 YouTube 웹사이트의 동작과 일치합니다.

2020년 9월 9월

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

이 업데이트에서는 다음과 같은 API 변경사항을 다룹니다. 모든 변경사항은 이 공지사항이 게시된 날인 2020년 9월 9일부터 적용됩니다. 따라서 개발자는 더 이상 아래에 나열된 API 기능을 사용해서는 안 됩니다.

다음 API 리소스, 메서드, 매개변수, 리소스 속성은 즉시 지원 중단되며 이 공지사항 날짜 이후에 작동하지 않습니다.
- 다음 channel 리소스 속성:
  - statistics.commentCount 속성
  - brandingSettings.image 객체 및 모든 하위 속성
  - brandingSettings.hints 목록 및 모든 하위 속성
- channels.list 메서드의 categoryId 필터 매개변수
- guideCategories 리소스 및 guideCategories.list 메서드
API 요청에서 managedByMe 매개변수를 true로 설정하면 channels.list 메서드의 API 응답에 더 이상 prevPageToken 속성이 포함되지 않습니다. 이 변경사항은 다른 channels.list 요청의 prevPageToken 속성에 영향을 미치지 않으며 모든 요청의 nextPageToken 속성에도 영향을 미치지 않습니다.
channel 리소스의 contentDetails.relatedPlaylists.watchLater 및 contentDetails.relatedPlaylists.watchHistory 속성은 2016년 8월 11일에 모두 지원 중단된 것으로 발표되었습니다. 이러한 재생목록에 대한 playlistItems.insert 메서드 및 playlistItems.delete 메서드의 지원도 이제 완전히 지원 중단되었으며 두 속성은 문서에서 삭제되었습니다.
2013년 7월 30일에 지원 중단된 것으로 발표된 channels.list 메서드의 mySubscribers 매개변수가 문서에서 삭제되었습니다. subscriptions.list 메서드와 mySubscribers 매개변수를 사용하여 인증된 사용자의 채널 구독자 목록을 가져옵니다.
2017년 11월 27일에 지원 중단된 것으로 발표된 channel 리소스의 invideoPromotion 객체와 모든 하위 속성이 문서에서 삭제되었습니다.

2020년 7월 29일

part 매개변수와 관련된 추가 비용을 삭제하여 API 요청에 대한 할당량 청구 절차를 간소화했습니다. 즉시 호출된 메서드의 기본 비용만 청구됩니다. 간소화된 할당량에 대한 자세한 내용은 여기를 참고하세요.

이번 변경사항의 영향으로 대부분의 API 호출은 할당량 비용이 약간 낮아지지만 일부 API 호출은 여전히 동일한 비용이 청구됩니다. 이번 변경사항으로 API 호출 비용이 증가하지는 않습니다. 전반적으로 예상되는 영향은 Google Cloud 콘솔에서 확인할 수 있는 할당된 할당량이 조금 더 늘어날 수 있다는 것입니다.

모든 개발자는 YouTube API 서비스에 계속 액세스할 수 있도록 프로젝트에 대한 규정 준수 감사를 완료하는 것이 좋습니다.

이 버전 기록 항목은 2020년 7월 20일에 처음 게시되었습니다.

2020년 7월 28일

2020년 7월 28일 이후에 생성된 확인되지 않은 API 프로젝트의 videos.insert 엔드포인트를 통해 업로드된 모든 동영상은 비공개 보기 모드로 제한됩니다. 이 제한을 해제하려면 각 프로젝트에서 서비스 약관 준수를 확인하기 위한 감사를 받아야 합니다.

확인되지 않은 API 클라이언트를 사용하여 동영상을 업로드하는 크리에이터에게는 동영상이 비공개로 잠겼으며 공식 또는 감사 클라이언트를 사용하면 제한을 피할 수 있다는 내용의 이메일이 전송됩니다.

2020년 7월 28일 이전에 생성된 API 프로젝트는 현재 이 변경사항의 영향을 받지 않습니다. 하지만 모든 개발자는 YouTube API 서비스에 계속 액세스할 수 있도록 프로젝트에 대해 규정 준수 감사를 완료하는 것이 좋습니다.

2020년 7월 21일

[2020년 7월 28일 업데이트] 이 버전 기록 항목에 언급된 문서 업데이트는 2020년 7월 28일에 다시 게시되었습니다.

어제 할당량 청구 절차와 관련된 문서 업데이트를 게시했습니다. 하지만 예상치 못한 상황으로 인해 할당량 변경이 아직 적용되지 않았습니다. 이에 따라 정확성을 위해 문서가 되돌려졌습니다. 혼란을 피하기 위해 변경사항을 설명하는 버전 기록 항목이 삭제되었으며 곧 다시 게시될 예정입니다.

2020년 7월 7일

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

videos.insert 메서드의 autoLevels 및 stabilize 매개변수가 지원 중단되었으며 두 매개변수 모두 문서에서 삭제되었습니다. 이 값은 무시되며 새로 업로드된 동영상이 처리되는 방식에 영향을 미치지 않습니다.

2020년 6월 15일

새로운 YouTube 개발자 정책 준수 가이드에서는 API 클라이언트가 YouTube API 서비스 약관 및 정책 (API 서비스 약관)의 특정 부분을 준수하도록 하는 데 도움이 되는 안내와 예시를 제공합니다.

이 가이드는 YouTube에서 API 서비스 약관의 특정 측면을 시행하는 방법을 설명하지만 기존 문서를 대체하지는 않습니다. 이 가이드에서는 개발자가 API 규정 준수 감사 중에 가장 자주 묻는 질문을 다룹니다. 이 가이드가 Google에서 정책을 해석하고 시행하는 방식을 이해하는 데 도움이 되어 기능 개발 프로세스를 간소화하는 데 도움이 되기를 바랍니다.

2020년 6월 4일

참고: 이전 지원 중단 공지사항의 업데이트입니다.

채널 게시판 기능이 이제 완전히 지원 중단되었습니다. 이 변경사항은 2020년 4월 17일에 처음 공지되었으며 이제 적용되었습니다. 이에 따라 activities.insert 메서드가 더 이상 지원되지 않으며 activities.list 메서드가 더 이상 채널 게시판을 반환하지 않습니다. 자세한 내용은 YouTube 고객센터를 참고하세요.

2020년 4월 17일

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

YouTube에서 채널 게시판 기능을 지원 중단합니다. 이에 따라 activities.insert 메서드는 지원 중단되고 activities.list 메서드는 채널 게시판을 반환하지 않습니다. 이 변경사항은 2020년 5월 18일부터 API에 적용됩니다. 자세한 내용은 YouTube 고객센터를 참고하세요.

2020년 3월 31일

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

새로운 리소스 및 메서드
- 새 member 리소스는 YouTube 채널의 채널 회원을 나타냅니다. 회원이 크리에이터에게 정기적으로 금전적 지원을 제공하고 특별한 혜택을 받습니다. 예를 들어 크리에이터가 채팅에 회원 전용 모드를 사용 설정하면 회원이 채팅할 수 있습니다.
  
  이 리소스는 YouTube Live Streaming API의 일부로 문서화된 sponsor 리소스를 대체합니다. 이제 sponsor 리소스가 지원 중단되었으며 API 클라이언트는 sponsors.list 메서드 호출을 업데이트하여 members.list 메서드를 대신 사용해야 합니다.
- 새 membershipsLevel 리소스는 API 요청을 승인한 크리에이터가 관리하는 가격 책정 수준을 식별합니다. membershipsLevels.list 메서드는 모든 크리에이터 멤버십 등급의 목록을 가져옵니다.

2020년 1월 10일

이제 API에서 아동용 콘텐츠(YouTube에서는 '아동용'이라고 함)를 식별하는 기능을 지원합니다. YouTube 고객센터에서 '아동용' 콘텐츠에 대해 자세히 알아보세요.

channel 및 video 리소스는 콘텐츠 크리에이터와 시청자가 아동용 콘텐츠를 식별할 수 있도록 하는 두 가지 새로운 속성을 지원합니다.

selfDeclaredMadeForKids 속성을 사용하면 콘텐츠 크리에이터가 채널 또는 동영상이 아동용인지 지정할 수 있습니다.

채널의 경우 이 속성은 channels.update 메서드를 호출할 때 설정할 수 있습니다. 동영상의 경우 videos.insert 또는 videos.update 메서드를 호출할 때 이 속성을 설정할 수 있습니다.

이 속성은 채널 소유자가 API 요청을 승인한 경우에만 channel 또는 video 리소스가 포함된 API 응답에 포함됩니다.
madeForKids 속성을 사용하면 모든 사용자가 채널 또는 동영상의 '아동용' 상태를 검색할 수 있습니다. 예를 들어 상태는 selfDeclaredMadeForKids 속성의 값에 따라 결정될 수 있습니다. 채널, 동영상 또는 방송의 시청자층 설정에 관한 자세한 내용은 YouTube 고객센터를 참고하세요.

YouTube API 서비스 약관 및 개발자 정책도 업데이트되었습니다. 자세한 내용은 YouTube API 서비스 서비스 약관 - 개정 내역을 참고하세요. YouTube API 서비스 서비스 약관 및 개발자 정책의 변경사항은 2020년 1월 10일(태평양 표준시)부터 적용됩니다.

2019년 9월 10일

YouTube에서 구독자 수가 보고되는 방식과 그에 따라 API 응답에서 보고되는 방식의 변경사항을 반영하도록 API 참조 문서가 업데이트되었습니다. 이번 변경으로 인해 YouTube Data API 서비스에서 반환하는 구독자 수가 1,000명을 초과하는 경우 구독자 수가 소수점 이하 3자리로 반올림됩니다. 이 변경사항은 channel 리소스의 statistics.subscriberCount 속성에 영향을 미칩니다.

참고: 사용자가 자신의 채널에 관한 승인된 데이터 요청을 전송하는 경우에도 이 변경사항이 이 속성 값에 영향을 미칩니다. 채널 소유자는 YouTube 스튜디오에서 정확한 구독자 수를 계속 확인할 수 있습니다.

예를 들어 채널 구독자가 123,456명인 경우 statistics.subscriberCount 속성에는 123000 값이 포함됩니다. 아래 표에는 구독자 수가 API 응답에서 반올림되고 공개적으로 표시되는 다른 YouTube 사용자 인터페이스에서 약어로 표시되는 방식의 예가 나와 있습니다.

구독자 수 예시	YouTube Data API	공개적으로 표시되는 YouTube UI
1,234	1230	1.23천
12,345	12300	1.23만
123,456	123000	12.3만
1,234,567	1230000	123만
12,345,678	12300000	1230만
123,456,789	123000000	1.23억

2019년 4월 4일

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

API 참조 문서가 각 메서드의 일반적인 사용 사례를 더 잘 설명하고 API 탐색기 위젯을 통해 동적이며 고품질의 코드 샘플을 제공하도록 업데이트되었습니다. 예시는 channels.list 메서드 문서를 참고하세요. 이제 API 메서드를 설명하는 페이지에 두 가지 새로운 요소가 있습니다.
- API 탐색기 위젯을 사용하면 승인 범위를 선택하고, 샘플 매개변수 및 속성 값을 입력한 후, 실제 API 요청을 전송하고 실제 API 응답을 확인할 수 있습니다. 또한 위젯은 전체 코드 샘플을 보여주는 전체 화면 보기를 제공하며, 이 샘플은 입력한 범위와 값을 사용하도록 동적으로 업데이트됩니다.
- 일반적인 사용 사례 섹션에서는 페이지에 설명된 메서드의 일반적인 사용 사례를 하나 이상 설명합니다. 예를 들어 channels.list 메서드를 호출하여 특정 채널에 대한 데이터를 검색하거나 현재 사용자의 채널에 대한 데이터를 검색할 수 있습니다.
  
  이 섹션의 링크를 사용하여 사용 사례의 샘플 값으로 API 탐색기를 채우거나 이러한 값이 이미 채워진 전체 화면 API 탐색기를 열 수 있습니다. 이러한 변경사항은 개발자가 자체 애플리케이션에서 구현하려는 사용 사례에 직접 적용할 수 있는 코드 샘플을 더 쉽게 확인할 수 있도록 하기 위한 것입니다.
코드 샘플은 현재 Java, JavaScript, PHP, Python, curl에서 지원됩니다.
코드 샘플 도구도 위에 설명된 것과 동일한 모든 기능을 제공하는 새로운 UI로 업데이트되었습니다. 이 도구를 사용하면 다양한 메서드의 사용 사례를 살펴보고, 값을 API 탐색기에 로드하고, 전체 화면 API 탐색기를 열어 Java, JavaScript, PHP, Python으로 된 코드 샘플을 가져올 수 있습니다.

이번 변경과 함께 이전에 Java, JavaScript, PHP, Python용으로 사용 가능한 코드 샘플이 나열된 페이지가 삭제되었습니다.
Java, JavaScript, PHP, Python의 빠른 시작 가이드가 업데이트되었습니다. 수정된 가이드에서는 API 탐색기의 코드 샘플을 사용하여 API 키로 한 샘플을 실행하고 OAuth 2.0 클라이언트 ID로 다른 샘플을 실행하는 방법을 설명합니다.

위에 설명된 변경사항은 2017년에 API 문서에 추가된 대화형 도구를 대체합니다.

2018년 7월 9일

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

애플리케이션에 썸네일을 표시할 때 코드가 이미지 URL을 API 응답에서 반환된 그대로 사용해야 한다는 점에 유의하도록 channel 리소스의 snippet.thumbnails 속성 정의가 업데이트되었습니다. 예를 들어 애플리케이션은 API 응답에서 반환된 URL에서 https 도메인 대신 http 도메인을 사용해서는 안 됩니다.

2018년 7월부터 채널 썸네일 URL은 https 도메인에서만 사용할 수 있으며, 이 도메인은 API 응답에 URL이 표시되는 방식입니다. 이 시간 이후에 애플리케이션에서 http 도메인에서 YouTube 이미지를 로드하려고 하면 손상된 이미지가 표시될 수 있습니다.
참고: 지원 중단 공지사항입니다.

video 리소스의 recordingDetails.location.altitude 속성이 지원 중단되었습니다. 동영상에서 이 속성의 값을 반환한다고 보장할 수는 없습니다. 마찬가지로 API 요청이 해당 속성의 값을 설정하려고 시도하더라도 수신 데이터가 저장되지 않을 수 있습니다.

2018년 6월 22일

이전의 구현 및 이전 가이드였던 구현 가이드가 v2 API에서 v3 API로 이전하는 안내를 삭제하도록 업데이트되었습니다. 또한 좋아요 표시한 동영상과 같이 v3 API에서 지원 중단된 기능에 관한 안내도 삭제되었습니다.

2017년 11월 27일

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

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

YouTube는 channel 리소스의 invideoPromotion 객체를 통해 API에서 지원되는 추천 동영상 및 추천 웹사이트 기능에 대한 지원을 중단합니다. 이에 따라 모든 하위 속성을 포함한 해당 객체가 지원 중단됩니다.

2017년 12월 14일까지는 invideoPromotion 데이터를 가져오고 설정할 수 있습니다. 취소한 날짜 이후에는 다음과 같이 처리됩니다.
- channels.list를 호출할 때 invideoPromotion 부분을 검색하려고 하면 빈 invideoPromotion가 반환되거나 invideoPromotion 데이터가 전혀 반환되지 않습니다.
- channels.update를 호출할 때 invideoPromotion 데이터를 업데이트하려고 하면 2018년 5월 27일 이전까지는 성공 응답이 반환되지만 무작위 작업으로 취급되므로 실제로 업데이트는 실행되지 않습니다.
2018년 5월 27일 이후에는 이러한 요청이 invalidPromotion가 잘못된 부분임을 나타내는 오류 메시지를 반환할 수 있습니다.

2017년 11월 16일

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

이제 대화형 코드 스니펫 도구에서 Node.js 코드 샘플을 지원합니다. 샘플은 channels.list 메서드와 같이 거의 모든 API 메서드의 문서에서도 확인할 수 있습니다.

맞춤설정 가능한 샘플은 Node.js 애플리케이션을 위한 사용 사례별 시작점을 제공하도록 설계되었습니다. 이 기능은 Node.js 빠른 시작 가이드의 코드와 유사합니다. 하지만 샘플에는 빠른 시작에 표시되지 않는 몇 가지 유틸리티 함수가 포함되어 있습니다.
- removeEmptyParameters 함수는 API 요청 매개변수에 해당하는 키-값 쌍 목록을 가져와 값이 없는 매개변수를 삭제합니다.
- createResource 함수는 API 리소스의 속성에 해당하는 키-값 쌍 목록을 사용합니다. 그런 다음 속성을 insert 및 update 작업에 사용할 수 있는 JSON 객체로 변환합니다. 아래 예에서는 속성 이름 및 값 집합과 코드가 이를 위해 만들 JSON 객체를 보여줍니다.
```
# Key-value pairs:
{'id': 'ABC123',
 'snippet.title': 'Resource title',
 'snippet.description': 'Resource description',
 'status.privacyStatus': 'private'}

# JSON object:
{
 'id': 'ABC123',
 'snippet': {
   'title': 'Resource title',
   'description': 'Resource description',
 },
 'status': {
   'privacyStatus': 'private'
 }
}
```
이러한 모든 샘플은 로컬에서 다운로드하여 실행하도록 설계되었습니다. 자세한 내용은 코드 스니펫 도구 안내에서 전체 코드 샘플을 로컬에서 실행하기 위한 기본 요건을 참고하세요.

2017년 10월 25일

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

대화형 코드 스니펫 도구의 Python 코드 샘플이 더 이상 지원되지 않는 oauth2client 라이브러리 대신 google-auth 및 google-auth-oauthlib 라이브러리를 사용하도록 업데이트되었습니다.

이 변경사항 외에도 이제 이 도구는 약간 다른 승인 흐름을 사용하는 설치된 Python 애플리케이션 및 Python 웹 서버 애플리케이션의 전체 코드 샘플을 제공합니다. 전체 샘플과 이 변경사항을 보려면 다음 단계를 따르세요.
1. 대화형 코드 스니펫 도구 또는 channels.list 메서드와 같은 API 메서드의 문서로 이동합니다.
2. 코드 샘플 위의 Python 탭을 클릭합니다.
3. 탭 위에 있는 전환 버튼을 클릭하여 스니펫을 보는 것에서 전체 샘플을 보는 것으로 전환합니다.
4. 이제 탭에 InstalledAppFlow 승인 흐름을 사용하는 전체 코드 샘플이 표시됩니다. 샘플 위의 설명에서 이를 설명하고 웹 서버 애플리케이션 샘플로 연결합니다.
5. 링크를 클릭하여 웹 서버 예시로 전환합니다. 이 샘플은 Flask 웹 애플리케이션 프레임워크와 다른 승인 흐름을 사용합니다.
이러한 모든 샘플은 로컬에서 다운로드하여 실행하도록 설계되었습니다. 샘플을 실행하려면 코드 스니펫 도구 안내에서 전체 코드 샘플을 로컬에서 실행하는 방법을 참고하세요.

2017년 8월 29일

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

search.list 메서드의 forContentOwner 매개변수 정의가 업데이트되어 이 매개변수가 true로 설정된 경우 type 매개변수가 video로 설정되어야 한다고 명시되었습니다.
search.list 메서드의 regionCode 매개변수 정의가 업데이트되어 이 매개변수가 지정된 지역에서 볼 수 있는 동영상으로 검색 결과를 제한한다는 점이 명확해졌습니다.
YouTube의 브랜딩 로고와 아이콘이 업데이트되었습니다. 새로운 'YouTube로 개발됨' 로고는 브랜딩 가이드라인 페이지에서 다운로드할 수 있습니다. 이 페이지에는 다른 새로운 YouTube 로고와 아이콘도 표시되며 YouTube 브랜드 사이트에서 다운로드할 수 있습니다.

2017년 7월 24일

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

iOS용 새로운 YouTube Data API 빠른 시작 가이드를 사용할 수 있습니다. 이 가이드에서는 Objective-C 또는 Swift로 작성된 간단한 iOS 애플리케이션에서 YouTube Data API를 사용하는 방법을 설명합니다.
이제 YouTube Data API용 대화형 코드 스니펫 도구에 도구의 일부 기능을 설명하는 문서가 포함되어 있습니다.
- API 요청 실행
- 코드 스니펫과 전체 코드 샘플 간 전환
- 상용구 함수 사용
- 기존 리소스 로드 (업데이트 메서드용)
참고: 이 도구는 API 메서드의 API 참조 문서에도 삽입되어 있습니다 (예).

2017년 6월 1일

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

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

다음 video 리소스 속성은 지원 중단됩니다. 이 속성은 2017년 12월 1일까지 지원되지만 그때까지 동영상에서 이러한 속성의 값을 계속 반환할지는 보장할 수 없습니다. 마찬가지로 이러한 속성 값을 설정하는 videos.insert 및 videos.update 요청은 해당 날짜 이전에는 오류를 생성하지 않지만 수신되는 데이터가 저장되지 않을 수 있습니다.

2017년 5월 17일

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

코드 스니펫을 더 보편적이고 양방향으로 만들기 위해 API 참조 문서가 업데이트되었습니다. channels.list 또는 videos.rate와 같은 API 메서드를 설명하는 페이지에 이제 Java, JavaScript, PHP, Python, Ruby, Apps Script, Go에서 코드 스니펫을 보고 맞춤설정할 수 있는 대화형 도구가 포함되어 있습니다.

이 도구는 특정 메서드에 대해 하나 이상의 사용 사례에 관한 코드 스니펫을 표시하며, 각 사용 사례는 해당 메서드를 호출하는 일반적인 방법을 설명합니다. 예를 들어 channels.list 메서드를 호출하여 특정 채널 또는 현재 사용자의 채널에 관한 데이터를 가져올 수 있습니다.

코드 샘플과 상호작용할 수도 있습니다.
- 매개변수 및 속성 값을 수정하면 제공한 값을 반영하도록 코드 스니펫이 동적으로 업데이트됩니다.
- 코드 스니펫과 전체 샘플 간에 전환합니다. 코드 스니펫은 API 메서드를 호출하는 코드의 일부를 보여줍니다. 전체 샘플에는 이 스니펫과 요청을 승인하고 전송하기 위한 템플릿 코드가 포함되어 있습니다. 전체 샘플은 명령줄이나 로컬 웹 서버에서 복사하여 실행할 수 있습니다.
- 버튼을 클릭하여 요청을 실행합니다. 요청을 실행하려면 도구가 나를 대신하여 API를 호출하도록 승인해야 합니다.
이 도구는 이 도구를 사용할 수 있는 페이지에서 API 탐색기를 대체했습니다. 각 페이지에는 작업 중인 요청을 API 탐색기에 로드할 수 있는 링크도 표시됩니다.
Data API 코드 스니펫 도구도 위에 설명된 것과 동일한 모든 기능을 제공하는 새 UI로 업데이트되었습니다. 이 페이지에서 사용할 수 있는 주요 새 기능은 다음과 같습니다.
- 데이터를 쓰는 API 요청을 지원합니다.
- Java 샘플 지원
- 사용자를 승인하고 API 요청을 빌드하기 위한 더 유연하고 포괄적인 템플릿 코드

2017년 4월 27일

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

새로운 빠른 시작 가이드에서는 YouTube Data API를 요청하는 간단한 애플리케이션을 설정하는 방법을 설명합니다. 현재 Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python, Ruby용 가이드가 제공됩니다.

2017년 3월 30일

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

channel 리소스의 새 topicDetails.topicCategories[] 속성에는 채널의 콘텐츠를 설명하는 위키백과 URL 목록이 포함되어 있습니다. URL은 리소스의 topicDetails.topicIds[] 속성에 반환된 주제 ID에 해당합니다.
playlistItem 리소스의 새 contentDetails.videoPublishedAt 속성은 동영상이 YouTube에 게시된 시간을 나타냅니다. 리소스에는 이미 재생목록에 항목이 추가된 시간을 식별하는 snippet.publishedAt 속성이 포함되어 있습니다.
이제 channel 리소스와 마찬가지로 video 리소스도 동영상 콘텐츠를 설명하는 위키백과 URL 목록이 포함된 topicDetails.topicCategories[] 속성을 반환합니다. video 리소스의 경우 URL은 리소스의 topicDetails.relevantTopicIds[] 속성에 반환된 주제 ID에 해당합니다.
video 리소스의 새 contentDetails.contentRating.mpaatRating 속성은 미국 영화 협회에서 영화 트레일러 또는 미리보기에 부여한 등급을 식별합니다.

2017년 2월 27일

2016년 8월 11일에 발표한 바와 같이 YouTube는 지원되는 주제 ID 목록을 선별된 목록으로 전환했습니다. 지원되는 전체 주제 ID 목록은 channel 및 video 리소스의 topicDetails 속성 및 search.list 메서드의 topicId 매개변수에 포함되어 있습니다.

선별된 목록에 몇 가지 변경사항이 있습니다.

다음 주제가 Society의 하위 주제로 추가되었습니다.

이름 주제 ID

비즈니스 /m/09s1f

건강 /m/0kt51

군대 /m/01h6rj

정치 /m/05qt0

종교 /m/06bvp
이전에 Entertainment의 하위 요소였던 Animated cartoon 주제가 삭제되었습니다.
이전에 Music의 하위 요소였던 Children's music 주제가 삭제되었습니다.

이름	주제 ID
비즈니스	`/m/09s1f`
건강	`/m/0kt51`
군대	`/m/01h6rj`
정치	`/m/05qt0`
종교	`/m/06bvp`

이 변경사항으로 인해 동영상과 관련된 주제는 이제 항상 video 리소스의 topicDetails.relevantTopicIds[] 속성 값으로 반환됩니다.

2016년 11월 29일

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

2017년 2월 10일부터 지원되는 주제 ID 목록에 세 가지 사소한 변경사항이 있습니다.
- 이전에 Sports 카테고리의 하위 요소였던 Professional wrestling 카테고리가 이제 Entertainment의 하위 요소입니다.
- Entertainment의 하위 요소인 TV shows 카테고리가 새로 추가되었습니다.
- 이전에 Lifestyle의 하위 요소였던 Health 카테고리가 삭제되었습니다.
또한 상위 카테고리 (Entertainment, Gaming, Lifestyle, Music, Sports)가 몇 개 있습니다. Tennis와 같이 하위 카테고리와 연결된 동영상은 상위 카테고리 (Sports)와도 연결됩니다.

2016년 11월 10일

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

2016년 8월 11일에 처음 발표한 바와 같이 Freebase 및 Freebase API가 지원 중단됨에 따라 주제 ID와 관련된 몇 가지 변경사항이 필요합니다. 주제 ID는 channel 및 video 리소스와 연결된 주제를 식별하며, topicId 검색 매개변수를 사용하여 특정 주제와 관련된 채널이나 동영상을 찾을 수도 있습니다.

2017년 2월 10일부터 YouTube는 지금까지 반환된 훨씬 더 세분화된 ID 집합 대신 소수의 주제 ID 집합을 반환하기 시작합니다. 또한 채널과 동영상이 주제와 연결되지 않을 수도 있습니다. 이는 현재 API 동작과 일치합니다.

이러한 변경사항에 대비하여 API 클라이언트를 준비할 수 있도록, 이후 지원될 주제 ID를 나열하도록 다음 API 매개변수 및 속성의 정의가 업데이트되었습니다. 카테고리 목록은 모든 속성에서 동일합니다.
- channel 리소스의 topicDetails.topicIds[] 속성입니다.
- video 리소스의 topicDetails.relevantTopicIds[] 속성입니다.
- search.list 메서드의 topicId 매개변수
참고: 지원 중단 공지사항입니다.

다음 속성은 지원 중단됩니다.
- channel 리소스의 topicDetails.topicIds[] 속성입니다. 이 속성은 2017년 11월 10일까지 지원됩니다.
- video 리소스의 topicDetails.relevantTopicIds[] 속성입니다. 이 속성은 2017년 11월 10일까지 지원됩니다.
- video 리소스의 topicDetails.topicIds[] 속성입니다. 2017년 2월 10일 이후에는 이 속성에 값이 포함되지 않습니다. 이 날짜 이후에는 topicDetails.relevantTopicIds[] 속성 값이 동영상과 연결된 모든 주제를 식별합니다.
Freebase는 이미 지원 중단되었으므로 Freebase 주제를 사용하여 검색 가이드가 문서에서 삭제되었습니다. 이 가이드에서는 애플리케이션이 Freebase API와 함께 작동하는 방식을 보여주는 코드 샘플을 제공했습니다.

또한 주제 ID와 관련된 여러 코드 샘플이 search.list 메서드 문서에서 삭제되었습니다.

2016년 11월 2일

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

새로운 속성 및 매개변수
- video 리소스에는 다음과 같은 몇 가지 새로운 속성이 포함되어 있습니다.
  - player.embedHtml 속성에는 동영상을 재생하는 플레이어를 삽입하는 데 사용할 수 있는 <iframe> 태그가 포함되어 있습니다. 새 player.embedHeight 및 player.embedWidth 속성은 삽입된 플레이어의 크기를 식별합니다. 이러한 속성은 API 요청에서 maxHeight 또는 maxWidth 매개변수 중 하나 이상에 값을 지정하는 경우에만 반환됩니다. 이 두 가지 새 매개변수는 이 버전 기록 항목의 뒷부분에서 설명합니다.
  - 새 hasCustomThumbnail 속성은 동영상 업로더가 동영상에 맞춤 썸네일 이미지를 제공했는지 여부를 나타냅니다. 이 속성은 동영상 업로더에게만 표시됩니다.
  - 새 fpbRatingReasons[]는 동영상에 FPB (남아프리카 공화국) 등급이 부여된 이유를 나타냅니다.
  - 새 mcstRating는 동영상이 베트남에서 받은 등급을 식별합니다.
- videos.list 메서드는 maxHeight 및 maxWidth라는 두 가지 새로운 매개변수를 지원합니다. video 리소스의 player 부분을 검색할 때 두 매개변수 중 하나 또는 둘 다를 사용할 수 있습니다.
  
  기본적으로 player.embedHtml 속성에서 반환되는 <iframe>의 높이는 360픽셀입니다. 너비는 동영상의 가로세로 비율에 맞게 조정되므로 삽입된 플레이어에 동영상을 둘러싸는 검은색 막대가 표시되지 않습니다. 예를 들어 동영상의 가로세로 비율이 16:9인 경우 플레이어의 너비는 640픽셀이 됩니다.
  
  새 매개변수를 사용하면 삽입 코드가 기본 크기 대신 애플리케이션 레이아웃에 적합한 높이 또는 너비를 사용하도록 지정할 수 있습니다. API 서버는 삽입된 플레이어에 동영상을 둘러싸는 검은색 막대가 없도록 적절하게 플레이어 크기를 조정합니다. 두 매개변수 모두 삽입된 플레이어의 최대 크기를 지정합니다. 따라서 두 매개변수를 모두 지정하는 경우 한 측정기준이 해당 측정기준에 허용되는 최대 금액보다 작을 수 있습니다.
  
  예를 들어 동영상의 가로세로 비율이 16:9라고 가정해 보겠습니다. 따라서 maxHeight 또는 maxWidth 매개변수가 설정되지 않은 경우 player.embedHtml 태그에 640x360 플레이어가 포함됩니다.
  - maxHeight 매개변수가 720로 설정되고 maxWidth 매개변수가 설정되지 않은 경우 API는 1280x720 플레이어를 반환합니다.
  - maxWidth 매개변수가 960로 설정되고 maxHeight 매개변수가 설정되지 않으면 API는 960x540 플레이어를 반환합니다.
  - maxWidth 매개변수가 960로 설정되고 maxHeight 매개변수가 450로 설정된 경우 API는 800x450 플레이어를 반환합니다.
  위에 설명된 새 player.embedHeight 및 player.embedWidth 속성은 플레이어의 크기를 식별합니다.
기존 메서드, 속성, 매개변수 업데이트
- 채널이 타겟팅 데이터를 설정하지 않고는 최대 10개의 섹션을 만들 수 있고 타겟팅 데이터를 사용하면 최대 100개의 섹션을 만들 수 있다는 내용으로 channelSection 리소스 설명이 업데이트되었습니다.
  
  또한 타겟팅 옵션은 API를 사용하여야만 설정할 수 있다는 사실을 반영하도록 channelSection 리소스의 targeting 속성이 업데이트되었습니다. YouTube 웹사이트의 사용자 인터페이스를 사용하여 채널 섹션을 수정하면 타겟팅 옵션이 삭제됩니다.
- i18nLanguage 리소스의 snippet.name 속성 정의가 수정되어 값이 i18nLanguage.list 메서드의 hl 매개변수로 지정된 언어로 작성된 언어 이름을 나타낸다는 점을 반영했습니다.
- playlistItem 리소스의 contentDetails.note 속성이 속성 값의 최대 길이가 280자(영문 기준)임을 나타내도록 업데이트되었습니다.
- playlistItem 리소스의 contentDetails.startAt 및 contentDetails.endAt 속성이 지원 중단되었습니다. 이러한 필드는 playlistItems.insert 또는 playlistItems.update 요청에서 설정된 경우 무시됩니다.
- 이제 playlistItems.delete 및 playlistItems.update 메서드가 다른 여러 메서드에서 이미 지원되는 onBehalfOfContentOwner 매개변수를 지원합니다. 이 메서드를 사용하는 요청은 https://www.googleapis.com/auth/youtubepartner 범위에 대한 액세스 권한을 제공하는 토큰으로 승인되어야 합니다.
- search.list 메서드의 publishedBefore 및 publishedAfter 매개변수가 모두 업데이트되어 매개변수 값이 양 끝값을 포함함을 나타냅니다. 예를 들어 publishedBefore 매개변수가 설정된 경우 API는 지정된 시간 전 또는에 생성된 리소스를 반환합니다.
- video 리소스의 contentDetails.contentRating.grfilmRating 속성은 grfilmK12, grfilmK15, grfilmK18라는 세 가지 값을 추가로 지원합니다.
- 업로드된 동영상의 최대 파일 크기가 64GB에서 128GB로 늘어났다는 내용을 반영하도록 videos.insert 메서드 설명이 업데이트되었습니다.

신규 및 업데이트된 오류

API는 다음과 같은 새로운 오류를 지원합니다.

오류 유형	오류 세부정보	설명
`forbidden (403)`	`homeParameterDeprecated`	`activities.list` 메서드는 이 API를 통해 사용자의 홈페이지 활동 데이터를 사용할 수 없음을 나타내기 위해 이 오류를 반환합니다. 승인되지 않은 요청에서 `home` 매개변수를 `true`로 설정하면 이 오류가 발생할 수 있습니다.
`invalidValue (400)`	`invalidContentDetails`	`playlistItems.insert` 메서드는 이 오류를 반환하여 요청의 `contentDetails` 객체가 잘못되었음을 나타냅니다. 이 오류가 발생하는 한 가지 이유는 `contentDetails.note` 필드가 280자(영문 기준)를 초과하기 때문입니다.
`forbidden (403)`	`watchHistoryNotAccessible`	`playlistItems.list` 메서드는 요청에서 '시청 기록' 재생목록 항목을 가져오려고 했지만 API를 사용하여 가져올 수 없음을 나타내기 위해 이 오류를 반환합니다.
`forbidden (403)`	`watchLaterNotAccessible`	`playlistItems.list` 메서드는 요청에서 '나중에 볼만한 동영상' 재생목록 항목을 가져오려고 했지만 API를 사용하여 가져올 수 없음을 나타내기 위해 이 오류를 반환합니다.
`badRequest (400)`	`uploadLimitExceeded`	`videos.insert` 메서드는 채널에서 업로드할 수 있는 동영상 수를 초과했음을 나타내기 위해 이 오류를 반환합니다.
`forbidden (403)`	`forbiddenEmbedSetting`	`videos.update` 메서드는 이 오류를 반환하여 API 요청이 동영상에 잘못된 삽입 설정을 설정하려고 시도함을 나타냅니다. 일부 채널은 라이브 스트림에 삽입된 플레이어를 제공할 권한이 없습니다. 자세한 내용은 YouTube 고객센터를 참고하세요.

재생목록에 중복 동영상을 삽입해도 playlistItems.insert 메서드에서 더 이상 오류가 반환되지 않습니다. 이 오류는 이전에 중복을 허용하지 않았지만 더 이상 지원되지 않는 일부 재생목록(예: 즐겨찾는 동영상)에서 발생했습니다. 일반적으로 재생목록에는 동영상이 중복으로 포함될 수 있습니다.

기타 업데이트
- channel 리소스의 contentDetails.relatedPlaylists.watchHistory 및 contentDetails.relatedPlaylists.watchLater 속성이 응답에 포함될 때마다 항상 각각 HL 및 WL 값을 포함한다는 점을 명확히 하기 위해 2016년 9월 15일의 버전 기록 항목이 업데이트되었습니다. 또한 이러한 속성은 승인된 사용자가 자신의 채널에 대한 데이터를 검색하는 경우에만 포함됩니다.

2016년 9월 15일

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

2016년 8월 11일 버전 기록 업데이트에서는 2017년 2월 10일부터 지원되는 주제 ID 세트가 변경된다는 사실 등 주제 ID와 관련된 여러 변경사항을 논의했습니다. 지원되는 주제 목록은 2016년 11월 10일까지 게시될 예정입니다.
다음과 같은 변경사항이 적용되었습니다. 2016년 8월 11일의 버전 기록 업데이트에서 이러한 변경사항에 대한 알림이 제공되었습니다.
- home 매개변수가 true로 설정된 상태에서 activities.list 메서드가 호출되면 이제 API 응답에 로그아웃한 YouTube 사용자가 홈페이지에서 볼 수 있는 것과 유사한 항목이 포함됩니다.
  
  이는 2016년 8월 11일의 버전 기록 업데이트에 설명된 동작보다 더 나은 사용자 환경을 제공하기 위한 약간의 변경사항입니다. 이 업데이트에서는 home 매개변수를 사용하는 요청이 빈 목록을 반환한다고 명시했습니다.
- 이제 channel 리소스의 contentDetails.relatedPlaylists.watchHistory 및 contentDetails.relatedPlaylists.watchLater 속성에는 모든 채널에 대해 각각 HL 및 WL 값이 포함됩니다.
  
  즉, 이러한 속성은 사용자 자신의 채널에 관한 데이터를 검색하는 승인된 사용자에게만 표시됩니다. 이 속성에는 승인된 사용자가 자신의 채널에 대한 데이터를 검색하는 경우에도 항상 HL 및 WL 값이 포함됩니다. 따라서 시청 기록 및 나중에 볼 동영상 재생목록 ID는 API를 통해 가져올 수 없습니다.
  
  또한 채널의 시청 기록 또는 나중에 볼 동영상 재생목록에 대한 재생목록 세부정보 (playlists.list) 또는 재생목록 항목 (playlistItems.list)을 검색하는 요청은 이제 빈 목록을 반환합니다. 이 동작은 새 값인 HL 및 WL뿐만 아니라 API 클라이언트가 이미 저장했을 수 있는 보기 기록 또는 나중에 볼 동영상 재생목록 ID에도 적용됩니다.
video 리소스의 fileDetails.recordingLocation 객체와 하위 속성이 더 이상 반환되지 않습니다. 이전에는 이 데이터 (예: 상위 fileDetails 객체)를 동영상 소유자만 검색할 수 있었습니다.

2016년 8월 11일

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

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

새로운 문서의 전체 세트는 업데이트된 약관의 버전 기록에 설명되어 있습니다. 또한 향후 업데이트된 약관 또는 관련 증빙 서류가 변경되면 해당 버전 기록에 설명이 제공됩니다. 문서의 링크에서 해당 버전 기록의 변경사항을 나열하는 RSS 피드를 구독할 수 있습니다.
Freebase 및 Freebase API가 지원 중단됨에 따라 주제 ID와 관련된 몇 가지 변경사항이 있습니다. 주제 ID는 다음 API 리소스 및 메서드에서 사용됩니다.
- channel 리소스의 topicDetails 부분은 채널과 관련된 주제를 식별합니다.
- video 리소스의 topicDetails 부분은 동영상과 관련된 주제를 식별합니다.
- search.list 메서드의 topicId 매개변수를 사용하면 특정 주제와 관련된 동영상이나 채널을 검색할 수 있습니다.
이러한 기능의 변경사항은 다음과 같습니다.
- 2017년 2월 10일부터 YouTube는 지금까지 반환된 훨씬 더 세분화된 ID 집합 대신 소수의 주제 ID 집합을 반환하기 시작합니다. 지원되는 주제 세트는 스포츠 또는 농구와 같은 상위 분류를 식별하지만, 예를 들어 특정 팀이나 선수는 식별하지 않습니다. 이번 변경사항에 대한 신청을 준비할 수 있도록 지원되는 주제 집합을 발표할 예정입니다.
- 이미 가져온 Freebase 주제 ID는 2017년 2월 10일까지 콘텐츠를 검색하는 데 사용할 수 있습니다. 하지만 그 이후에는 이전 항목에서 확인된 소수의 주제만 사용하여 주제별 검색 결과를 가져올 수 있습니다.
- 2017년 2월 10일 이후에는 지원되는 소수의 주제 ID에 포함되지 않은 주제 ID를 사용하여 결과를 검색하려고 하면 API에서 빈 결과 집합을 반환합니다.
2016년 9월 12일부터 다음과 같은 여러 API 필드와 매개변수가 지원 중단됩니다.
- activities.list 메서드의 home 매개변수를 사용하면 승인된 사용자가 해당 사용자의 YouTube 홈페이지에 표시되는 활동 피드를 가져올 수 있었습니다. 2016년 9월 12일 이후에 이 매개변수를 사용하는 요청은 빈 목록을 반환합니다.
- channel 리소스의 contentDetails.relatedPlaylists.watchHistory 및 contentDetails.relatedPlaylists.watchLater 속성은 사용자 자신의 채널에 관한 데이터를 검색하는 승인된 사용자에게만 표시됩니다. 2016년 9월 12일 이후에는 contentDetails.relatedPlaylists.watchHistory가 모든 채널에 대해 HL 값을 반환하고 contentDetails.relatedPlaylists.watchLater 속성은 WL 값을 반환합니다.
  
  2016년 9월 12일 이후에는 채널의 시청 기록 또는 나중에 볼 동영상 재생목록의 재생목록 세부정보 (playlists.list)를 가져오라는 요청에 빈 목록이 반환됩니다. 이 두 재생목록에서 재생목록 항목 (playlistItems.list)을 검색하는 요청도 이 시간 이후에는 빈 목록을 반환합니다. 이는 새 값인 HL 및 WL뿐만 아니라 API 클라이언트가 이미 저장했을 수 있는 시청 기록 또는 나중에 볼 동영상 재생목록 ID에도 적용됩니다.
- 2016년 9월 12일 이후에는 video 리소스의 fileDetails.recordingLocation 객체 또는 그 하위 속성이 더 이상 반환되지 않습니다. 상위 fileDetails 객체는 동영상 소유자만 가져올 수 있으므로 이 데이터는 동영상 소유자만 가져올 수 있습니다.

2016년 6월 13일

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

channel 리소스의 contentDetails.googlePlusUserId 속성이 지원 중단되었습니다. 이전에는 채널이 Google+ 프로필에 연결된 경우에만 속성이 표시되었습니다. 지원 중단 후에는 이 속성이 더 이상 channel 리소스에 포함되지 않습니다.
comment 리소스의 snippet.authorGoogleplusProfileUrl 속성이 지원 중단되었습니다. 이전에는 채널이 Google+ 프로필에 연결된 경우에만 속성이 표시되었습니다. 지원 중단 후에는 이 속성이 더 이상 comment 리소스에 포함되지 않습니다.

지원 중단 후에는 이 두 속성 중 어느 것도 반환되지 않으므로 두 속성 모두 해당 리소스 문서에서 삭제되었습니다.

2016년 5월 31일

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

subscriptions.list 메서드의 새 myRecentSubscribers 매개변수는 인증된 사용자의 채널을 구독한 구독자 목록을 채널을 구독한 시간의 역순으로 가져옵니다.

새 매개변수는 인증된 사용자의 채널에 대한 최근 구독자 1,000명만 검색할 수 있도록 지원합니다. 구독자 전체 목록을 가져오려면 mySubscribers 매개변수를 사용합니다. 이 매개변수는 구독자를 특정 순서로 반환하지 않으며 가져올 수 있는 구독자 수를 제한하지 않습니다.
일부 동영상에 추가 썸네일 이미지 크기를 사용할 수 있다는 점에 유의하도록 activity, playlistItem, playlist, search result, thumbnail, video 리소스에 대해 snippet.thumbnails.(key) 속성의 정의가 업데이트되었습니다.
- standard 이미지의 너비는 640px, 높이는 480px입니다.
- maxres 이미지의 너비는 1280px, 높이는 720px입니다.
targeting 부분을 2 할당량 단위의 비용으로 검색할 수 있음을 나타내도록 channelSection.list 메서드의 part 매개변수 정의가 업데이트되었습니다.
이제 videos.list 메서드는 부적절하게 승인된 요청이 video 리소스의 fileDetails, processingDetails 또는 suggestions 부분을 검색하려고 할 때 forbidden (403) 오류를 반환합니다. 이러한 부분은 동영상 소유자만 사용할 수 있습니다.

2016년 5월 17일

새로운 Data API 코드 스니펫 도구는 일반적인 YouTube Data API 사용 사례에 관한 짧은 코드 스니펫을 제공합니다. 코드 스니펫은 현재 Apps Script, Go, JavaScript, PHP, Python, Ruby의 모든 읽기 전용 API 메서드에 사용할 수 있습니다.

이 도구는 각 메서드에 대해 하나 이상의 사용 사례에 관한 코드 샘플을 표시합니다. 예를 들어 search.list 메서드에 관한 코드 스니펫 5개를 제공합니다.

키워드별 동영상 목록
위치별 동영상 목록
라이브 이벤트 목록
인증된 사용자의 동영상 검색
관련 동영상 표시

이 도구는 각 사용 사례에 대해 API 요청에 사용된 매개변수를 표시합니다. 매개변수 값을 수정할 수 있으며, 이 경우 도구는 제공된 매개변수 값을 반영하도록 코드 스니펫을 업데이트합니다.

마지막으로 도구는 각 요청에 대한 API 응답을 표시합니다. 요청 매개변수를 수정한 경우 API 응답은 제공된 매개변수 값을 기반으로 합니다. API 응답이 표시되려면 도구가 대신 요청을 제출하도록 승인해야 합니다.

2016년 4월 28일

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

video 리소스의 새 contentDetails.projection 속성은 동영상의 투영 형식을 지정합니다. 유효한 속성 값은 360 및 rectangular입니다.
video 리소스의 recordingDetails.location 및 fileDetails.recordingLocation 속성이 두 속성의 차이점을 설명하도록 모두 업데이트되었습니다.
- recordingDetails.location 속성은 동영상 소유자가 동영상과 연결하려는 위치를 식별합니다. 이 위치는 수정 가능하며 공개 동영상에서 검색할 수 있으며 공개 동영상의 경우 사용자에게 표시될 수 있습니다.
- fileDetails.recordingLocation 속성 값은 변경할 수 없으며 업로드된 원본 동영상 파일과 연결된 위치를 나타냅니다. 이 값은 동영상 소유자에게만 표시됩니다.
속성 값에 빈 재생목록을 참조하고 가져올 수 없는 재생목록 ID가 포함될 수 있음을 나타내도록 channel 리소스의 contentDetails.relatedPlaylists.favorites 속성 정의가 업데이트되었습니다. 즐겨찾는 동영상 기능이 이미 지원 중단되었기 때문입니다. 이 속성에는 API 지원 중단 정책이 적용되지 않습니다.
comments.insert, comments.update, commentThreads.insert 또는 commentThreads.update 메서드에서 반환할 수 있는 ineligibleAccount 오류의 정의가 API 요청을 승인하는 데 사용된 YouTube 계정이 사용자의 Google 계정과 병합되지 않은 경우 오류가 발생함을 반영하도록 업데이트되었습니다.

2016년 4월 20일

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

channels.update 메서드의 part 매개변수 정의가 localizations도 이 매개변수의 유효한 값임을 나타내도록 업데이트되었습니다.
시작 가이드의 할당량 사용량 섹션이 실제 할당량과 할당량 사용량을 확인할 수 있는 Google Developer Console로 연결되도록 업데이트되었습니다.

2016년 3월 16일

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

기존 리소스 및 메서드 업데이트
- 업로드된 채널 배너 이미지의 권장 크기가 2560x1440픽셀임을 명시하도록 channelBanner 리소스 문서가 업데이트되었습니다. 최소 크기 (2048x1152픽셀)는 변경되지 않았습니다.
- channel 리소스의 새 snippet.customUrl 속성은 채널과 연결된 맞춤 URL을 식별합니다. 일부 채널에는 맞춤 URL이 없습니다. YouTube 고객센터에서 맞춤 URL을 사용할 수 있는 자격 요건과 URL을 설정하는 방법을 확인하세요.
- channel 리소스의 brandingSettings.watch 객체와 모든 하위 속성이 지원 중단되었습니다.
- 이제 search.list 요청에 대한 API 응답에 regionCode 속성이 포함됩니다. 이 속성은 검색어에 사용된 지역 코드를 식별합니다. 지역 코드는 API에 지정된 국가의 검색 결과를 반환하도록 지시합니다.
  속성 값은 지역을 식별하는 2자리 ISO 국가 코드입니다. i18nRegions.list 메서드는 지원되는 지역 목록을 반환합니다. 기본값은 US입니다. 지원되지 않는 지역이 지정된 경우에도 YouTube에서 쿼리를 처리하기 위해 기본값이 아닌 다른 지역을 선택할 수 있습니다.
- videoAbuseReportReason 리소스의 snippet.label 및 snippet.secondaryReasons[].label 속성 정의가 업데이트되어 이러한 속성에 악용 신고 사유에 대한 현지화된 라벨 텍스트가 포함되어 있음을 나타냅니다.
  
  또한 이제 videoAbuseReportReasons.list 메서드에서 API 응답의 라벨 텍스트에 사용할 언어를 지정하는 hl 매개변수를 지원합니다. 기본 매개변수 값은 en_US입니다.
- video 리소스의 새 contentDetails.contentRating.ecbmctRating 속성은 튀르키예 문화관광부 평가 및 분류위원회의 동영상 등급을 식별합니다.
  
  또한 다른 평가 시스템의 API 속성은 다음과 같은 새로운 속성 값을 지원합니다.
  - contentDetails.contentRating.fpbRating (남아프리카 공화국)
    평점: 10점, 속성 값: fpb10
  - contentDetails.contentRating.moctwRating (타이완)
    등급: R-12, 속성 값: moctwR12
  - contentDetails.contentRating.moctwRating (타이완)
    등급: R-15, 속성 값: moctwR15
- video 리소스의 liveStreamingDetails.activeLiveChatId 속성에는 동영상과 연결된 활성 Live 채팅의 ID가 포함됩니다. 이 속성 값은 동영상이 실시간 채팅이 사용 설정된 현재 라이브 방송인 경우에만 표시됩니다. 방송이 종료되고 실시간 채팅이 종료되면 동영상에 더 이상 속성이 반환되지 않습니다.
- video 리소스의 status.rejectionReason 속성은 새 속성 값 legal를 지원합니다.

API는 다음과 같은 새로운 오류를 지원합니다.

오류 유형	오류 세부정보	설명
`badRequest (400)`	`notEditable`	`channelSections.insert`, `channelSections.update`, `channelSections.delete` 메서드는 지정된 채널 섹션을 만들거나 업데이트하거나 삭제할 수 없음을 나타내기 위해 이 오류를 반환합니다.
`badRequest (400)`	`styleRequired`	`channelSections.insert` 및 `channelSections.update` 메서드는 이 오류를 반환하여 API 요청에 제출된 `channelSection` 리소스에 `snippet.style` 속성의 값을 지정해야 함을 나타냅니다.
`badRequest (400)`	`typeRequired`	`channelSections.insert` 및 `channelSections.update` 메서드는 이 오류를 반환하여 API 요청에 제출된 `channelSection` 리소스에 `snippet.type` 속성의 값을 지정해야 함을 나타냅니다.
`badRequest (400)`	`processingFailure`	`commentThreads.list` 메서드는 이 오류를 반환하여 API 서버가 요청을 성공적으로 처리하지 못했다고 나타냅니다. 일시적인 오류일 수 있지만 일반적으로 요청의 입력이 잘못되었음을 나타냅니다. 요청 본문에서 `commentThread` 리소스의 구조가 유효한지 확인합니다.
`forbidden (403)`	`commentsDisabled`	`commentThreads.list` 메서드는 이 오류를 반환하여 `videoId` 매개변수로 식별된 동영상에서 댓글이 사용 중지되었음을 나타냅니다.
`badRequest (400)`	`commentTextTooLong`	`commentThreads.insert` 메서드는 삽입되는 `comment` 리소스의 `snippet.topLevelComment.snippet.textOriginal` 속성에 문자가 너무 많다는 것을 나타내기 위해 이 오류를 반환합니다.
`invalidValue (400)`	`videoAlreadyInAnotherSeriesPlaylist`	`playlistItems.insert` 메서드는 재생목록에 추가하려는 동영상이 이미 다른 시리즈 재생목록에 있음을 나타내기 위해 이 오류를 반환합니다. 시리즈 재생목록에 대한 자세한 내용은 YouTube 고객센터를 참고하세요.
`badRequest (400)`	`subscriptionForbidden`	`subscriptions.insert` 메서드는 이 오류를 반환하여 최대 구독 수에 도달했거나 최근에 너무 많은 구독을 만들었음을 나타냅니다. 후자의 경우 몇 시간 후에 요청을 다시 시도할 수 있습니다.
`badRequest (400)`	`invalidCategoryId`	`videos.update` 메서드는 업로드된 `video` 리소스의 `snippet.categoryId` 속성이 잘못된 카테고리 ID를 지정했음을 나타내기 위해 이 오류를 반환합니다. `videoCategories.list` 메서드를 사용하여 지원되는 카테고리를 검색합니다.
`badRequest (400)`	`invalidDescription`	`videos.update` 메서드는 업로드된 `video` 리소스의 `snippet.description` 속성에 잘못된 값이 지정되었음을 나타내기 위해 이 오류를 반환합니다.
`badRequest (400)`	`invalidPublishAt`	`videos.update` 메서드는 업로드된 `video` 리소스의 `status.publishAt` 속성이 잘못된 예약된 게시 시간을 지정했음을 나타내기 위해 이 오류를 반환합니다.
`badRequest (400)`	`invalidRecordingDetails`	`videos.update` 메서드는 업로드된 `video` 리소스의 `recordingDetails` 객체가 잘못된 녹화 세부정보를 지정했음을 나타내기 위해 이 오류를 반환합니다.
`badRequest (400)`	`invalidTags`	`videos.update` 메서드는 업로드된 `video` 리소스의 `snippet.tags` 속성에 잘못된 값이 지정되었음을 나타내기 위해 이 오류를 반환합니다.
`badRequest (400)`	`invalidTitle`	`videos.update` 메서드는 업로드된 `video` 리소스의 `snippet.title` 속성에 잘못되거나 빈 동영상 제목이 지정되었음을 나타내기 위해 이 오류를 반환합니다.
`badRequest (400)`	`invalidVideoMetadata`	`videos.update` 메서드는 이 오류를 반환하여 요청 메타데이터가 잘못되었음을 나타냅니다. 이 오류는 요청이 `video` 리소스의 `snippet` 부분을 업데이트하지만 `snippet.title` 및 `snippet.categoryId` 속성의 값을 모두 설정하지 않는 경우에 발생합니다.

2015년 12월 18일

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

2015년 11월 19일

이제 API에서 playlist 및 video 리소스의 snippet.title 및 snippet.description 속성, channelSection 리소스의 snippet.title 속성, channel 리소스의 snippet.description 속성에 대한 현지화된 텍스트를 설정하고 가져오는 기능을 지원합니다.

현지화된 제목 및 설명 설정하기

리소스의 insert 또는 update 메서드를 호출할 때 리소스의 현지화된 값을 설정할 수 있습니다. 리소스의 현지화된 값을 설정하려면 다음 두 가지 작업을 모두 실행합니다.
- 리소스의 snippet.defaultLanguage 속성에 값이 설정되어 있는지 확인합니다. 이 속성은 리소스의 snippet.title 및 snippet.description 속성의 언어를 식별합니다. 값은 지원되는 애플리케이션 언어 또는 대부분의 다른 ISO 639-1:2002 언어 코드일 수 있습니다. 예를 들어 영어 제목과 설명이 포함된 동영상을 업로드하는 경우 snippet.defaultLanguage 속성을 en로 설정합니다.
  
  channel 리소스 업데이트 관련 참고사항: channel 리소스의 snippet.defaultLanguage 속성을 설정하려면 실제로 brandingSettings.channel.defaultLanguage 속성을 업데이트해야 합니다.
- 업데이트하는 리소스에 localizations 객체를 추가합니다. 각 객체 키는 애플리케이션 언어 또는 ISO 639-1:2002 언어 코드를 식별하는 문자열이며 각 키는 리소스의 현지화된 제목 (및 설명)이 포함된 객체에 매핑됩니다.
  
  아래 샘플 스니펫은 리소스의 기본 언어를 영어로 설정합니다. 또한 동영상에 현지화된 독일어 및 스페인어 제목과 설명을 추가합니다.
```
{
  "kind": "youtube#video",
  ...
  "snippet": {
    "title": "Playing soccer",
    "description": "We play soccer in the park on Sundays.",
    "defaultLanguage": "en",
    ...
  },
  "localizations":
    "de": {
      "title": "Fußball spielen",
      "description": "Wir spielen Fußball im Park am Sonntag"
    },
    "es": {
      "title": "Jugar al fútbol",
      "description": "Nosotros jugamos fútbol en el parque los domingos",
    }
  }
}
```
현지화된 값 검색

이 API는 리소스의 현지화된 값을 검색하는 두 가지 방법을 지원합니다.
- channels.list, channelSections.list, playlists.list 또는 videos.list 요청에 hl 매개변수를 추가하여 YouTube 웹사이트에서 지원하는 특정 애플리케이션 언어의 현지화된 데이터를 가져옵니다. 해당 언어로 현지화된 리소스 세부정보를 사용할 수 있는 경우 리소스의 snippet.localized 객체에 현지화된 값이 포함됩니다. 그러나 현지화된 세부정보를 사용할 수 없는 경우 snippet.localized 객체에는 리소스의 기본 언어로 된 리소스 세부정보가 포함됩니다.
  
  예를 들어 videos.list 요청이 위에서 설명한 동영상의 데이터를 독일어 및 스페인어로 현지화하여 가져왔다고 가정해 보겠습니다. hl 매개변수가 de로 설정된 경우 리소스에는 다음 데이터가 포함됩니다.
```
{
  "kind": "youtube#video",
  ...
  "snippet": {
    "title": "Playing soccer",
    "description": "We play soccer in the park on Sundays.",
    "defaultLanguage": "en",
    "localized": {
      "title": "Fußball spielen",
      "description": "Wir spielen Fußball im Park am Sonntag"
    }
    ...
  }
}
```
  하지만 hl 매개변수가 fr로 설정된 경우 snippet.localized 객체에는 영어 제목과 설명이 포함됩니다. 영어가 리소스의 기본 언어이고 현지화된 프랑스어 세부정보를 사용할 수 없기 때문입니다.
  
  중요: hl 매개변수는 YouTube 웹사이트에서 지원하는 애플리케이션 언어를 식별하는 값만 지원합니다. 다른 언어로 현지화된 텍스트를 사용할 수 있는지 확인하려면 리소스의 localizations 부분을 검색하고 필터링하여 현지화된 텍스트가 있는지 확인해야 합니다.
  
  예를 들어 애팔라치아 영어로 현지화된 텍스트를 사용할 수 있는지 확인하려면 현지화의 전체 목록을 가져와야 합니다.
- 리소스를 검색할 때 part 매개변수 값에 localizations를 포함하여 해당 리소스의 모든 현지화된 세부정보를 검색합니다. 현재 YouTube 애플리케이션 언어가 아닌 언어의 현지화된 데이터를 검색하는 경우 이 접근 방식을 사용하여 모든 현지화를 검색한 다음 필터링하여 원하는 현지화 데이터가 있는지 확인해야 합니다.

현지화된 텍스트 값과 관련된 오류

또한 이 API는 현지화된 텍스트 값에 대해 다음과 같은 새로운 오류를 지원합니다.

오류 유형	오류 세부정보	설명
`badRequest (400)`	`defaultLanguageNotSetError`	이 오류는 리소스의 `localizations` 객체를 삽입하거나 업데이트하려는 요청이 리소스에 `snippet.defaultLanguage` 속성이 설정되어 있지 않아 실패하고 있음을 나타냅니다. `channels.update`, `channelSections.insert`, `channelSections.update`, `playlists.insert`, `playlists.update`, `videos.insert`, `videos.update` 메서드는 이 오류를 지원합니다.
`badRequest (400)`	`localizationValidationError`	이 오류는 리소스의 `localizations` 객체에 있는 값 중 하나가 유효성 검사를 통과하지 못함을 나타냅니다. 예를 들어 객체에 잘못된 언어 코드가 포함된 경우 이 오류가 발생할 수 있습니다. `channels.update`, `channelSections.insert`, `channelSections.update`, `playlists.insert`, `playlists.update` 메서드는 이 오류를 지원합니다.

2015년 11월 4일

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

기존 리소스 및 메서드 업데이트
- viewCount로 라이브 방송을 정렬하면 방송이 진행되는 동안 방송의 동시 시청자 수로 API 결과가 정렬된다는 점을 나타내도록 search.list 메서드의 order 매개변수가 업데이트되었습니다.
- search.list 메서드의 relatedToVideoId 매개변수가 업데이트되어 이 매개변수가 설정된 경우 지원되는 다른 매개변수는 part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (video로 설정해야 함), fields뿐임을 나타냅니다. 이 업데이트는 API 동작의 변경사항을 반영하지 않습니다.
- 동영상이 게시된 날짜와 시간을 지정하는 속성 값이 동영상이 업로드된 시간과 다를 수 있음을 나타내도록 video 리소스의 snippet.publishedAt 속성 정의가 업데이트되었습니다. 예를 들어 동영상을 비공개 동영상으로 업로드한 후 나중에 공개하면 속성 값은 동영상이 공개된 시간을 지정합니다. 업데이트된 정의에서는 비공개 및 일부 공개 동영상의 값이 채워지는 방식도 설명합니다.
  
  이 변경사항은 API 동작의 변경사항을 반영하지 않습니다.
- video 리소스의 status.publishAt 속성 정의가 다음과 같이 업데이트되었습니다.
  - videos.update 메서드를 호출할 때 이 속성의 값을 설정하는 경우 동영상이 이미 비공개 상태이더라도 status.privacyStatus 속성 값을 private로 설정해야 합니다.
  - 요청에 따라 동영상이 과거의 특정 시점에 게시되도록 예약된 경우 동영상은 즉시 게시됩니다. 따라서 status.publishAt 속성을 이전 날짜 및 시간으로 설정하면 동영상의 privacyStatus를 private에서 public로 변경하는 것과 동일한 효과가 있습니다.
- video 리소스의 contentDetails.contentRating.cncRating 속성은 프랑스의 Commission de classification cinematographique에서 부여한 동영상 등급을 지정합니다. 이 속성은 현재 지원 중단된 contentDetails.contentRating.fmocRating 속성을 대체합니다.
- 이전 문서에 설명된 대로 속성 값에 쉼표로 구분된 목록이 아닌 공백으로 구분된 문자열 목록이 포함된다는 점을 올바르게 반영하도록 channel 리소스의 brandingSettings.channel.keywords 정의가 업데이트되었습니다. 이 업데이트는 API 동작의 변경사항을 반영하지 않습니다.
- 요청 본문에 업로드하고 동영상과 연결하는 썸네일 이미지가 포함된다는 점을 정확하게 반영하도록 thumbnails.set 메서드 문서가 업데이트되었습니다. 요청 본문에 thumbnail 리소스가 포함되어 있지 않습니다. 이전 문서에서는 이 메서드를 호출할 때 요청 본문을 제공해서는 안 된다고 안내했습니다. 이 업데이트는 API 동작의 변경사항을 반영하지 않습니다.
- activities.list 메서드에 현재 새 동영상 댓글과 관련된 리소스가 포함되어 있지 않다는 사실을 반영하도록 activity 리소스의 설명이 업데이트되었습니다. 리소스의 snippet.type 및 contentDetails.comment도 업데이트되었습니다.

신규 및 업데이트된 오류

이제 API에서 다음 오류를 지원합니다.

오류 세부정보

activities.insert

HTTP 응답 코드	`badRequest (400)`
이유	`invalidMetadata`
설명	`kind` 속성이 제공된 ID 유형과 일치하지 않습니다.

commentThreads.update
comments.insert
comments.update

HTTP 응답 코드	`badRequest (400)`
이유	`commentTextTooLong`
설명	삽입되거나 업데이트되는 `comment` 리소스의 `snippet.topLevelComment.snippet.textOriginal` 속성에 문자가 너무 많습니다.

playlistItems.insert
playlistItems.update

HTTP 응답 코드	`forbidden (403)`
이유	`playlistItemsNotAccessible`
설명	지정된 재생목록 항목을 삽입, 업데이트 또는 삭제할 권한이 요청에 제대로 부여되지 않았습니다.

playlists.delete
playlists.insert
playlists.update

HTTP 응답 코드	`badRequest (400)`
이유	`playlistForbidden`
설명	이 작업이 금지되었거나 요청이 올바르게 승인되지 않았습니다.

search.list

HTTP 응답 코드	`badRequest (400)`
이유	`invalidLocation`
설명	`location` 또는 `locationRadius` 매개변수 값의 형식이 잘못되었습니다.

search.list

HTTP 응답 코드	`badRequest (400)`
이유	`invalidRelevanceLanguage`
설명	`relevanceLanguage` 매개변수 값의 형식이 잘못되었습니다.

subscriptions.insert

HTTP 응답 코드	`badRequest (400)`
이유	`subscriptionForbidden`
설명	이 오류는 다음 중 하나라도 해당하는 경우에 발생합니다. 만들려는 구독이 이미 존재합니다. 이미 최대 구독 수에 도달했습니다. 지원되지 않는 내 채널을 구독하려고 합니다. 최근에 구독을 너무 많이 생성하여 요청을 다시 시도하기 전에 몇 시간 정도 기다려야 합니다.

videos.update

HTTP 응답 코드	`badRequest (400)`
이유	`invalidDefaultBroadcastPrivacySetting`
설명	요청에서 기본 브로드캐스트에 잘못된 공개 범위 설정을 설정하려고 합니다.

2015년 8월 28일

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

기존 리소스 및 메서드 업데이트
- video 리소스의 statistics.favoriteCount 속성이 지원 중단되었습니다.
  
  지원 중단 정책에 따라 이 속성은 이 공지 후 최소 1년 동안 video 리소스에 계속 포함됩니다. 그러나 이제 속성 값은 항상 0로 설정됩니다.

2015년 8월 7일

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

기존 리소스 및 메서드 업데이트
- API 서버가 속성 값의 길이를 계산하는 방법에 관한 자세한 정보를 제공하기 위해 video 리소스의 snippet.tags[] 속성 정의가 업데이트되었습니다. 이 업데이트는 API 동작의 변경사항을 반영하지 않습니다.
  
  특히 이제 정의에 따르면 태그에 공백이 포함된 경우 API 서버는 태그 값을 따옴표로 묶인 것처럼 처리하며 따옴표는 문자 수 제한에 포함됩니다. 따라서 문자 수 제한의 관점에서 태그 Foo-Baz는 7자이지만 Foo Baz 태그는 9자입니다.
- commentThreads.insert 메서드에서 더 이상 shareOnGooglePlus 매개변수를 지원하지 않습니다. 이 매개변수는 이전에 댓글과 해당 댓글에 대한 답글을 작성자의 Google+ 프로필에도 게시해야 하는지 여부를 나타냈습니다. 요청이 매개변수를 제출하면 API 서버는 매개변수를 무시하지만 그렇지 않으면 요청을 처리합니다.

2015년 6월 18일

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

기존 리소스 및 메서드 업데이트
- commentThreads.list 메서드의 새 order 매개변수는 API 응답에서 댓글 대화목록을 나열해야 하는 순서를 지정합니다. 대화목록은 시간 또는 관련도순으로 정렬할 수 있습니다. 기본 동작은 시간순으로 정렬하는 것입니다.
- video 리소스의 새 snippet.defaultAudioLanguage 속성은 동영상의 기본 오디오 트랙에서 사용되는 언어를 지정합니다.
- 콘텐츠가 원래 YouTube 콘텐츠 파트너와 연결된 채널에 업로드된 후 해당 파트너가 소유권을 주장해야 함을 명확히 하기 위해 video 리소스의 contentDetails.licensedContent 속성 정의가 업데이트되었습니다. 이는 실제 API 동작의 변경을 나타내지 않습니다.
- 이제 captions.delete, captions.download, captions.insert, captions.list, captions.update 메서드에서 다른 여러 메서드에서 이미 지원되는 onBehalfOfContentOwner 매개변수를 지원합니다. 이 메서드를 사용하는 요청은 https://www.googleapis.com/auth/youtubepartner 범위에 대한 액세스 권한을 제공하는 토큰으로 승인되어야 합니다.

신규 및 업데이트된 오류

이제 API에서 다음 오류를 지원합니다.

오류 세부정보

videos.rate

HTTP 응답 코드	`badRequest (400)`
이유	`emailNotVerified`
설명	사용자는 동영상에 평점을 주기 전에 이메일 주소를 인증해야 합니다.

videos.rate

HTTP 응답 코드	`badRequest (400)`
이유	`videoPurchaseRequired`
설명	대여 동영상은 동영상을 대여한 사용자만 평가할 수 있습니다.

subscriptions.delete 및 subscriptions.insert 메서드는 더 이상 accountClosed 및 accountSuspended 오류를 지원하지 않습니다.

2015년 4월 27일

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

새로운 리소스 및 메서드
- 새 videoAbuseReportReason 리소스에는 동영상이 악성 콘텐츠를 포함하여 신고된 이유에 관한 정보가 포함됩니다. videoAbuseReportReasons.list 메서드를 사용하면 동영상이 신고될 수 있는 모든 이유의 목록을 가져올 수 있습니다.
- 새로운 videos.reportAbuse 메서드는 악성 콘텐츠가 포함된 동영상을 실제로 신고하는 방법을 제공합니다. 요청 본문에는 신고된 동영상과 동영상에 악성 콘텐츠가 포함된 것으로 간주되는 이유를 지정하는 JSON 객체가 포함됩니다. 유효한 이유는 위에 설명된 videoAbuseReportReason.list 메서드에서 가져올 수 있습니다.
  
  악성 동영상 신고 예시를 포함하도록 이전 가이드도 업데이트되었습니다. 이번 변경으로 v3 API는 이제 지원할 예정인 모든 v2 API 기능을 지원합니다. 이러한 기능은 모두 이전 가이드에도 설명되어 있습니다.
기존 리소스 및 메서드 업데이트
- search.list 메서드의 새 forDeveloper 필터 매개변수는 개발자의 애플리케이션 또는 웹사이트를 통해 업로드된 동영상만 검색되도록 제한합니다. forDeveloper 매개변수는 q 매개변수와 같은 선택적 검색 매개변수와 함께 사용할 수 있습니다.
  
  이 기능을 사용하면 업로드된 각 동영상에 Google Developer Console에서 개발자의 애플리케이션과 연결된 프로젝트 번호가 자동으로 태그됩니다.
  
  검색 요청이 나중에 forDeveloper 매개변수를 true로 설정하면 API 서버는 요청의 승인 사용자 인증 정보를 사용하여 개발자를 식별합니다. 따라서 개발자는 개발자 자체 앱 또는 웹사이트를 통해 업로드된 동영상으로 결과를 제한할 수 있지만 다른 앱 또는 사이트를 통해 업로드된 동영상으로는 제한할 수 없습니다.
  
  이 새로운 기능은 v2 API에서 지원한 개발자 태그 기능과 비슷하지만 동일하지는 않습니다.
- channel 리소스의 새 snippet.country 속성을 사용하면 채널 소유자가 채널을 특정 국가와 연결할 수 있습니다.
  
  참고: channel 리소스의 snippet.country 속성을 설정하려면 실제로 brandingSettings.channel.country 속성을 업데이트해야 합니다.
- 이제 API에서 channelSection 리소스의 타겟팅을 지원합니다. 채널 섹션 타겟팅은 콘텐츠 섹션의 공개 상태를 특정 기준과 일치하는 사용자로 제한하는 방법을 제공합니다.
  
  API는 세 가지 타겟팅 옵션을 노출합니다. 채널 섹션이 표시되려면 사용자가 모든 타겟팅 설정을 충족해야 합니다.
  - targeting.languages[]: YouTube 애플리케이션 언어 목록입니다. 이러한 언어 중 하나를 선택한 사용자는 해당 채널 섹션을 볼 수 있습니다.
  - targeting.regions[]: YouTube 선호 콘텐츠 지역 목록입니다. 채널 섹션은 이러한 지역 중 하나를 선택한 사용자와 이러한 지역 중 하나가 자동으로 선택된 사용자에게 표시됩니다.
  - targeting.countries[]: 채널 섹션이 표시되는 국가 목록입니다. 목록의 각 값은 ISO 3166-1 alpha-2 국가 코드입니다.
- 값이 시간, 일 등을 반영할 수 있음을 반영하도록 video 리소스의 contentDetails.duration 속성 정의가 수정되었습니다.
- channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete, videos.delete 메서드의 문서가 수정되었습니다. 성공하면 이러한 메서드가 모두 HTTP 204 응답 코드 (No Content)를 반환한다는 점을 반영합니다.

신규 및 업데이트된 오류

이제 API에서 다음 오류를 지원합니다.

오류 유형	오류 세부정보	설명
`badRequest (400)`	`targetInvalidCountry`	삽입된 `channelSection` 리소스에 잘못된 `targeting.countries[]` 속성 값이 포함된 경우 `channelSections.insert` 및 `channelSections.update` 메서드는 이 오류를 반환합니다.
`badRequest (400)`	`targetInvalidLanguage`	삽입된 `channelSection` 리소스에 잘못된 `targeting.languages[]` 속성 값이 포함된 경우 `channelSections.insert` 및 `channelSections.update` 메서드는 이 오류를 반환합니다.
`badRequest (400)`	`targetInvalidRegion`	삽입된 `channelSection` 리소스에 잘못된 `targeting.regions[]` 속성 값이 포함된 경우 `channelSections.insert` 및 `channelSections.update` 메서드는 이 오류를 반환합니다.
`badRequest (400)`	`operationNotSupported`	API 사용자가 `snippet.parentId` 속성으로 식별된 최상위 주석에 답장하여 주석을 삽입할 수 없는 경우 `comments.insert` 메서드가 이 오류를 반환합니다. `commentThread` 리소스에서 `snippet.canReply` 속성은 현재 시청자가 대화목록에 답장할 수 있는지 여부를 나타냅니다.
`badRequest (400)`	`invalidChannelId`	요청의 `channelId` 매개변수가 잘못된 채널 ID를 지정한 경우 `search.list` 메서드는 이 오류를 반환합니다.
`badRequest (400)`	`subscriptionForbidden`	API 사용자가 자신의 채널을 구독하려고 하면 `subscriptions.insert` 메서드에서 이 오류를 반환합니다.

captions.update 메서드가 더 이상 invalidMetadata 및 videoNotFound 오류를 지원하지 않습니다.

2015년 4월 16일

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

여전히 v2 API의 주석 기능을 사용하는 애플리케이션을 이전하는 방법을 설명하도록 이전 가이드가 업데이트되었습니다.

또한 이 가이드에서는 v2 API에서는 지원되지 않았지만 v3 API에서 지원되는 여러 주석 기능을 설명합니다. 예를 들면 다음과 같습니다.
- 채널에 대한 댓글 검색
- 채널과 관련된 모든 댓글 대화목록을 검색합니다. 즉, API 응답에 채널 또는 채널의 동영상에 대한 댓글이 포함될 수 있습니다.
- 댓글 텍스트 업데이트
- 댓글을 스팸으로 표시
- 댓글의 검토 상태 설정
이전에 안내된 대로 알림이 Superfeedr 허브가 아닌 Google PubSubHubBub 허브에만 푸시된다는 사실을 반영하도록 푸시 알림 구독 가이드가 업데이트되었습니다.

2015년 4월 9일

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

API의 새 commentThread 및 comment 리소스를 사용하면 댓글을 검색, 삽입, 업데이트, 삭제, 검토할 수 있습니다.
- commentThread 리소스에는 YouTube 댓글 대화목록에 관한 정보가 포함되어 있습니다. 댓글 대화목록은 최상위 댓글과 해당 댓글에 대한 답글(있는 경우)로 구성됩니다. commentThread 리소스는 동영상 또는 채널에 대한 댓글을 나타낼 수 있습니다.
  
  최상위 댓글과 답글은 실제로 commentThread 리소스 내에 중첩된 comment 리소스입니다. commentThread 리소스에 댓글에 대한 모든 답글이 포함되는 것은 아니며 특정 댓글의 모든 답글을 가져오려면 comments.list 메서드를 사용해야 합니다. 또한 일부 댓글에는 답글이 없습니다.
  
  API는 commentThread 리소스에 대해 다음 메서드를 지원합니다.
  - commentThreads.list – 댓글 대화목록을 가져옵니다. 이 메서드를 사용하여 특정 동영상 또는 채널과 연결된 댓글을 검색합니다.
  - commentThreads.insert – 새 최상위 댓글을 만듭니다. (comments.insert 메서드를 사용하여 기존 댓글에 답글을 달 수 있습니다.)
  - commentThreads.update – 최상위 댓글을 수정합니다.
- comment 리소스에는 단일 YouTube 댓글에 관한 정보가 포함되어 있습니다. comment 리소스는 동영상 또는 채널에 대한 댓글을 나타낼 수 있습니다. 또한 댓글은 최상위 댓글이거나 최상위 댓글에 대한 답글일 수 있습니다.
  
  API는 comment 리소스에 대해 다음 메서드를 지원합니다.
  - comments.list – 댓글 목록을 가져옵니다. 이 메서드를 사용하여 특정 댓글에 대한 모든 답글을 가져올 수 있습니다.
  - comments.insert – 기존 댓글에 대한 답글을 작성합니다.
  - comments.update – 댓글을 수정합니다.
  - comments.markAsSpam – 하나 이상의 댓글을 스팸으로 신고합니다.
  - comments.setModerationStatus – 하나 이상의 댓글의 검토 상태를 설정합니다. 예를 들어 공개 표시를 위해 댓글을 삭제하거나 표시할 수 없는 댓글을 거부할 수 있습니다. API 요청은 댓글과 연결된 채널 또는 동영상의 소유자가 승인해야 합니다.
  - comments.delete – 댓글을 삭제합니다.
comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert, commentThreads.update 메서드를 호출하려면 2015년 4월 2일의 버전 기록에 설명된 API의 새 https://www.googleapis.com/auth/youtube.force-ssl 범위가 필요합니다.
새로운 푸시 알림 구독 가이드에서는 웹 액세스 가능한 리소스를 위한 서버 간 게시/구독 프로토콜인 PubSubHubBub를 통한 푸시 알림에 대한 API의 새로운 지원을 설명합니다. PubSubHubBub 콜백 서버는 채널에서 다음 활동 중 하나를 수행할 때 Atom 피드 알림을 받을 수 있습니다.
- 동영상을 업로드합니다.
- 동영상 제목 업데이트
- 동영상 설명 업데이트
푸시 알림에 대한 새로운 지원을 언급하도록 이전 가이드도 업데이트되었습니다. 그러나 v2 API는 v3 API에서 지원되지 않는 다른 여러 유형의 푸시 알림을 지원하므로 PubSubHubBub 지원에 관한 언급은 여전히 이 가이드의 지원 중단됨 섹션에 나와 있습니다.
이제 API의 새 https://www.googleapis.com/auth/youtube.force-ssl 범위는 이전에 https://www.googleapis.com/auth/youtube 범위를 지원했던 모든 API 메서드에 유효한 범위입니다.

이제 API에서 다음 오류를 지원합니다.

오류 유형	오류 세부정보	설명
`badRequest (400)`	`invalidRating`	요청에 `rating` 매개변수의 예기치 않은 값이 포함된 경우 `videos.rate` 메서드는 이 오류를 반환합니다.

subscriptions.insert 메서드는 더 이상 subscriptionLimitExceeded 오류를 지원하지 않습니다. 이 오류는 이전에 요청으로 식별된 구독자가 구독 비율 제한을 초과했음을 나타냅니다.

2015년 4월 2일

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

새 captions 리소스는 YouTube 자막 트랙을 나타냅니다. 자막 트랙은 정확히 하나의 YouTube 동영상에 연결됩니다.

이 API는 자막 트랙을 나열, 삽입, 업데이트, 다운로드, 삭제하는 메서드를 지원합니다.
v2 API에서 자막 기능을 계속 사용하는 애플리케이션을 이전하는 방법을 설명하는 이전 가이드도 업데이트되었습니다.
API의 새 https://www.googleapis.com/auth/youtube.force-ssl 범위에서는 SSL 연결을 통해 API 서버와 통신해야 합니다.

이 새 범위는 https://www.googleapis.com/auth/youtube 범위와 동일한 액세스 권한을 부여합니다. 사실 YouTube API 서버는 HTTPS 엔드포인트를 통해서만 사용할 수 있으므로 두 범위는 기능적으로 동일합니다. 따라서 https://www.googleapis.com/auth/youtube 범위에 SSL 연결이 필요하지 않더라도 실제로 API를 요청하는 다른 방법은 없습니다.

새 범위는 모든 caption 리소스 메서드를 호출하는 데 필요합니다.

2015년 3월 11일

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

YouTube Data API (v3) 이전 가이드에는 v3 API에서 지원하고 v2 API에서 지원하지 않는 기능이 나열된 v3 API의 새로운 기능이라는 새 탭이 있습니다. 이전에는 동일한 기능이 가이드의 다른 탭에 나열되어 있었으며 지금도 마찬가지입니다. 예를 들어 채널의 인비디오 프로모션 캠페인 데이터를 업데이트하는 방법을 설명하는 새로운 기능도 채널 (프로필) 탭에 표시됩니다.
v3 API가 다음 v2 API 기능을 지원한다는 내용으로 YouTube Data API (v3) 이전 가이드가 업데이트되었습니다.
- 동영상 신고하기
다음 v2 API 기능이 v3 API에서 지원되지 않는다는 내용을 포함하도록 YouTube Data API (v3) 이전 가이드가 업데이트되었습니다.
- 동영상 추천 검색: v3 API는 현재 API 사용자에게 추천된 동영상만 포함된 목록을 검색하지 않습니다. 하지만 v3 API를 사용하여 activities.list 메서드를 호출하고 home 매개변수 값을 true로 설정하여 맞춤 동영상을 찾을 수 있습니다.
  
  API 응답에서 snippet.type 속성의 값이 recommendation인 경우 리소스는 추천 동영상에 해당합니다. 이 경우 contentDetails.recommendation.reason 및 contentDetails.recommendation.seedResourceId 속성에 동영상이 추천된 이유에 관한 정보가 포함됩니다. 응답에 특정 개수의 맞춤 동영상이 포함된다고 보장할 수는 없습니다.
- 채널 추천 검색
- 새로운 구독 동영상 검색 – v3 API는 API 사용자가 구독하는 채널에 최근에 업로드된 동영상만 포함된 목록을 검색하지 않습니다. 하지만 v3 API를 사용하여 activities.list 메서드를 호출하고 home 매개변수 값을 true로 설정하여 새 구독 동영상을 찾을 수 있습니다.
  
  API 응답에서 snippet.type 속성의 값이 upload인 경우 리소스는 새 구독 동영상에 해당합니다. 응답에 특정 수의 새 구독 동영상이 포함된다고 보장할 수는 없습니다.
- RSS 피드 지원
- 피드 업데이트 푸시 알림: v2 API는 간단한 업데이트 프로토콜 (SUP) 또는 PubSubHubbub을 사용하여 푸시 알림을 지원하여 YouTube 사용자의 사용자 활동 피드를 모니터링했습니다. 새 채널 구독, 동영상 평가, 공유, 즐겨찾기, 댓글 달기, 업로드 시 알림이 전송되었습니다.
  
  v3 API는 PubSubHubbub 프로토콜을 사용하여 푸시 알림을 지원하지만, 동영상 업로드 및 동영상 제목 또는 동영상 설명 업데이트에 대해서만 알림이 전송됩니다.
- 채널 위치 – v2 API는 <yt:location> 태그를 사용하여 채널의 YouTube 공개 프로필에 입력된 사용자의 위치를 식별했습니다. 일부 개발자는 이 필드를 사용하여 채널을 특정 국가와 연결했지만 이 필드의 데이터는 이 목적으로 일관되게 사용될 수 없습니다.
- 개발자 태그 설정 또는 검색 – v2 API는 동영상이 업로드될 때 동영상에 키워드 또는 개발자 태그를 연결하는 기능을 지원했습니다. 개발자 태그는 YouTube 사용자에게 표시되지 않지만 동영상 소유자는 특정 개발자 태그와 일치하는 동영상을 검색할 수 있습니다.
  
  v3 API는 유사하지만 동일하지 않은 기능을 제공합니다. 구체적으로 개발자는 개발자 자체 애플리케이션에서 업로드한 동영상을 검색할 수 있습니다. 이 기능을 사용하면 업로드된 각 동영상에 Google Developer Console에서 개발자의 애플리케이션과 연결된 프로젝트 번호가 자동으로 태그됩니다. 그런 다음 개발자는 동일한 프로젝트 번호를 사용하여 동영상을 검색합니다.
- 게시일, 조회수 또는 평점별로 동영상 표시 – v2 API의 orderby 매개변수를 사용하면 재생목록의 동영상을 순서, 길이, 게시일, 제목, 기타 여러 값별로 정렬할 수 있습니다. v3 API에서 재생목록 항목은 일반적으로 순서별로 오름차순으로 정렬되며 다른 정렬 옵션은 사용할 수 없습니다.
  
  몇 가지 예외가 있습니다. 다음 유형의 재생목록에는 새 업로드 동영상, 즐겨찾는 동영상, 좋아요한 동영상 또는 최근 시청한 동영상이 첫 번째 항목 (snippet.position=0)으로 자동 추가됩니다. 따라서 이러한 각 목록은 항목이 목록에 추가된 시간을 기준으로 최신 항목부터 오래된 항목 순으로 정렬됩니다.
  - 사용자 업로드
  - 즐겨찾는 동영상
  - 좋아요 표시한 동영상
  - 시청 기록
  단, '나중에 볼만한 동영상' 재생목록에 새 항목이 추가되면 해당 목록의 마지막 항목으로 추가되므로 목록은 오래된 항목부터 새 항목 순으로 정렬됩니다.
- 일괄 처리: v3 API는 v2 API에서 지원했던 일괄 처리 사용 사례 중 하나를 지원합니다. v3 API의 channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list, videos.list 메서드는 모두 id 매개변수를 지원합니다. 이 매개변수는 쉼표로 구분된 ID 목록 (동영상 ID, 채널 ID 등)을 지정하는 데 사용할 수 있습니다. 이러한 메서드를 사용하면 단일 요청으로 여러 리소스의 목록을 검색할 수 있습니다.
이번 변경으로 가이드에서는 이전 (v2) API에서 지원되었으며 현재 API 버전 (v3)에서 지원 중단될 모든 기능을 식별합니다.

2015년 3월 4일

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

이제 channelSections.delete 및 channelSections.update 메서드가 다른 여러 메서드에서 이미 지원되는 onBehalfOfContentOwner 매개변수를 지원합니다.
다음 속성과 하위 속성은 지원 중단되었습니다.
- brandingSettings.image.backgroundImageUrl
- brandingSettings.image.largeBrandedBannerImageImapScript
- brandingSettings.image.largeBrandedBannerImageUrl
- brandingSettings.image.smallBrandedBannerImageImapScript
- brandingSettings.image.smallBrandedBannerImageUrl
참고: 이러한 속성 중 어느 것에도 API 지원 중단 정책이 적용되지 않았습니다.
video 리소스의 새 contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons 속성은 동영상에 DJCQT (브라질) 등급이 부여된 이유를 설명합니다.

이제 API에서 다음 오류를 지원합니다.

오류 유형	오류 세부정보	설명
`notFound (404)`	`channelNotFound`	요청의 `id` 매개변수가 찾을 수 없는 채널을 지정하면 `channels.update` 메서드가 이 오류를 반환합니다.
`badRequest (400)`	`manualSortRequiredinvalidValue`	요청에서 재생목록 항목의 위치를 설정하려고 하지만 재생목록에서 수동 정렬을 사용하지 않는 경우 `playlistItems.insert` 및 `playlistItems.update` 메서드는 이 오류를 반환합니다. 예를 들어 재생목록 항목은 날짜 또는 인기도순으로 정렬될 수 있습니다. 요청 본문에 전송된 리소스에서 `snippet.position` 요소를 삭제하면 이 오류를 해결할 수 있습니다. 재생목록 항목이 목록에서 특정 위치를 차지하도록 하려면 먼저 재생목록의 순서 설정을 수동으로 업데이트해야 합니다. 이 설정은 YouTube 동영상 관리자에서 조정할 수 있습니다.
`forbidden (403)`	`channelClosed`	요청의 `channelId` 매개변수가 폐쇄된 채널을 지정하면 `playlists.list` 메서드가 이 오류를 반환합니다.
`forbidden (403)`	`channelSuspended`	요청의 `channelId` 매개변수가 정지된 채널을 지정하면 `playlists.list` 메서드에서 이 오류를 반환합니다.
`forbidden (403)`	`playlistForbidden`	요청의 `id` 매개변수가 요청을 지원하지 않거나 요청이 올바르게 승인되지 않은 경우 `playlists.list` 메서드는 이 오류를 반환합니다.
`notFound (404)`	`channelNotFound`	요청의 `channelId` 매개변수가 찾을 수 없는 채널을 지정하면 `playlists.list` 메서드가 이 오류를 반환합니다.
`notFound (404)`	`playlistNotFound`	요청의 `id` 매개변수가 찾을 수 없는 재생목록을 지정하면 `playlists.list` 메서드는 이 오류를 반환합니다.
`notFound (404)`	`videoNotFound`	요청의 `id` 매개변수가 찾을 수 없는 동영상을 지정하면 `videos.list` 메서드는 이 오류를 반환합니다.
`badRequest (400)`	`invalidRating`	요청에 예기치 않은 `rating` 매개변수 값이 포함된 경우 `videos.rate` 메서드는 이 오류를 반환합니다.

2015년 3월 2일

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

이제 search.list 메서드에서 relevanceLanguage 매개변수를 지원하므로 특정 언어와 가장 관련성이 높은 결과를 요청할 수 있습니다.

이 새로운 매개변수를 사용하는 방법을 설명하는 YouTube Data API (v3) 이전 가이드도 업데이트되었습니다. 이 매개변수는 이전 API 버전 (v3)과 이미 지원 중단된 이전 버전 (v2) 간에 존재했던 기능 격차를 해결합니다.
YouTube Data API (v3) 이전 가이드도 업데이트되어 v2 API에서 영화, 트레일러, TV 프로그램, TV 시즌, TV 에피소드를 설명하는 데 제공한 특수 피드 및 메타데이터 필드가 지원 중단되었음을 나타냅니다.

2015년 1월 14일

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

v3 API를 사용하여 JavaScript로 동영상을 업로드하는 방법을 설명하도록 YouTube Data API (v3) 이전 가이드가 업데이트되었습니다. 자세한 내용은 동영상 업로드 섹션을 참고하세요. 이 기능은 v2 API에서 지원하는 브라우저 기반 업로드 기능과 유사합니다. 이전 가이드의 이 변경사항은 실제 API 변경사항이 아니라 클라이언트 측 JavaScript를 사용하여 동영상을 업로드하기 위한 새로운 샘플 코드의 사용 가능 여부를 반영합니다.

JavaScript 클라이언트 라이브러리와 CORS를 사용하여 동영상을 업로드할 수 있으므로 이전 가이드에서는 더 이상 브라우저 기반 업로드를 v3 API에서 지원 중단될 수 있는 기능으로 표시하지 않습니다.
videos.insert 메서드의 문서가 위에 설명된 새 JavaScript 코드 샘플을 포함하도록 업데이트되었습니다. YouTube Data API (v3)의 JavaScript 코드 샘플 목록도 업데이트되었습니다.

2014년 11월 11일

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

search.list 메서드 호출의 할당량 비용이 100개로 변경되었습니다.

중요: 대부분의 경우 다른 API 메서드를 사용하여 더 낮은 할당량 비용으로 정보를 가져올 수 있습니다. 예를 들어 GoogleDevelopers 채널에 업로드된 동영상을 찾는 방법에는 다음 두 가지가 있습니다.
- 할당량 비용: 100개 단위
  
  search.list 메서드를 호출하고 GoogleDevelopers를 검색합니다.
- 할당량 비용: 6개 단위
  
  channels.list 메서드를 호출하여 올바른 채널 ID를 찾습니다. forUsername 매개변수를 GoogleDevelopers로, part 매개변수를 contentDetails로 설정합니다. API 응답에서 contentDetails.relatedPlaylists.uploads 속성은 채널의 업로드된 동영상의 재생목록 ID를 지정합니다.
  
  그런 다음 playlistItems.list 메서드를 호출하고 playlistId 매개변수를 캡처된 ID로, part 매개변수를 snippet로 설정합니다.

2014년 10월 8일

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

channel 리소스에는 두 가지 새로운 속성이 포함되어 있습니다.
- status.longUploadsStatus 속성은 채널에서 15분이 넘는 동영상을 업로드할 수 있는지 여부를 나타냅니다. 이 속성은 채널 소유자가 API 요청을 승인한 경우에만 반환됩니다. 유효한 속성 값은 다음과 같습니다.
  - allowed – 채널에서 15분이 넘는 동영상을 업로드할 수 있습니다.
  - eligible – 채널에서 15분을 초과하는 동영상을 업로드할 수 있지만 먼저 이 기능을 사용 설정해야 합니다.
  - disallowed – 채널에서 15분이 넘는 동영상을 업로드할 수 없거나 업로드할 자격이 없습니다.
  이러한 값에 관한 자세한 내용은 속성 정의를 참고하세요. YouTube 고객센터에서도 이 기능에 대한 자세한 내용을 확인할 수 있습니다.
- invideoPromotion.useSmartTiming 속성은 채널의 프로모션 캠페인에서 '스마트 타이밍'을 사용하는지 여부를 나타냅니다. 이 기능은 동영상에서 클릭 가능성이 높고 시청 환경을 방해할 가능성이 낮은 지점에 프로모션을 표시하려고 시도합니다. 이 기능은 각 동영상에 표시할 프로모션도 하나 선택합니다.
API가 videos.update 메서드 호출을 처리하는 방식을 명확히 하기 위해 video 리소스의 snippet.title 및 snippet.categoryId 속성 정의가 모두 업데이트되었습니다. 이 메서드를 호출하여 video 리소스의 snippet 부분을 업데이트하는 경우 두 속성의 값을 모두 설정해야 합니다.

video 리소스의 snippet 부분을 업데이트하려고 하는데 두 속성 모두에 값을 설정하지 않으면 API에서 invalidRequest 오류를 반환합니다. 이 오류의 설명도 업데이트되었습니다.
뉴질랜드 영화 및 문학 등급 지정 기관의 동영상 등급을 식별하는 video 리소스의 contentDetails.contentRating.oflcRating 속성은 이제 oflcRp13 및 oflcRp16이라는 두 가지 새로운 등급을 지원합니다. 이는 각각 RP13 및 RP16 등급에 해당합니다.

이제 channelBanners.insert 메서드에서 다음 오류를 지원합니다.

오류 유형	오류 세부정보	설명
`badRequest`	`bannerAlbumFull`	채널 소유자의 YouTube 채널 아트 앨범에 이미지가 너무 많습니다. 채널 소유자는 http://photos.google.com으로 이동하여 앨범 페이지로 이동한 후 해당 앨범의 이미지 중 일부를 삭제해야 합니다.

2014년 9월 12일

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

search.list 메서드 호출의 할당량 비용이 지정된 리소스 부분의 비용 외에도 1단위에서 2단위로 변경되었습니다.

2014년 8월 13일

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

이제 subscriptions.insert 메서드에서 다음 오류를 지원합니다.

오류 유형	오류 세부정보	설명
`badRequest`	`subscriptionLimitExceeded`	요청으로 식별된 구독자가 구독 비율 한도를 초과했습니다. 몇 시간 후에 다시 구독을 시도해 보세요.

2014년 8월 12일

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

YouTube Data API (v3)로 애플리케이션 이전이라는 제목의 새 가이드에서는 YouTube Data API (v3)를 사용하여 YouTube Data API (v2)에서 제공되는 기능을 실행하는 방법을 설명합니다. 이전 API는 2014년 3월 4일부터 공식적으로 지원 중단되었습니다. 이 가이드는 아직 v2 API를 사용하는 애플리케이션을 최신 API 버전으로 이전하는 데 도움이 됩니다.

2014년 7월 8일

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

이제 playlists.insert 메서드에서 다음 오류를 지원합니다.

오류 유형	오류 세부정보	설명
`badRequest`	`maxPlaylistExceeded`	채널에 이미 허용된 최대 개수의 재생목록이 있으므로 재생목록을 만들 수 없는 경우 이 오류가 발생합니다.

2014년 6월 18일

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

각 API 메서드의 설명이 해당 메서드 호출로 발생한 할당량 비용을 포함하도록 업데이트되었습니다. 마찬가지로 part 매개변수의 정의가 업데이트되어 API 호출에서 검색할 수 있는 각 부분의 할당량 비용을 지정할 수 있습니다. 예를 들어 subscriptions.insert 메서드 호출에는 약 50단위의 할당량 비용이 듭니다. subscription 리소스에는 세 부분 (snippet, contentDetails, subscriberSnippet)이 포함되어 있으며 각 부분의 비용은 2단위입니다.

할당량 비용은 예고 없이 변경될 수 있습니다.
이제 video 리소스에서 동영상이 여러 국가 등급 기관에서 받은 등급을 식별하는 43개의 새로운 콘텐츠 등급 시스템을 지원합니다. 새로 지원되는 평가 시스템은 아르헨티나, 오스트리아, 벨기에, 불가리아, 칠레 (텔레비전), 칠레 (영화), 체코, 콜롬비아, 덴마크, 이집트, 에스토니아, 핀란드, 프랑스, 그리스, 홍콩, 아이슬란드, 인도네시아, 아일랜드, 이스라엘, 이탈리아, 케냐, 라트비아, 룩셈부르크, 말레이시아, 몰디브, 몰타, 네덜란드, 나이지리아, 노르웨이, 페루, 필리핀, 포르투갈, 루마니아, 싱가포르, 슬로바키아, 남아프리카 공화국, 스웨덴, 스위스, 타이완, 태국, 베네수엘라입니다.

2014년 5월 28일

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

이제 search.list 메서드에서 지리적 위치와 연결된 동영상을 검색할 수 있는 location 및 locationRadius 매개변수를 지원합니다. 위치를 기반으로 결과를 검색하려면 요청에 두 매개변수의 값을 모두 지정해야 하며, 요청에 두 매개변수 중 하나만 포함된 경우 API에서 오류를 반환합니다.
- location 매개변수는 원형 지리적 영역의 중심에 있는 위도/경도 좌표를 지정합니다.
- locationRadius 매개변수는 동영상이 검색 결과에 계속 포함되기 위해 동영상과 연결된 위치가 영역 중앙에서 얼마나 멀리 떨어져 있을 수 있는지 최대 거리를 지정합니다.

2014년 5월 13일

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

일반적으로 채널에 하나의 추천 항목만 설정할 수 있다는 점을 나타내기 위해 channel 리소스의 invideoPromotion.items[] 속성이 업데이트되었습니다. 프로모션된 상품을 너무 많이 삽입하려고 하면 API에서 HTTP 400 상태 코드가 있는 tooManyPromotedItems 오류를 반환합니다.
이제 channelSection 리소스에 몇 가지 새로운 유형의 추천 콘텐츠에 관한 정보가 포함될 수 있습니다. 이제 channelSection 리소스의 snippet.type 속성이 다음 값을 지원합니다.
- postedPlaylists - 채널 소유자가 채널의 활동 피드에 게시한 재생목록
- postedVideos - 채널 소유자가 채널의 활동 피드에 게시한 동영상
- subscriptions - 채널 소유자가 구독한 채널
video 리소스의 새 contentDetails.contentRating.ifcoRating 속성은 동영상이 아일랜드 영화 등급 지정 기관으로부터 받은 등급을 식별합니다.
워터마크가 항상 플레이어의 오른쪽 상단에 표시되도록 watermark 리소스의 position.cornerPosition 속성 정의가 업데이트되었습니다.
검색어에서 불리언 NOT (-) 연산자를 사용하여 특정 검색어와 연결된 동영상을 제외할 수 있다는 점을 명시하도록 search.list 메서드의 q 매개변수 정의가 업데이트되었습니다. 값은 불리언 OR (|) 연산자를 사용하여 여러 검색어 중 하나와 연결된 동영상을 찾을 수도 있습니다.
search.list 호출에 대한 API 응답에서 반환되는 pageInfo.totalResults 속성의 정의가 업데이트되어 값이 근사치이며 정확한 값을 나타내지 않을 수 있음을 나타냅니다. 또한 최대 값은 1,000,000입니다. 페이징 링크를 만드는 데 이 값을 사용하면 안 됩니다. 대신 nextPageToken 및 prevPageToken 속성 값을 사용하여 페이징 링크를 표시할지 결정합니다.
API가 이러한 메서드에 대한 성공적인 요청에 대해 HTTP 204 응답 코드를 반환한다는 점을 반영하도록 watermarks.set 및 watermarks.unset 메서드가 업데이트되었습니다.

2014년 5월 2일

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

새 i18nLanguage 리소스는 YouTube 웹사이트에서 지원하는 애플리케이션 언어를 식별합니다. 애플리케이션 언어를 UI 언어라고도 합니다. YouTube 웹사이트의 경우 Google 계정 설정, 브라우저 언어 또는 IP 위치에 따라 애플리케이션 언어가 자동으로 선택될 수 있으며, 사용자가 YouTube 사이트 바닥글에서 원하는 UI 언어를 직접 선택할 수도 있습니다.

API는 지원되는 애플리케이션 언어를 나열하는 메서드를 지원합니다. 지원되는 언어는 videoCategories.list 및 guideCategories.list와 같은 API 메서드를 호출할 때 hl 매개변수의 값으로 사용할 수 있습니다.
새 i18nRegion 리소스는 YouTube 사용자가 선호하는 콘텐츠 지역으로 선택할 수 있는 지리적 영역을 식별합니다. 콘텐츠 지역은 콘텐츠 언어라고도 합니다. YouTube 웹사이트의 경우 YouTube 도메인 또는 사용자의 IP 위치와 같은 휴리스틱을 기반으로 콘텐츠 지역이 자동으로 선택될 수 있으며, 사용자가 YouTube 사이트 바닥글에서 원하는 콘텐츠 지역을 수동으로 선택할 수도 있습니다.

이 API는 지원되는 콘텐츠 지역을 나열하는 메서드를 지원합니다. 지원되는 지역 코드는 search.list, videos.list, activities.list, videoCategories.list와 같은 API 메서드를 호출할 때 regionCode 매개변수의 값으로 사용할 수 있습니다.

2014년 4월 7일

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

새 channelSection 리소스에는 채널에서 추천으로 선택한 동영상 집합에 관한 정보가 포함됩니다. 예를 들어 섹션에는 채널의 최신 업로드 동영상, 가장 인기 있는 업로드 동영상 또는 하나 이상의 재생목록에 있는 동영상이 표시될 수 있습니다.

이 API는 채널 섹션을 나열, 삽입, 업데이트 또는 삭제하는 메서드를 지원합니다. 특정 채널 ID를 지정하거나 고유한 채널 섹션 ID 목록을 지정하여 인증된 사용자의 채널에 대한 채널 섹션 목록을 검색할 수 있습니다.

API가 이러한 새 메서드에 대해 구체적으로 지원하는 오류 메시지를 설명하도록 오류 문서도 업데이트되었습니다.
동영상의 processingDetails.fileDetailsAvailability 속성 값이 available인 경우에만 이 객체가 반환된다는 설명을 추가하여 video 리소스의 fileDetails 객체 정의가 업데이트되었습니다.

마찬가지로 video 리소스의 suggestions 객체 정의가 업데이트되어 동영상의 processingDetails.tagSuggestionsAvailability 속성 또는 processingDetails.editorSuggestionsAvailability 속성 값이 available인 경우에만 해당 객체가 반환된다고 설명합니다.
videos.insert 및 videos.update 메서드를 호출할 때 status.publishAt 속성을 설정할 수 있음을 반영하도록 videos.insert 및 videos.update 메서드의 문서가 업데이트되었습니다.
channel 리소스의 invideoPromotion 객체 정의가 업데이트되어 채널 소유자만 객체를 가져올 수 있다고 설명합니다.
videos.rate 메서드가 실제로 onBehalfOfContentOwner 매개변수를 지원하지 않는다는 점을 반영하도록 videos.rate 메서드의 매개변수 목록이 업데이트되었습니다. 이 매개변수를 설정하는 videos.rate 요청이 500 오류를 반환하므로 문서 오류였습니다.

2014년 3월 31일

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

video 리소스의 새 status.publishAt 속성을 사용하면 비공개 동영상의 게시 일정을 지정할 수 있습니다. 이 속성은 동영상의 공개 상태가 private이고 동영상이 게시된 적이 없는 경우에만 설정할 수 있습니다. 이 새 속성에는 지원 중단 정책이 적용되지 않습니다.

2014년 3월 13일

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

이제 API에서 channel 리소스의 contentOwnerDetails 부분을 지원합니다. 새 부분에는 채널에 연결된 콘텐츠 소유자의 ID, 콘텐츠 소유자와 채널이 연결된 날짜 및 시간 등 채널에 연결된 YouTube 파트너와 관련된 채널 데이터가 포함됩니다. 이 새 부품은 지원 중단 정책의 적용을 받지 않습니다.

이제 문서에 다음 속성에 지원되는 최대 글자 수가 나와 있습니다.

리소스	속성	최대 길이
`channel`	`invideoPromotion.items[].customMessage`	40자(영문 기준)
`video`	`snippet.title`	100자(영문 기준)
`video`	`snippet.description`	5,000바이트
`video`	`snippet.tags`	500자(영문 기준) 속성 값은 목록이며 목록의 항목 사이에 있는 쉼표도 한도에 포함됩니다.

channel 리소스의 brandingSettings.watch.featuredPlaylistId 속성이 지원 중단되었습니다. 값을 설정하려고 하면 API에서 오류를 반환합니다.
동영상을 삽입하거나 업데이트할 때 설정할 수 있는 값 목록에 다음 video 리소스 속성이 추가되었습니다.
이제 오류 문서에서 각 오류 유형의 HTTP 응답 코드를 지정합니다.

이제 API에서 다음 오류를 지원합니다.

오류 유형	오류 세부정보	설명
`badRequest (400)`	`invalidCriteria`	요청에서 서로 함께 사용할 수 없는 필터 매개변수를 지정하면 `channels.list` 메서드가 이 오류를 반환합니다.
`badRequest (400)`	`channelTitleUpdateForbidden`	채널의 `brandingSettings` 부분을 업데이트하고 `brandingSettings.channel.title` 속성의 값을 변경하려고 하면 `channels.update` 메서드에서 이 오류를 반환합니다. 속성을 생략하면 API에서 오류를 반환하지 않습니다.
`badRequest (400)`	`invalidRecentlyUploadedBy`	`invideoPromotion.items[].id.recentlyUploadedBy` 속성이 잘못된 채널 ID를 지정하면 `channels.update` 메서드가 이 오류를 반환합니다.
`badRequest (400)`	`invalidTimingOffset`	`invideoPromotion` 부분이 잘못된 타이밍 오프셋을 지정하면 `channels.update` 메서드가 이 오류를 반환합니다.
`badRequest (400)`	`tooManyPromotedItems`	`invideoPromotion` 부분에 허용된 프로모션된 항목 수보다 많은 수가 지정된 경우 `channels.update` 메서드는 이 오류를 반환합니다.
`forbidden (403)`	`promotedVideoNotAllowed`	`invideoPromotion.items[].id.videoId` 속성이 찾을 수 없거나 추천 항목으로 사용할 수 없는 동영상 ID를 지정하면 `channels.update` 메서드가 이 오류를 반환합니다.
`forbidden (403)`	`websiteLinkNotAllowed`	`invideoPromotion.items[].id.websiteUrl` 속성이 허용되지 않는 URL을 지정하면 `channels.update` 메서드가 이 오류를 반환합니다.
`required (400)`	`requiredTimingType`	요청에 YouTube에서 추천 항목을 표시할 기본 타이밍 설정이 지정되지 않은 경우 `channels.update` 메서드는 이 오류를 반환합니다.
`required (400)`	`requiredTiming`	`channels.update` 메서드는 각 추천 항목에 `invideoPromotion.items[].timing` 객체를 지정해야 합니다.
`required (400)`	`requiredWebsiteUrl`	`channels.update` 메서드는 각 추천 항목에 `invideoPromotion.items[].id.websiteUrl` 속성을 지정해야 합니다.
`badRequest (400)`	`invalidPublishAt`	요청 메타데이터에 잘못된 예약된 게시 시간이 지정된 경우 `videos.insert` 메서드에서 이 오류를 반환합니다.

2014년 3월 4일

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

이제 YouTube Data API v3에는 YouTube API 서비스 약관에 설명된 지원 중단 정책이 적용됩니다. 지원 중단 정책이 적용되는 API를 나열하는 페이지에는 정책이 적용되지 않는 일부 v3 API 기능이 명시적으로 제외되어 있습니다.

2013년 12월 5일

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

검색 요청을 제출할 때 필터 매개변수의 값을 정확히 하나만 지정할 필요가 없다는 점을 올바르게 반영하도록 search.list 메서드 문서가 업데이트되었습니다. 대신 필터 매개변수 0개 또는 1개에 값을 설정할 수 있습니다.
다음 매개변수의 값도 지정하는 경우 type 매개변수의 값을 video로 설정해야 한다는 점에 유의하도록 search.list 메서드 매개변수의 정의가 업데이트되었습니다.
- eventType
- videoCaption
- videoCategoryId
- videoDefinition
- videoDimension
- videoDuration
- videoEmbeddable
- videoLicense
- videoSyndicated
- videoType
업로드된 채널 배너 이미지의 최소 크기가 2048x1152픽셀로 축소되었습니다. 이전에는 최소 크기가 2120x1192픽셀이었습니다. 또한 channel 리소스 문서에서는 API에서 게재되는 모든 배너 이미지의 최대 크기를 지정합니다. 예를 들어 텔레비전 애플리케이션의 brandingSettings.image.bannerTvImageUrl 이미지 최대 크기는 2120x1192픽셀이지만 실제 이미지는 2048x1152픽셀일 수 있습니다. YouTube 고객센터에서 다양한 유형의 기기에 표시되도록 채널 아트를 최적화하는 방법을 자세히 알아보세요.
다음 정보를 반영하도록 여러 channel 리소스 속성 정의가 업데이트되었습니다.
- brandingSettings.channel.description 속성의 값은 최대 1,000자(영문 기준)입니다.
- brandingSettings.channel.featuredChannelsTitle 속성의 최대 길이는 30자(영문 기준)입니다.
- 이제 brandingSettings.channel.featuredChannelsUrls[] 속성에 최대 100개의 채널을 표시할 수 있습니다.
- brandingSettings.channel.unsubscribedTrailer 속성 값은 채널 소유자가 소유한 공개 또는 일부 공개 동영상의 YouTube 동영상 ID를 지정해야 합니다(설정된 경우).
이제 channels.update 메서드에서 invideoPromotion.items[].promotedByContentOwner 속성 업데이트를 지원합니다. 이 속성은 프로모션을 표시할 때 콘텐츠 소유자의 이름이 표시되는지 여부를 나타냅니다. 속성 값을 설정하는 API 요청이 onBehalfOfContentOwner 매개변수를 사용하여 콘텐츠 소유자를 대신하여 이루어지는 경우에만 설정할 수 있습니다.
이제 playlistItems.list 및 playlistItems.insert 메서드가 다른 여러 메서드에서 이미 지원되는 onBehalfOfContentOwner 매개변수를 지원합니다.
이제 contentDetails.contentRating.acbRating 속성으로 영화의 경우 오스트레일리아 등급위원회 (ACB)의 등급을, 아동용 TV 프로그램의 경우 오스트레일리아 커뮤니케이션스 앤 미디어 어드미니스트레이션 (ACMA)의 등급을 지정할 수 있습니다.
새 contentDetails.contentRating.catvRating 및 contentDetails.contentRating.catvfrRating 속성은 동영상이 각각 캐나다 TV 분류 시스템과 퀘벡에서 사용되는 프랑스어 Régie du cinéma 등급 시스템에 따라 받은 등급을 식별합니다.
videoCategory 리소스의 새 snippet.assignable 속성은 업데이트된 동영상 또는 새로 업로드된 동영상을 해당 동영상 카테고리와 연결할 수 있는지 여부를 나타냅니다.
다음 메서드에 관한 코드 샘플이 추가되었습니다.
- activities.insert(Go)
- channelBanners.insert (Python)
- channels.update (Python)
- playlistItems.list(Go)
- search.list(Go)
- thumbnails.set (Java)
- videos.insert(Go)

2013년 10월 24일

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

이 API에는 라이브 방송 콘텐츠를 찾고 표시하는 데 도움이 되는 두 가지 추가 기능이 포함되어 있습니다.

검색 결과의 새로운 snippet.liveBroadcastContent 속성은 동영상 또는 채널 리소스에 라이브 방송 콘텐츠가 있는지 나타냅니다. 유효한 속성 값은 upcoming, active, none입니다.
- video 리소스의 새 snippet.liveBroadcastContent 속성은 동영상이 예정된 라이브 방송인지 또는 진행 중인 라이브 방송인지를 나타냅니다. 다음 목록은 속성의 가능한 값을 설명합니다.
  - upcoming – 동영상이 아직 시작되지 않은 라이브 방송입니다.
  - active – 동영상이 진행 중인 라이브 방송입니다.
  - none – 동영상이 예정된 라이브 방송이 아니거나 라이브 방송 중이 아닙니다. YouTube에서 아직 볼 수 있는 완료된 방송의 속성 값입니다.
- video 리소스의 새 liveStreamingDetails 속성은 라이브 동영상 방송에 관한 메타데이터를 포함하는 객체입니다. 이 메타데이터를 검색하려면 part 매개변수 값의 리소스 부분 목록에 liveStreamingDetails를 포함합니다. 메타데이터에는 다음과 같은 새로운 속성이 포함됩니다.
  - liveStreamingDetails.actualStartTime – 방송이 실제로 시작된 시간입니다. 이 값은 브로드캐스트 상태가 active이면 표시됩니다.
  - liveStreamingDetails.actualEndTime – 방송이 실제로 종료된 시간입니다. 이 값은 방송이 종료된 후에 표시됩니다.
  - liveStreamingDetails.scheduledStartTime – 방송이 시작될 예정인 시간입니다.
  - liveStreamingDetails.scheduledEndTime: 방송이 종료될 예정인 시간입니다. 속성 값이 비어 있거나 속성이 없는 경우 브로드캐스트가 무기한으로 진행되도록 예약됩니다.
  - liveStreamingDetails.concurrentViewers – 라이브 방송을 시청하는 사용자 수입니다.
  이 메타데이터를 검색하려면 videos.list, videos.insert 또는 videos.update 메서드를 호출할 때 part 매개변수 값에 liveStreamingDetails를 포함합니다.
2013년 10월 1일에 라이브 방송 콘텐츠를 식별하는 다른 두 가지 기능(search.list 메서드의 eventType 매개변수 및 검색 결과의 snippet.liveBroadcastContent 속성)이 출시되었습니다.
이제 videos.insert 메서드에서 동영상 채널을 구독하는 사용자에게 새 동영상에 관한 알림을 전송해야 하는지 여부를 나타내는 notifySubscribers 매개변수를 지원합니다. 매개변수의 기본값은 True이며 구독자에게 새로 업로드된 동영상에 대한 알림이 전송됨을 나타냅니다. 하지만 동영상을 많이 업로드하는 채널 소유자는 채널의 구독자에게 새 동영상마다 알림을 보내지 않도록 값을 False로 설정하는 것이 좋습니다.
channels.update 메서드를 호출할 때 수정할 수 있는 속성 목록이 invideoPromotion.items[].customMessage 및 invideoPromotion.items[].websiteUrl 속성을 포함하도록 업데이트되었습니다. 또한 수정 가능한 brandingSettings 속성을 식별하도록 목록이 수정되었습니다. 이러한 brandingSettings 속성은 이미 수정 가능했으므로 문서 변경사항은 API의 기존 기능 변경사항을 반영하지 않습니다.
이제 playlists.insert, playlists.update, playlists.delete 메서드에서 다른 여러 메서드에서 이미 지원되는 onBehalfOfContentOwner 매개변수를 지원합니다.
이제 playlists.insert 메서드가 다른 여러 메서드에서 이미 지원되는 onBehalfOfContentOwnerChannel 매개변수를 지원합니다.
이제 video 리소스의 contentDetails.contentRating.tvpgRating 속성이 TV-14 평점에 해당하는 pg14 값을 지원합니다.
검색 결과의 일부인 snippet.liveBroadcastContent 속성의 정의가 live은 유효한 속성 값이지만 active은 유효한 속성 값이 아님을 반영하도록 수정되었습니다.
이제 video 리소스의 contentDetails.contentRating.mibacRating 속성에서 다음과 같은 두 가지 등급을 추가로 지원합니다.
- mibacVap (VAP) – 어린이는 성인을 동반해야 합니다.
- mibacVm6 (V.M.6) – 6세 이상 이용가
- mibacVm12 (V.M.12) – 12세 이상 이용가
channel 리소스의 새 invideoPromotion.items[].promotedByContentOwner 속성은 프로모션을 표시할 때 콘텐츠 소유자의 이름이 표시되는지 여부를 나타냅니다. 이 필드는 값을 설정하는 API 요청이 콘텐츠 소유자를 대신하여 이루어지는 경우에만 설정할 수 있습니다. 자세한 내용은 onBehalfOfContentOwner 매개변수를 참고하세요.

2013년 10월 1일

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

channel 리소스의 새 auditDetails 객체에는 다중 채널 네트워크 (MCN)가 특정 채널을 수락할지 거부할지 결정하는 동안 평가할 채널 데이터가 포함됩니다. 이 리소스 부분을 검색하는 모든 API 요청은 https://www.googleapis.com/auth/youtubepartner-channel-audit 범위가 포함된 승인 토큰을 제공해야 합니다. 또한 해당 범위를 사용하는 모든 토큰은 MCN에서 채널을 수락하거나 거부하기로 결정했을 때 또는 토큰이 발급된 날로부터 2주 이내에 취소되어야 합니다.
이제 channel 리소스의 invideoPromotion.items[].id.type 속성이 recentUpload 값을 지원합니다. 이 값은 추천 항목이 지정된 채널에서 가장 최근에 업로드된 동영상임을 나타냅니다.

기본적으로 채널은 인비디오 프로모션 데이터가 설정된 채널과 동일합니다. 하지만 새 invideoPromotion.items[].id.recentlyUploadedBy 속성의 값을 해당 채널의 채널 ID로 설정하여 다른 채널에서 가장 최근에 업로드된 동영상을 홍보할 수 있습니다.
channel 리소스에는 텔레비전 애플리케이션의 채널 페이지에 표시되는 배너 이미지의 URL을 지정하는 세 가지 새 속성(brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl, brandingSettings.image.bannerTvHighImageUrl)이 포함되어 있습니다.
검색 결과의 새로운 snippet.liveBroadcastContent 속성은 동영상 또는 채널 리소스에 라이브 방송 콘텐츠가 있는지 나타냅니다. 유효한 속성 값은 upcoming, active, none입니다.
- video 리소스의 경우 값이 upcoming이면 동영상이 아직 시작되지 않은 라이브 방송이고 값이 active이면 동영상이 진행 중인 라이브 방송임을 나타냅니다.
- channel 리소스의 경우 upcoming 값은 채널에 아직 시작되지 않은 예약된 방송이 있음을 나타내고 acive 값은 채널에 진행 중인 라이브 방송이 있음을 나타냅니다.
watermark 리소스에서 targetChannelId 속성이 객체에서 문자열로 변경되었습니다. 이제 targetChannelId 속성은 워터마크 이미지가 연결되는 채널의 YouTube 채널 ID를 지정하는 하위 속성을 포함하는 대신 해당 값 자체를 지정합니다. 이에 따라 리소스의 targetChannelId.value 속성이 삭제되었습니다.
이제 thumbnails.set 메서드가 다른 여러 메서드에서 이미 지원되는 onBehalfOfContentOwner 매개변수를 지원합니다.
이제 search.list 메서드에서 eventType 매개변수를 지원합니다. 이 매개변수는 검색이 활성, 예정된, 완료된 브로드캐스트 이벤트만 반환하도록 제한합니다.
새 contentDetails.contentRating.mibacRating 속성은 동영상이 이탈리아의 Ministero dei Beni e delle Attivita Culturali e del Turismo에서 받은 등급을 식별합니다.

이제 API에서 다음 오류를 지원합니다.

오류 유형	오류 세부정보	설명
`badRequest`	`invalidImage`	제공된 이미지 콘텐츠가 잘못된 경우 `thumbnails.set` 메서드는 이 오류를 반환합니다.
`forbidden`	`videoRatingDisabled`	평가 대상 동영상의 소유자가 동영상의 평가를 사용 중지한 경우 `videos.rate` 메서드는 이 오류를 반환합니다.

2013년 8월 27일

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

새 watermark 리소스는 지정된 채널의 동영상 재생 중에 표시되는 이미지를 식별합니다. 또한 동영상 재생 중 워터마크가 표시되는 시기와 표시되는 시간의 길이를 정하는 타이밍 세부정보뿐 아니라 이미지가 연결되는 타겟 채널도 지정할 수 있습니다.

watermarks.set 메서드는 채널의 워터마크 이미지를 업로드하고 설정합니다. watermarks.unset 메서드는 채널의 워터마크 이미지를 삭제합니다.

오류 문서에서는 API가 watermarks.set 및 watermarks.unset 메서드에 대해 구체적으로 지원하는 오류 메시지를 설명합니다.
channel 리소스의 새 statistics.hiddenSubscriberCount 속성에는 채널의 구독자 수가 숨겨져 있는지 여부를 나타내는 불리언 값이 포함되어 있습니다. 따라서 채널의 구독자 수가 공개적으로 표시되는 경우 속성 값은 false입니다.
이제 playlists.list 메서드가 onBehalfOfContentOwner 및 onBehalfOfContentOwnerChannel 매개변수를 지원합니다. 두 매개변수는 이미 다른 여러 메서드에서 지원됩니다.
이제 videos.list 메서드에서 차트를 가져와야 하는 콘텐츠 영역을 식별하는 regionCode 매개변수를 지원합니다. 이 매개변수는 chart 매개변수와 함께만 사용할 수 있습니다. 이 매개변수 값은 ISO 3166-1 alpha-2 국가 코드입니다de.

error documentation는 여러 API 메서드에서 발생할 수 있는 다음과 같은 새로운 일반적인 요청 오류를 설명합니다.

오류 유형	오류 세부정보	설명
`forbidden`	`insufficientPermissions`	요청에 제공된 OAuth 2.0 토큰과 연결된 범위가 요청된 데이터에 액세스하기에 충분하지 않습니다.

2013년 8월 15일

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

channel 리소스의 invideoPromotion 객체에는 다음과 같은 새로운 속성과 업데이트된 속성이 있습니다.
- 이제 API에서 웹사이트를 추천 상품으로 지정하는 기능을 지원합니다. 이렇게 하려면 invideoPromotion.items[].id.type 속성 값을 website로 설정하고 새 invideoPromotion.items[].id.websiteUrl 속성을 사용하여 URL을 지정합니다. 또한 새 invideoPromotion.items[].customMessage 속성을 사용하여 프로모션에 표시할 맞춤 메시지를 정의합니다.
  
  링크는 관련 웹사이트, 판매자 사이트 또는 소셜 네트워크 사이트로 연결될 수 있습니다. 콘텐츠의 링크를 사용 설정하는 방법에 대한 자세한 내용은 연결된 웹사이트 및 판매자 사이트에 관한 YouTube 고객센터 안내를 참고하세요.
  
  프로모션 링크를 추가하면 해당 링크가 승인되지 않은 사이트로 트래픽을 리디렉션하는 데 사용되지 않으며 YouTube의 Google Ads 정책, YouTube 광고 정책, YouTube 커뮤니티 가이드, YouTube 서비스 약관을 준수한다는 데 동의하는 것으로 간주됩니다.
- 동영상 재생 중에 추천 항목을 표시하는 타이밍 설정과 관련된 속성이 재구성되었습니다.
  - invideoPromotion.timing 객체가 invideoPromotion.items[].timing로 이동했습니다. 이제 이 객체를 사용하여 invideoPromotion.items[] 목록에 있는 각 추천 항목의 타이밍 데이터를 맞춤설정할 수 있습니다.
  - 새 invideoPromotion.defaultTiming 객체는 프로모션의 기본 타이밍 설정을 지정합니다. 이 설정은 채널의 동영상 재생 중에 추천 상품이 표시되는 시점을 정의합니다. invideoPromotion.items[].timing 객체를 사용하여 특정 추천 항목의 기본 타이밍을 재정의할 수 있습니다.
  - 새 invideoPromotion.items[].timing.durationMs 속성은 프로모션이 표시되어야 하는 시간(밀리초)을 지정합니다. invideoPromotion.defaultTiming 객체에는 추천 항목이 표시되는 기본 시간을 지정하는 durationMs 필드도 포함되어 있습니다.
- invideoPromotion.items[].type 및 invideoPromotion.items[].videoId 속성이 모두 invideoPromotion.items[].id 객체로 이동했습니다.
이제 subscriptions.list 메서드가 onBehalfOfContentOwner 및 onBehalfOfContentOwnerChannel 매개변수를 지원합니다. 두 매개변수는 이미 다른 여러 메서드에서 지원됩니다.
thumbnails.set 요청에 대한 API 응답에서 kind 속성 값이 youtube#thumbnailListResponse에서 youtube#thumbnailSetResponse로 변경되었습니다.
다음 메서드에 관한 코드 샘플이 추가되었습니다.
- channels.update (Java, Python)
- playlists.insert (.NET, PHP)
- subscriptions.insert (PHP, Python)
- thumbnails.set (PHP, Python)
- videos.insert (PHP)
- videos.list (PHP)
- videos.rate (Python)
- videos.update (Java, PHP, Python)
playlistItems.insert 메서드의 Python 예시도 삭제되었습니다. 이 예시에서 보여주는 기능은 이제 videos.rate 메서드에서 처리되기 때문입니다.

error documentation는 mine 요청 매개변수를 지원하는 모든 API 메서드에서 발생할 수 있는 다음과 같은 새로운 요청 컨텍스트 오류를 설명합니다.

오류 유형	오류 세부정보	설명
`badRequest`	`invalidMine`	인증된 사용자가 YouTube 파트너인 요청에는 `mine` 매개변수를 사용할 수 없습니다. `mine` 매개변수를 삭제하거나, `onBehalfOfContentOwner` 매개변수를 삭제하여 YouTube 사용자로 인증하거나, 호출된 메서드에 `onBehalfOfContentOwnerChannel` 매개변수가 있는 경우 이를 제공하여 파트너 채널 중 하나로 작동해야 합니다.

2013년 8월 8일

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

동영상 업로드의 할당량 비용이 약 16,000단위에서 약 1,600단위로 변경된 것을 반영하여 YouTube Data API 시작하기 가이드의 할당량 사용량 섹션이 업데이트되었습니다.

2013년 7월 30일

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

channelBanner 리소스에서 kind 속성 값이 youtube#channelBannerInsertResponse에서 youtube#channelBannerResource로 변경되었습니다. 이 리소스는 channelBanners.insert 요청에 대한 응답으로 반환됩니다.
channel 리소스의 새 brandingSettings.channel.profileColor 속성은 채널의 콘텐츠를 보완하는 눈에 띄는 색상을 지정합니다. 속성 값은 파운드 기호(#) 뒤에 6자리 16진수 문자열(예: #2793e6)이 옵니다.
이제 API에서 구독이 채널의 모든 활동에 적용되는지 아니면 새 업로드에만 적용되는지 지정하는 기능을 지원합니다. subscription 리소스의 새 contentDetails.activityType 속성은 구독자에게 알림이 전송되는 활동 유형을 식별합니다. 유효한 속성 값은 all 및 uploads입니다.
videos.list 메서드는 YouTube에서 가장 인기 있는 동영상의 차트를 가져오는 새로운 매개변수를 지원합니다.
- chart 매개변수는 검색할 차트를 식별합니다. 현재 유일하게 지원되는 값은 mostPopular입니다. chart 매개변수는 필터 매개변수이므로 다른 필터 매개변수 (id 및 myRating)와 동일한 요청에서 사용할 수 없습니다.
- videoCategoryId 매개변수는 차트를 가져와야 하는 동영상 카테고리를 식별합니다. 이 매개변수는 chart 매개변수와 함께만 사용할 수 있습니다. 기본적으로 차트는 특정 카테고리로 제한되지 않습니다.
video 리소스의 새 topicDetails.relevantTopicIds[] 속성은 동영상 또는 콘텐츠와 관련된 Freebase 주제 ID 목록을 제공합니다. 이러한 주제의 주제가 동영상에 언급되거나 동영상에 표시될 수 있습니다.
video 리소스의 recordingDetails.location.elevation 속성 이름이 recordingDetails.location.altitude로, fileDetails.recordingLocation.location.elevation 속성 이름이 fileDetails.recordingLocation.location.altitude로 변경되었습니다.
video 리소스의 contentDetails.contentRating 객체는 MPAA 등급, TVPG 등급 등 다양한 등급 체계에서 동영상이 받은 등급을 지정합니다. 이제 API는 각 평가 시스템에 대해 동영상에 평가가 적용되지 않았음을 나타내는 평가 값을 지원합니다. MPAA 등급의 경우, 자르지 않은 영화 버전의 공식 등급이 지정된 경우 자르지 않은 영화 버전을 식별하기 위해 '등급 없음' 등급이 자주 사용됩니다.
video 리소스의 새 contentDetails.contentRating.ytRating 속성은 연령 제한 콘텐츠를 식별합니다. YouTube에서 동영상에 18세 미만의 사용자에게 적합하지 않은 콘텐츠가 포함되어 있다고 판단한 경우 속성 값은 ytAgeRestricted입니다. 속성이 없거나 속성 값이 비어 있으면 콘텐츠에 연령 제한이 적용되지 않은 것입니다.
channels.list 메서드의 mySubscribers 매개변수가 지원 중단되었습니다. subscriptions.list 메서드와 mySubscribers 매개변수를 사용하여 인증된 사용자의 채널 구독자 목록을 가져옵니다.
이제 channelBanners.insert, channels.update, videos.getRating, videos.rate 메서드에서 모두 onBehalfOfContentOwner 매개변수를 지원합니다. 이 매개변수는 인증된 사용자가 매개변수 값에 지정된 콘텐츠 소유자를 대신하여 작업하고 있음을 나타냅니다.
channels.update 메서드의 문서가 channels.update 메서드를 사용하여 channel 리소스의 brandingSettings 객체와 하위 속성을 업데이트할 수 있다는 사실을 반영하도록 업데이트되었습니다. 이제 문서에는 channel 리소스의 invideoPromotion 객체에 설정할 수 있는 업데이트된 속성 목록도 나와 있습니다.

error documentation는 다음과 같은 새로운 오류를 설명합니다.

오류 유형	오류 세부정보	설명
`forbidden`	`accountDelegationForbidden`	이 오류는 특정 API 메서드에만 국한되지 않습니다. 인증된 사용자에게 지정된 Google 계정을 대신하여 작업할 권한이 없음을 나타냅니다.
`forbidden`	`authenticatedUserAccountClosed`	이 오류는 특정 API 메서드에만 국한되지 않습니다. 인증된 사용자의 YouTube 계정이 폐쇄되었음을 나타냅니다. 사용자가 다른 Google 계정을 대신하는 경우 이 오류는 해당 계정이 폐쇄되었음을 나타냅니다.
`forbidden`	`authenticatedUserAccountSuspended`	이 오류는 특정 API 메서드에만 국한되지 않습니다. 인증된 사용자의 YouTube 계정이 정지되었음을 나타냅니다. 사용자가 다른 Google 계정을 대신하는 경우 이 오류는 해당 계정이 정지되었음을 나타냅니다.
`forbidden`	`authenticatedUserNotChannel`	이 오류는 특정 API 메서드에만 국한되지 않습니다. API 서버에서 API 요청과 연결된 채널을 식별할 수 없음을 나타냅니다. 요청이 승인되고 `onBehalfOfContentOwner` 매개변수를 사용하는 경우 `onBehalfOfContentOwnerChannel` 매개변수도 설정해야 합니다.
`forbidden`	`cmsUserAccountNotFound`	이 오류는 특정 API 메서드에만 국한되지 않습니다. CMS 사용자는 지정된 콘텐츠 소유자를 대신하여 작업할 수 없습니다.
`notFound`	`contentOwnerAccountNotFound`	이 오류는 특정 API 메서드에만 국한되지 않습니다. 지정된 콘텐츠 소유자 계정을 찾을 수 없습니다.
`badRequest`	`invalidPart`	이 오류는 특정 API 메서드에만 국한되지 않습니다. 요청의 `part` 매개변수는 동시에 쓸 수 없는 부분을 지정합니다.
`badRequest`	`videoChartNotFound`	`videos.list` 메서드는 요청이 지원되지 않거나 사용할 수 없는 동영상 차트를 지정하면 이 오류를 반환합니다.
`notFound`	`videoNotFound`	`videos.update` 메서드는 업데이트하려는 동영상을 찾을 수 없음을 나타내기 위해 이 오류를 반환합니다. 요청 본문에서 `id` 속성의 값이 올바른지 확인합니다.

2013년 6월 10일

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

channels.list 메서드의 새로운 forUsername 매개변수를 사용하면 YouTube 사용자 이름을 지정하여 채널에 대한 정보를 검색할 수 있습니다.
이제 activities.list 메서드에서 지정된 국가와 관련된 결과를 반환하도록 API에 지시하는 regionCode 매개변수를 지원합니다. YouTube는 승인된 사용자의 이전 YouTube 활동 정보가 부족하여 활동 피드를 생성할 수 없을 경우에 이 값을 사용합니다.
이제 재생목록 리소스에 snippet.tags 속성이 포함됩니다. 이 속성은 자체 재생목록에 관한 데이터를 검색하는 승인된 사용자에게만 반환됩니다. 승인된 사용자는 playlists.insert 또는 playlists.update 메서드를 호출할 때 재생목록 태그를 설정할 수도 있습니다.
이전에 channels.list 및 search.list 메서드에서 지원되었던 onBehalfOfContentOwner 매개변수가 이제 videos.insert, videos.update, videos.delete 메서드에서도 지원됩니다. 이 매개변수가 videos.insert 메서드 호출에 사용되는 경우 요청에서 동영상이 추가될 채널을 식별하는 새 onBehalfOfContentOwnerChannel 매개변수의 값도 지정해야 합니다. 채널이 onBehalfOfContentOwner 매개변수가 지정하는 콘텐츠 소유자와 연결되어 있어야 합니다.

이 매개변수는 요청의 승인 사용자 인증 정보가 매개변수 값에 지정된 콘텐츠 소유자를 대신하는 YouTube CMS 사용자를 식별함을 나타냅니다. 사용자가 인증할 CMS 계정은 지정된 YouTube 콘텐츠 소유자에게 연결되어야 합니다.

이 매개변수는 여러 YouTube 채널을 소유하고 관리하는 콘텐츠 파트너를 위해 마련되었습니다. 이 파라미터를 사용하면 파트너가 한 번 인증하고 개별 채널마다 인증 사용자 인증 정보를 제공하지 않고도 모든 동영상 및 채널 데이터에 액세스할 수 있습니다.

특히 이번 출시와 관련하여 콘텐츠 파트너는 이 매개변수를 사용하여 소유한 YouTube 채널에서 동영상을 삽입, 업데이트 또는 삭제할 수 있습니다.

error documentation는 다음과 같은 새로운 오류를 설명합니다.

오류 유형	오류 세부정보	설명
`forbidden`	`insufficientCapabilities`	이 오류는 특정 API 메서드에만 국한되지 않습니다. API를 호출하는 CMS 사용자에게 요청된 작업을 실행할 권한이 충분하지 않음을 나타냅니다. 이 오류는 여러 API 메서드에서 지원되는 `onBehalfOfContentOwner` 매개변수 사용과 관련이 있습니다.
`unauthorized`	`authorizationRequired`	요청에서 `home` 매개변수를 사용하지만 제대로 승인되지 않은 경우 `activities.list` 메서드가 이 오류를 반환합니다.

channels 리소스에서 채널 ID가 이미 리소스의 id 속성을 사용하여 지정되었으므로 invideoPromotion.channelId 속성이 삭제되었습니다.
새 채널 ID 사용 가이드에서는 API가 채널 ID를 사용하는 방법을 설명합니다. 이 가이드는 이전 버전의 API에서 이전하고 default 사용자의 콘텐츠를 요청하거나 모든 YouTube 채널에 고유한 사용자 이름이 있다는 개념을 사용하는 애플리케이션이 있는 개발자에게 특히 유용할 수 있습니다. 더 이상 이 개념이 적용되지 않습니다.

2013년 5월 22일

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

새 channelBanners.insert 메서드를 사용하면 channel 리소스의 새 brandingSettings.image.bannerExternalUrl 속성을 사용하여 나중에 채널의 배너 이미지로 설정할 수 있는 배너 이미지를 업로드할 수 있습니다.
메서드를 호출할 때 수정할 수 있는 속성을 나열하도록 channels.update 메서드 문서가 업데이트되었습니다.
video 리소스 문서에 더 이상 unspecified가 suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[], suggestions.editorSuggestions[] 속성의 유효한 속성 값으로 나열되지 않습니다.
이제 videos.list 메서드의 maxResults 매개변수 기본값이 5입니다.
이제 error documentation에 channelBanners.insert 및 subscriptions.list 메서드의 오류가 표시됩니다. 또한 channels.update 메서드의 몇 가지 새로운 오류를 나열합니다.

2013년 5월 14일

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

이제 독립형 페이지에 Java, .NET, PHP, Ruby의 코드 샘플이 표시됩니다.
Python 코드 샘플이 나열된 페이지에 구독 추가, 재생목록 만들기, 동영상 업데이트의 예시가 포함되었습니다.

2013년 5월 10일

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

YouTube는 더 이상 실험용 API 기능과 서비스를 식별하지 않습니다. 대신에 지원 중단 정책에 따라 달라지는 YouTube API 목록을 제공합니다.

2013년 5월 8일

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

이제 채널 리소스에서 채널과 연결된 프로모션 캠페인에 관한 정보를 캡슐화하는 inVideoPromotion 객체를 지원합니다. 채널은 인비디오 프로모션 캠페인을 사용하여 채널의 동영상 재생 중에 동영상 플레이어 내에 프로모션 동영상의 썸네일 이미지를 표시할 수 있습니다.

channels.list 요청의 part 매개변수 값에 invideoPromotion를 포함하여 이 데이터를 검색할 수 있습니다.
새 channels.update 메서드를 사용하여 채널의 인비디오 프로모션 캠페인 데이터를 업데이트할 수 있습니다. 이 메서드는 channel 리소스의 invideoPromotion 부분에 대한 업데이트만 지원하며 아직 리소스의 다른 부분에 대한 업데이트는 지원하지 않습니다.

2013년 5월 2일

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

이제 채널 리소스에서 status.isLinked 속성을 지원합니다. 이 속성은 채널 데이터가 이미 YouTube 사용자 이름 또는 Google+ 계정에 연결된 사용자를 식별하는지 여부를 나타냅니다. 이 중 하나에 연결된 사용자는 공개적인 YouTube ID가 이미 있습니다. 이 ID는 동영상 업로드 등 여러 작업을 하려면 반드시 필요합니다s.
이제 구독 리소스가 subscriberSnippet 부분을 지원합니다. 이 객체는 구독자의 채널에 대한 스니펫 데이터를 캡슐화합니다.
이제 API는 인증된 사용자가 하나 이상의 동영상 목록에 부여한 평점을 가져오는 videos.getRating 메서드를 지원합니다.
videos.list 메서드의 새 myRating 매개변수를 사용하면 인증된 사용자가 like 또는 dislike 평점을 준 동영상 목록을 검색할 수 있습니다.

이제 myRating 매개변수와 id 매개변수가 모두 필터 매개변수로 간주됩니다. 즉, API 요청은 두 매개변수 중 하나를 정확히 하나만 지정해야 합니다. 이전에는 id 매개변수가 이 메서드의 필수 매개변수였습니다.

이 메서드는 동영상 평가 정보를 가져오려고 시도하지만 올바르게 승인되지 않은 요청에 대해 forbidden 오류를 반환합니다.
myRating 매개변수가 도입됨에 따라 videos.list 메서드도 페이징을 지원하도록 업데이트되었습니다. 단, 페이징 매개변수는 myRating 매개변수를 사용하는 요청에 대해서만 지원됩니다. id 매개변수를 사용하는 요청에는 페이징 매개변수와 정보가 지원되지 않습니다.
- maxResults 매개변수는 API가 결과 집합에서 반환할 수 있는 최대 동영상 수를 지정하고 pageToken 매개변수는 검색하려는 결과 집합의 특정 페이지를 식별합니다.
- videos.list 요청에 대한 응답으로 반환되는 youtube#videoListResponse 리소스에는 이제 총 결과 수 및 현재 결과 집합에 포함된 결과 수와 같은 세부정보가 포함된 pageInfo 객체가 포함됩니다. youtube#videoListResponse 리소스에는 nextPageToken 및 prevPageToken 속성도 포함될 수 있으며, 각각은 결과 집합에서 특정 페이지를 검색하는 데 사용할 수 있는 토큰을 제공합니다.
videos.insert 메서드는 다음과 같은 새 매개변수를 지원합니다.
- autoLevels – 이 매개변수 값을 true로 설정하면 YouTube에서 동영상의 밝기와 색상을 자동으로 보정하도록 지시합니다.
- stabilize – 이 매개변수 값을 true로 설정하면 YouTube에서 카메라 움직임으로 인한 흔들림을 제거하여 동영상을 조정하라는 명령을 내립니다.
다음 리소스의 snippet에 channelTitle 속성이 추가되었습니다.
- playlistItem: 재생목록 항목을 추가한 채널의 이름을 지정하는 속성입니다.
- playlist – 재생목록을 만든 채널의 이름을 지정하는 속성입니다.
- subscription – 이 속성은 구독 중인 채널의 이름을 지정합니다.
다음 메서드에 관한 코드 샘플이 추가되었습니다.
- activities.insert (Ruby)
- playlistItems.list (.NET)
- search.list (.NET)
- subscriptions.insert (Java, Ruby)
- videos.insert (.NET, Ruby)
subscriptions.list 메서드의 새 mySubscribers 매개변수를 사용하면 현재 인증된 사용자의 구독자 목록을 가져올 수 있습니다. 이 매개변수는 적절하게 승인된 요청에서만 사용할 수 있습니다.

참고: 이 기능은 현재 channels.list 메서드에 지원되는 mySubscribers 매개변수를 대체하기 위한 것입니다. 이 매개변수는 지원 중단됩니다.
video 리소스에서 속성 값 unspecified은 더 이상 다음 속성의 값이 될 수 없습니다.
예상치 못한 매개변수가 포함된 API 요청은 이제 badRequest 오류를 반환하며 보고된 오류의 이유는 unexpectedParameter입니다.
재생목록에 이미 허용된 최대 개수의 항목이 포함되어 있을 때 playlistItems.insert 메서드가 반환하는 오류가 업데이트되었습니다. 이제 오류가 forbidden 오류로 보고되고 오류 이유가 playlistContainsMaximumNumberOfVideos입니다.

2013년 4월 19일

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

새로운 videos.rate 메서드를 사용하면 사용자가 동영상에 like 또는 dislike 등급을 설정하거나 동영상에서 등급을 삭제할 수 있습니다.

videos.rate 메서드 호출에 대한 응답으로 API가 반환할 수 있는 오류를 나열하도록 오류 문서도 업데이트되었습니다.
이제 썸네일 이미지가 API 문서에서 별도의 리소스로 식별되며, 새로운 thumbnails.set 메서드를 사용하면 맞춤 동영상 썸네일을 YouTube에 업로드하고 동영상에 설정할 수 있습니다.

thumbnails.set 메서드 호출에 대한 응답으로 API가 반환할 수 있는 오류를 나열하도록 오류 문서도 업데이트되었습니다.

이 변경사항은 썸네일 이미지를 반환하는 기존 리소스에는 영향을 미치지 않습니다. 썸네일 이미지는 이전과 동일한 방식으로 이러한 리소스에서 반환되지만, 이제 문서에는 API가 반환할 수 있는 다양한 썸네일 크기의 이름이 나열됩니다.
channel 리소스의 새 brandingSettings 부분은 채널의 채널 페이지 및 동영상 보기 페이지의 설정, 텍스트, 이미지를 식별합니다.
playlistItem 리소스에는 다음과 같은 새로운 속성이 포함됩니다.
- 새 status 객체는 재생목록 항목에 관한 상태 정보를 캡슐화하고 status.privacyStatus 속성은 재생목록 항목의 공개 상태를 식별합니다.

video 리소스에는 다음과 같은 새로운 속성이 포함됩니다.

status.publicStatsViewable 속성은 보기 페이지의 확장 동영상 통계를 공개적으로 볼 수 있는지 여부를 나타냅니다. 기본적으로 이러한 통계는 볼 수 있으며 이 속성의 값이 false로 설정되더라도 동영상의 조회수 및 평점과 같은 통계는 계속 공개적으로 표시됩니다. videos.insert 또는 videos.update 메서드를 호출할 때 이 속성의 값을 설정할 수 있습니다.

contentDetails.contentRating 객체는 동영상이 다양한 평가 체계에서 받은 평가를 캡슐화합니다. 아래 목록에는 지원되는 평가 시스템이 나와 있으며 각 평가 시스템과 연결된 속성 링크도 제공됩니다. 속성 정의는 각 시스템에서 지원되는 등급 값을 식별합니다.

국가	등급 분류	속성
`United States`	Motion Pictures Association of America (MPAA)	`contentDetails.contentRating.mpaaRating`
`United States`	TV-PG	`contentDetails.contentRating.tvpgRating`
`Australia`	Australian Classification Board (ACB)	`contentDetails.contentRating.acbRating`
`Brazil`	Departamento de Justiça, Classificação, Qualificação e Títulos	`contentDetails.contentRating.djctqRating`
`Canada`	캐나다 홈비디오 등급 시스템 (CHVRS)	`contentDetails.contentRating.chvrsRating`
`France`	Centre national du cinéma et de l'image animée (프랑스 문화부)	`contentDetails.contentRating.fmocRating`
`Germany`	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	`contentDetails.contentRating.fskRating`
`Great Britain`	영국 영화 분류 위원회 (BBFC)	`contentDetails.contentRating.bbfcRating`
`India`	중앙 영화 인증 위원회 (CBFC)	`contentDetails.contentRating.cbfcRating`
`Japan`	映倫管理委員会 (EIRIN)	`contentDetails.contentRating.eirinRating`
`Korea`	영상물등급위원회 (KMRB)	`contentDetails.contentRating.kmrbRating`
`Mexico`	General Directorate of Radio, Television and Cinematography(RTC)(라디오, 텔레비전, 영화 제작 총국)	`contentDetails.contentRating.rtcRating`
`New Zealand`	영화 및 문학 분류국	`contentDetails.contentRating.oflcRating`
`Russia`	러시아 연방 국립 영화 등록처	`contentDetails.contentRating.russiaRating`
`Spain`	`Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA)`	`contentDetails.contentRating.icaaRating`

snippet.resourceId 속성을 요청 본문으로 전송된 리소스에 지정해야 한다는 사실을 반영하도록 playlistItems.update 메서드 문서가 업데이트되었습니다.
이제 search.list 메서드에서 다음 기능을 지원합니다.
- 새 forMine 매개변수는 인증된 사용자의 동영상만 검색되도록 제한합니다.
- 이제 order 매개변수가 제목순 (order=title) 또는 동영상 개수 내림차순 (order=videoCount)으로 결과를 정렬하는 기능을 지원합니다.
- 새 safeSearch 매개변수는 검색 결과에 제한된 콘텐츠를 포함해야 하는지 여부를 나타냅니다.

videos.insert 메서드는 아래 표에 나열된 여러 가지 새로운 오류를 지원합니다.

오류 유형	오류 세부정보	설명
`badRequest`	`invalidCategoryId`	`snippet.categoryId` 속성이 잘못된 카테고리 ID를 지정합니다. `videoCategories.list` 메서드를 사용하여 지원되는 카테고리를 검색합니다.
`badRequest`	`invalidRecordingDetails`	`metadata`는 잘못된 녹화 세부정보를 지정합니다.
`badRequest`	`invalidVideoGameRating`	요청 메타데이터가 잘못된 비디오 게임 등급을 지정합니다.
`badRequest`	`invalidVideoMetadata`	요청 메타데이터가 잘못되었습니다.

onBehalfOfContentOwner 매개변수가 videos.update 및 videos.delete 메서드에 지원되는 매개변수 목록에서 삭제되었습니다.

2013년 3월 12일

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

다음 리소스의 snippet에 channelTitle 속성이 추가되었습니다.
- activity – 이 속성은 활동을 담당하는 채널의 이름을 지정합니다.
- search: 이 속성은 검색 결과에서 식별한 리소스와 연결된 채널의 이름을 지정합니다.
- video – 이 속성은 동영상을 업로드한 채널의 이름을 지정합니다.
search.list 메서드는 다음과 같은 새 매개변수를 지원합니다.
- channelType 매개변수를 사용하면 채널 검색을 제한하여 모든 채널을 검색하거나 프로그램만 검색할 수 있습니다.
- videoType 매개변수를 사용하면 동영상 검색을 제한하여 모든 동영상을 검색하거나 영화만 검색하거나 TV 프로그램의 에피소드만 검색할 수 있습니다.
동영상의 위치정보 데이터 또는 녹화 시간이 설정된 경우에만 동영상에 대해 객체가 반환된다는 점을 명시하도록 video 리소스의 recordingDetails 부분 정의가 업데이트되었습니다.
이제 playlistItems.update 메서드가 invalidSnippet 오류를 반환합니다. 이 오류는 API 요청에서 유효한 스니펫을 지정하지 않은 경우 반환됩니다.
여러 API 메서드는 YouTube 콘텐츠 파트너 전용인 새 매개변수를 지원합니다. YouTube 콘텐츠 파트너에는 영화 및 TV 스튜디오, 음반사, YouTube에 콘텐츠를 제공하는 기타 콘텐츠 크리에이터가 포함됩니다.
- onBehalfOfContentOwner 매개변수는 요청의 승인 사용자 인증 정보가 매개변수 값에 지정된 콘텐츠 소유자를 대신하는 YouTube CMS 사용자를 식별함을 나타냅니다. 사용자가 인증할 CMS 계정은 지정된 YouTube 콘텐츠 소유자에게 연결되어야 합니다.
  
  이 매개변수는 여러 YouTube 채널을 소유하고 관리하는 콘텐츠 파트너를 위해 마련되었습니다. 이 파라미터를 사용하면 파트너가 한 번 인증하고 개별 채널마다 인증 사용자 인증 정보를 제공하지 않고도 모든 동영상 및 채널 데이터에 액세스할 수 있습니다.
  
  channels.list, search.list, videos.delete, videos.list, videos.update 메서드는 모두 이 매개변수를 지원합니다.
- channels.list 메서드에서 지원하는 managedByMe 매개변수는 API에 onBehalfOfContentOwner 매개변수가 지정하는 콘텐츠 소유자가 소유한 모든 채널을 반환하도록 지시합니다.
- search.list 메서드에서 지원하는 forContentOwner 매개변수는 onBehalfOfContentOwner 매개변수가 지정하는 콘텐츠 소유자가 소유한 리소스만 포함하도록 검색 결과를 제한하도록 API에 지시합니다.

2013년 2월 25일

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

이 API는 video 리소스의 여러 가지 새로운 부분과 속성을 지원합니다.
- 새로운 fileDetails, processingDetails, suggestions 부분은 동영상 소유자에게 업로드된 동영상에 대한 정보를 제공합니다. 이 데이터는 동영상 업로드를 지원하는 애플리케이션에서 매우 유용하며 다음을 포함합니다.
  - 처리 상태 및 진행률
  - 동영상을 처리하는 중에 발생한 오류 또는 기타 문제
  - 썸네일 이미지 사용 가능 여부
  - 동영상 또는 메타데이터 품질 개선을 위한 제안
  - YouTube에 업로드된 원본 파일의 세부정보
  이러한 모든 부분은 동영상 소유자만 검색할 수 있습니다. 아래 목록에서는 새 부품을 간단히 설명하고 video 리소스 문서에서는 각 부품에 포함된 모든 속성을 정의합니다.
  - fileDetails 객체에는 파일의 해상도, 길이, 오디오 및 동영상 코덱, 스트림 비트 전송률 등을 비롯하여 YouTube에 업로드된 동영상 파일에 관한 정보가 포함되어 있습니다.
  - processingProgress 객체에는 업로드된 동영상 파일 처리에 관한 YouTube의 진행률에 관한 정보가 포함됩니다. 객체의 속성은 현재 처리 상태를 식별하고 YouTube에서 동영상 처리를 완료할 때까지 남은 시간을 추정합니다. 또한 이 부분은 동영상에 파일 세부정보나 미리보기 이미지 등 다른 데이터나 콘텐츠 유형이 있는지 여부를 나타냅니다.
    이 객체는 동영상 업로더가 업로드된 동영상 파일의 처리 진행 상황을 추적할 수 있도록 폴링되도록 설계되었습니다.
  - suggestions 객체에는 업로드된 동영상의 동영상 품질 또는 메타데이터를 개선할 수 있는 기회를 식별하는 추천이 포함됩니다.
- contentDetails 부분에는 4개의 새 속성이 포함되어 있습니다. 이러한 속성은 인증되지 않은 요청으로 검색할 수 있습니다.
  - dimension – 동영상을 2D로 볼 수 있는지 또는 3D로 볼 수 있는지 나타냅니다.
  - definition: 동영상을 표준 화질로 시청할 수 있는지 또는 고화질로 시청할 수 있는지 나타냅니다.
  - caption: 동영상에 자막을 사용할 수 있는지 여부를 나타냅니다.
  - licensedContent – YouTube 콘텐츠 파트너가 소유권을 주장한 콘텐츠가 동영상에 포함되어 있는지 나타냅니다.
- status 부분에는 두 가지 새로운 속성이 포함되어 있습니다. 동영상 소유자는 동영상을 삽입하거나 업데이트할 때 두 속성의 값을 모두 설정할 수 있습니다. 이러한 속성은 인증되지 않은 요청으로 검색할 수도 있습니다.
  - embeddable – 동영상을 다른 웹사이트에 퍼갈 수 있는지 여부를 나타냅니다.
  - license – 동영상의 라이선스를 지정합니다. 유효한 값은 creativeCommon, youtube입니다.
part 매개변수의 정의가 videos.list, videos.insert, videos.update 메서드에 대해 업데이트되어 위에서 설명한 새로 추가된 부분과 실수로 누락된 recordingDetails 부분을 나열합니다.
channel 리소스의 새 contentDetails.googlePlusUserId 속성은 채널과 연결된 Google+ 프로필 ID를 지정합니다. 이 값은 Google+ 프로필 링크를 생성하는 데 사용할 수 있습니다.
이제 각 썸네일 이미지 객체가 이미지의 너비와 높이를 지정합니다. 썸네일 이미지는 현재 activity, channel, playlist, playlistItem, search result, subscription, video 리소스로 반환됩니다.
이제 playlistItems.list가 videoId 매개변수를 지원합니다. 이 매개변수는 playlistId 매개변수와 함께 사용하여 지정된 동영상을 나타내는 재생목록 항목만 검색할 수 있습니다.

매개변수가 식별하는 동영상을 재생목록에서 찾을 수 없는 경우 API는 notFound 오류를 반환합니다.
오류 문서에서는 요청된 작업에 대해 요청이 올바르게 승인되지 않았음을 나타내는 새로운 forbidden 오류를 설명합니다.
channel 리소스의 snippet.channelId 속성이 삭제되었습니다. 리소스의 id 속성은 동일한 값을 제공합니다.

2013년 1월 30일

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

새 오류 페이지에는 API에서 반환할 수 있는 오류가 나열됩니다. 이 페이지에는 여러 API 메서드에서 발생할 수 있는 일반적인 오류와 메서드별 오류가 포함되어 있습니다.

2013년 1월 16일

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

이제 아래 목록에 표시된 메서드와 언어에 관한 코드 샘플을 사용할 수 있습니다.
- activities.insert – Java
- playlistItems.insert – Python
- playlistItems.list – Java, JavaScript, PHP, Python, Ruby
- playlists.insert – Java, JavaScript, Python
- search.list – Java, JavaScript, Python, Ruby
- videos.insert – Java
이제 activity 리소스가 YouTube에서 자동 생성된 YouTube 채널에 동영상을 추가할 때 발생하는 channelItem 액션을 보고할 수 있습니다. YouTube는 알고리즘을 통해 YouTube 웹사이트에서 상당한 존재감을 보이는 주제를 파악하고 해당 주제의 채널을 자동으로 생성합니다.
다음 search.list 매개변수가 업데이트되었습니다.
- q 매개변수가 더 이상 필터로 지정되지 않습니다. 즉, 다음과 같은 의미입니다.
- relatedToVideo 매개변수의 이름이 relatedToVideoId로 변경되었습니다.
- published 매개변수가 아래에 설명된 두 가지 새 매개변수 publishedAfter 및 publishedBefore로 대체되었습니다.

search.list 메서드는 다음과 같은 새 매개변수를 지원합니다.

매개변수 이름	값	설명
`channelId`	`string`	지정된 채널에서 생성된 리소스를 반환합니다.
`publishedAfter`	`datetime`	지정된 시간 이후에 생성된 리소스를 반환합니다.
`publishedBefore`	`datetime`	지정된 시간 전에 생성된 리소스를 반환합니다.
`regionCode`	`string`	지정된 국가의 리소스를 반환합니다.
`videoCategoryId`	`string`	지정된 동영상 카테고리와 연결된 동영상만 포함하도록 동영상 검색 결과를 필터링합니다.
`videoEmbeddable`	`string`	동영상 검색 결과를 필터링하여 웹페이지의 삽입된 플레이어에서 재생할 수 있는 동영상만 포함합니다. 삽입 가능한 동영상만 검색하려면 매개변수 값을 `true`로 설정합니다.
`videoSyndicated`	`string`	YouTube.com 외부에서 재생할 수 있는 동영상만 포함하도록 동영상 검색 결과를 필터링합니다. 매개변수 값을 `true`로 설정하여 제휴 동영상만 검색합니다.

여러 API 리소스가 새 속성을 지원합니다. 아래 표에는 리소스와 새 속성이 나와 있습니다.

리소스	속성 이름	값	설명
`activity`	`contentDetails.playlistItem.playlistItemId`	`string`	YouTube에서 재생목록의 항목을 고유하게 식별하기 위해 할당한 재생목록 항목 ID입니다.
`activity`	`contentDetails.channelItem`	`object`	채널에 추가된 리소스에 관한 정보를 포함하는 객체입니다. 이 속성은 `snippet.type`가 `channelItem`인 경우에만 존재합니다.
`activity`	`contentDetails.channelItem.resourceId`	`object`	채널에 추가된 리소스를 식별하는 객체입니다. 다른 `resourceId` 속성과 마찬가지로 동영상 또는 재생목록과 같은 리소스 유형을 지정하는 `kind` 속성이 포함되어 있습니다. 또한 리소스를 고유하게 식별하는 ID를 지정하는 여러 속성(`videoId`, `playlistId` 등) 중 정확히 하나가 포함됩니다.
`channel`	`status`	`object`	이 객체는 채널의 개인 정보 보호 상태에 관한 정보를 캡슐화합니다.
`channel`	`status.privacyStatus`	`string`	채널의 공개 범위 설정입니다. 유효한 값은 `private`, `public`입니다.
`playlist`	`contentDetails`	`object`	이 객체에는 재생목록 콘텐츠에 관한 메타데이터가 포함되어 있습니다.
`playlist`	`contentDetails.itemCount`	`unsigned integer`	재생목록의 동영상 수입니다.
`playlist`	`player`	`object`	이 객체에는 삽입된 플레이어에서 재생목록을 재생하는 데 사용할 정보가 포함되어 있습니다.
`playlist`	`player.embedHtml`	`string`	재생목록을 재생하는 동영상 플레이어를 삽입하는 `<iframe>` 태그입니다.
`video`	`recordingDetails`	`object`	이 객체는 동영상이 녹화된 장소와 시간을 식별하거나 설명하는 정보를 캡슐화합니다.
`video`	`recordingDetails.location`	`object`	이 객체에는 동영상과 연결된 위치정보가 포함되어 있습니다.
`video`	`recordingDetails.location.latitude`	`double`	위도(도)입니다.
`video`	`recordingDetails.location.longitude`	`double`	경도입니다.
`video`	`recordingDetails.location.elevation`	`double`	지구 위의 고도(미터)입니다.
`video`	`recordingDetails.locationDescription`	`string`	동영상이 녹화된 위치에 대한 텍스트 설명입니다.
`video`	`recordingDetails.recordingDate`	`datetime`	동영상을 녹화한 날짜 및 시간 값은 ISO 8601 (`YYYY-MM-DDThh:mm:ss.sZ`) 형식으로 지정됩니다.

이제 여러 API 메서드에 관한 문서에서 요청 본문에 지정되어야 하거나 요청 본문의 값을 기반으로 업데이트되는 속성을 식별합니다. 아래 표에는 이러한 메서드와 필수 또는 수정 가능한 속성이 나와 있습니다.

참고: 다른 메서드의 문서에 이미 필수 속성과 수정 가능한 속성이 나열되어 있을 수 있습니다.

메서드	속성
`activities.insert`	필수 속성: `snippet.description` 수정 가능한 속성: `snippet.description` `contentDetails.bulletin.resourceId`
`playlists.update`	필수 속성: `id`
`playlistItems.update`	필수 속성: `id`
`videos.update`	필수 속성: `id`

동일한 채널에 이미 있는 재생목록과 제목이 동일한 재생목록을 만들거나 업데이트하려고 하면 API에서 더 이상 playlistAlreadyExists 오류를 보고하지 않습니다.

여러 API 메서드가 새로운 오류 유형을 지원합니다. 아래 표에는 메서드와 새로 지원되는 오류가 나와 있습니다.

메서드	오류 유형	오류 세부정보	설명
`guideCategories.list`	`notFound`	`notFound`	`id` 매개변수로 식별된 가이드 카테고리를 찾을 수 없습니다. guideCategories.list 메서드를 사용하여 유효한 값 목록을 가져옵니다.
`playlistItems.delete`	`forbidden`	`playlistItemsNotAccessible`	지정된 재생목록 항목을 삭제할 수 있도록 요청이 제대로 인증되지 않았습니다.
`videoCategories.list`	`notFound`	`videoCategoryNotFound`	`id` 매개변수로 식별된 동영상 카테고리를 찾을 수 없습니다. videoCategories.list 메서드를 사용하여 유효한 값 목록을 가져옵니다.

업데이트 기록 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

2025년 3월 26일

2024년 10월 30일

2024년 4월 30일

2024년 3월 13일

2024년 3월 12일

2024년 3월 7일

2024년 1월 31일

2023년 11월 9일

2023년 9월 12일

2023년 8월 22일

2023년 8월 18일

2023년 8월 7일

2023년 6월 28일

2023년 6월 12일

2022년 8월 22일

2022년 8월 5일

2022년 7월 12일

2022년 4월 27일

2022년 4월 8일

2021년 12월 15일

2021년 11월 18일

2021년 7월 2일

2021년 7월 1일

2021년 5월 12일

2021년 2월 9일

2021년 1월 28일

2020년 10월 15일

2020년 10월 8일

2020년 9월 9월

2020년 7월 29일

2020년 7월 28일

2020년 7월 21일

2020년 7월 7일

2020년 6월 15일

2020년 6월 4일

2020년 4월 17일

2020년 3월 31일

2020년 1월 10일

2019년 9월 10일

2019년 4월 4일

2018년 7월 9일

2018년 6월 22일

2017년 11월 27일

2017년 11월 16일

2017년 10월 25일

2017년 8월 29일

2017년 7월 24일

2017년 6월 1일

2017년 5월 17일

2017년 4월 27일

2017년 3월 30일

2017년 2월 27일

2016년 11월 29일

2016년 11월 10일

2016년 11월 2일

2016년 9월 15일

2016년 8월 11일

2016년 6월 13일

2016년 5월 31일

2016년 5월 17일

2016년 4월 28일

2016년 4월 20일

2016년 3월 16일

2015년 12월 18일

2015년 11월 19일

2015년 11월 4일

2015년 8월 28일

2015년 8월 7일

2015년 6월 18일

2015년 4월 27일

2015년 4월 16일

2015년 4월 9일

2015년 4월 2일

2015년 3월 11일

2015년 3월 4일

2015년 3월 2일

2015년 1월 14일

2014년 11월 11일

2014년 10월 8일

업데이트 기록
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.