2013년 9월 (2013년 12월 2일 업데이트됨)
소개
2013년 11월에 출시되었으며 Google+를 기반으로 하는 새로운 YouTube 댓글 시스템을 통해 YouTube 사용자는 이전보다 동영상당 더 많은 댓글을 검색할 수 있습니다. 또한 댓글이 개별 사용자와의 관련성별로 정렬되므로 의미 있는 대화를 더 쉽게 찾을 수 있습니다.
현재 YouTube Data API v3에서는 새 댓글이 지원되지 않지만 아래에 설명된 몇 가지 예외사항과 위에서 설명한 이점을 고려하여 이전 버전의 API(v2)를 계속 사용할 수 있습니다.
새로운 댓글 시스템으로 전환했으므로 통합이 계속 작동하는지 확인하고 버그가 있으면 (youtube.com/dev에서 파일 문제) 알려 주시기 바랍니다. 감사합니다.
자주 묻는 질문(FAQ)
전환 전에 게시된 댓글은 어떻게 되나요?
전환 전에 게시된 댓글은 Google+ 기반의 새 시스템으로 이전되었습니다.
댓글 피드를 계속 사용할 수 있나요?
예. 예를 들어 API를 사용하여 동영상의 댓글을 검색하면 공지사항에 설명된 대로 관련성별로 정렬된 댓글 피드를 가져올 수 있습니다.* 새로운 댓글 시스템으로 전환됨에 따라 기본적으로 댓글이 더 이상 시간순으로 표시되지 않습니다. 그러나 다음 예와 같이 API 요청에서 orderby 매개변수의 값을 published로 설정하면 댓글을 시간순으로 정렬할 수 있습니다.
https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?orderby=published댓글 피드의 next 및 previous 링크를 사용하여 댓글을 페이지로 나누는 표준 권장사항을 따르는 것이 좋습니다. 이렇게 하면 이전보다 더 많은 댓글을 페이지로 넘겨 볼 수 있는 추가적인 이점도 얻을 수 있습니다.
댓글 피드를 통해 페이징할 start-index 값을 명시적으로 설정하면 (권장하지 않음) 일관되지 않은 동작이 발생할 수 있으며 소수의 댓글만 반환됩니다.
업데이트(2013년 11월 10일):
* 기본적으로 댓글 피드는 개인적 관련성이 아닌 일반 관련성을 기준으로 정렬됩니다. 즉, 인증된 댓글 피드 요청과 인증되지 않은 댓글 피드 요청은 동일한 결과를 반환합니다.
API는 비공개 게시물이 포함된 맞춤설정된 댓글 피드를 지원합니다. 이 피드를 가져오려면 인증된 요청을 실행하고 다음 예와 같이 API 요청에서 relevant-to-me 매개변수의 값을 true로 설정하면 됩니다.
https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?relevant-to-me=true
새 피드의 형식을 보여주는 피드가 있나요?
이제 모든 댓글 피드에서 새 형식을 지원합니다. 다음은 몇 가지 예입니다.
- 관련성 기반 피드:
http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true
- 시간순 피드:
http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published
API를 통해 댓글을 작성할 수 있나요?
예. 하지만 v2 API로 새 코멘트를 작성하려면 몇 가지 요구사항이 있습니다.
- 인증된 사용자에게 Google+ 계정에 연결된 YouTube 채널이 있어야 합니다(API 세부정보).
- 요청은 HTTPS를 통해 전송되어야 합니다 (현재 버전의 기존 클라이언트 라이브러리는 이 기능을 기본적으로 지원함).
이러한 요구사항 중 하나라도 충족되지 않으면 API에서 오류를 반환합니다.
Google+에서 제공하는 댓글은 대화목록 기능을 제공합니다. YouTube 댓글에 달린 답글에 어떤 영향이 있나요?
이전 전에 작성된 댓글 답글은 이제 일반 댓글로 표시됩니다. 또한 YouTube API를 통해 댓글에 직접 답하는 기능도 더 이상 지원되지 않습니다. 현재 YouTube API를 통해 새 형식의 댓글에 답글을 달 수 있는 방법은 없습니다.
YouTube 및 Google+ 사이트와 앱을 통한 새로운 형식의 YouTube 댓글에 대한 답글은 기존 API의 댓글 피드와 함께 반환되지 않습니다. 하지만 Google+ API를 통해 실제 답장을 받을 수 있습니다.
YouTube 댓글 피드 항목이 새로운 스타일의 댓글을 나타내는 경우 항목에 <yt:googlePlusUserId> 태그가 포함됩니다. 이 태그가 있고 댓글에 답글이 있는 경우 (<yt:replyCount> 요소만 확인) 항목의 <id> 태그에서 Google+ 활동 ID를 파싱할 수 있습니다. 이 ID를 사용하여 Google+ API의 comments:list 메서드를 호출하여 해당 댓글에 대한 최근 답글 목록을 가져올 수 있습니다.
아래 발췌 부분은 Google+ 활동 ID가 댓글 피드 항목에 굵은 텍스트로 표시되는 방식을 보여줍니다.
<entry> <id>tag:youtube,2008:video:xpI6VNvRTII:comment:z13rtnibotmidjggs04cdvzgvurngv3pwnw0k</id> <yt:googlePlusUserId>123456789</yt:googlePlusUserId> <yt:replyCount>4</yt:replyCount> <yt:channelId>UCxxxx_xxxxx</yt:channelId> ... </entry>
YouTube API를 통해 댓글을 작성하면 Google+에서 어떻게 되나요?
YouTube API를 통해 댓글을 달아도 Google+ 스트림에 게시물이 생성되지 않으며 Google+ 알림도 생성되지 않습니다.
새로운 댓글 시스템으로 전환한 후에도 활동 피드에 댓글이 계속 표시되나요?
아니요. 지금은 사용하지 않겠습니다.
기존 API의 SUP가 댓글에 계속 작동하나요?
아니요, 댓글을 쓰지 않습니다. SUP는 사용자 활동 피드를 사용합니다. 댓글이 더 이상 활동 피드에 표시되지 않으므로 SUP에 표시되지 않습니다.