기존 YouTube Data API v2의 댓글 변경사항

YouTube API팀 Jeremy Walker
2013년 9월 (2013년 12월 2일 업데이트됨)

소개

2013년 11월에 출시된 Google+의 새로운 YouTube 댓글 달기 시스템을 통해 YouTube 사용자는 이전보다 더 많은 동영상당 댓글을 검색할 수 있습니다. 새 시스템에서도 의미 있는 대화를 쉽게 찾을 수 있습니다. 댓글은 사용자별로 관련성에 따라 정렬되기 때문입니다.

현재 YouTube Data API v3에서는 새로운 댓글이 지원되지 않지만 이전 버전 API(v2)를 계속 사용할 수 있으며 몇 가지 주의사항과 위에서 설명한 이점이 있습니다.

새로운 댓글 시스템으로 전환했으므로 이제 통합이 계속 작동하는지 확인하고 버그가 발생하면 YouTube에 알려주세요 (youtube.com/dev에서 문제 신고). 감사합니다.

자주 묻는 질문(FAQ)

전환되기 전에 게시된 댓글은 어떻게 되나요?

전환하기 전에 게시된 댓글은 Google+에서 제공하는 새 시스템으로 이전됩니다.

댓글 피드를 계속 사용할 수 있나요?

예. API를 사용하여 동영상의 댓글을 가져오는 경우 공지사항에 언급된 대로 관련성에 따라 정렬된 댓글 피드를 받게 됩니다.* 새 댓글 시스템으로 전환했기 때문에 기본적으로 더 이상 시간순으로 표시되지 않습니다. 그러나 다음 예와 같이 API 요청에서 orderby 매개변수의 값을 published로 설정하여 시간순으로 댓글을 정렬할 수 있습니다.

https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?orderby=published

댓글 피드의 nextprevious 링크를 사용하여 페이지를 자세히 설명하는 표준 권장사항을 따르는 것이 좋습니다. 이렇게 하면 이전보다 더 많은 댓글을 살펴볼 수 있다는 추가적인 이점도 얻을 수 있습니다.

댓글 피드를 통해 페이징하도록 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로 새 주석을 작성하려면 몇 가지 요구사항이 있습니다.

  1. 인증된 사용자에게 YouTube 채널이 Google+ 계정에 연결되어 있어야 합니다 (API 세부정보).
  2. 요청은 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에 표시되지 않습니다.