CommentThreads

commentThread 리소스에는 최상위 댓글 및 댓글에 대한 답글로 구성된 YouTube 댓글 대화목록에 대한 정보가 포함됩니다. commentThread 리소스는 동영상 또는 채널에 대한 댓글을 나타낼 수 있습니다.

최상위 댓글과 답글은 실제로 commentThread 리소스 내에 중첩된 comment 리소스입니다. commentThread 리소스에 댓글에 대한 모든 응답이 반드시 포함되는 것은 아니며 특정 댓글에 대한 모든 답장을 검색하려면 comments.list 메서드를 사용해야 합니다. 일부 댓글에는 답글이 없습니다.

방법

API는 commentThreads 리소스에 다음 메서드를 지원합니다.

list
API 요청 매개변수와 일치하는 댓글 스레드 목록을 반환합니다. 지금 사용해보기
삽입
새로운 최상위 수준 댓글을 작성합니다. 기존 댓글에 답글을 추가하려면 대신 comments.insert 메서드를 사용합니다. 지금 사용해 보기

리소스 표현

아래의 JSON 구조는 commentThreads 리소스의 형식을 보여줍니다.

{
  "kind": "youtube#commentThread",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "videoId": string,
    "topLevelComment": comments Resource,
    "canReply": boolean,
    "totalReplyCount": unsigned integer,
    "isPublic": boolean
  },
  "replies": {
    "comments": [
      comments Resource
    ]
  }
}

속성

다음 표는 이 리소스에 표시되는 속성을 정의합니다.

속성
kind string
API 리소스의 유형을 식별합니다. 값은 youtube#commentThread입니다.
etag etag
이 리소스의 Etag입니다.
id string
YouTube가 댓글 대화목록을 고유하게 식별하는 데 사용하는 ID입니다.
snippet object
snippet 객체에는 댓글 스레드에 관한 기본 세부정보가 포함되어 있습니다. 또한 스레드의 최상위 수준 주석인 comment 리소스가 포함되어 있습니다.
snippet.channelId string
대화목록의 댓글과 연결된 YouTube 채널입니다. snippet.videoId 속성은 동영상을 식별합니다.
  • 동영상에 대한 댓글인 경우 값은 동영상을 업로드한 채널을 나타냅니다. snippet.videoId 속성은 동영상을 식별합니다.
  • 주석이 채널 자체를 참조하는 경우 snippet.videoId 속성에는 값이 없습니다.
snippet.videoId string
댓글이 참조되는 동영상의 ID입니다(있는 경우). 이 속성이 존재하지 않거나 값이 없는 경우 대화목록은 채널에 적용되며 특정 동영상에 적용되지는 않습니다.
snippet.topLevelComment object
대화목록의 최상위 댓글입니다. 속성의 값은 comment 리소스입니다.
snippet.canReply boolean
이 설정은 현재 뷰어가 대화목록에 답장할 수 있는지 여부를 나타냅니다.
snippet.totalReplyCount unsigned integer
최상위 댓글에 대한 응답으로 제출된 총 답변 수입니다.
snippet.isPublic boolean
이 설정은 모든 댓글과 댓글의 답글을 포함한 대화목록이 모든 YouTube 사용자에게 표시되는지를 나타냅니다.
replies object
replies 객체는 댓글에 대한 답글 목록이 있는 컨테이너(있는 경우)입니다. replies.comments 속성은 주석 자체의 목록을 나타냅니다.
replies.comments[] list
최상위 댓글에 대한 하나 이상의 답변 목록입니다. 목록의 각 항목은 comment 리소스입니다.

목록의 응답 수는 제한되어 있습니다. 목록의 항목 수가 snippet.totalReplyCount 속성의 값과 같지 않으면 답장 목록은 최상위 댓글에 사용할 수 있는 총 답글 수의 일부에 불과합니다. 최상위 댓글에 대한 모든 응답을 검색하려면 comments.list 메서드를 호출하고 parentId 요청 매개변수를 사용하여 응답을 검색하려는 댓글을 식별해야 합니다.