Comments

comment 리소스에는 단일 YouTube 댓글에 관한 정보가 포함되어 있습니다. comment 리소스는 동영상 또는 채널에 관한 댓글을 나타낼 수 있습니다. 또한 댓글은 최상위 댓글이거나 최상위 댓글에 대한 답글일 수 있습니다.

메서드

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

list
API 요청 매개변수와 일치하는 댓글 목록을 반환합니다. 지금 사용해보기
insert
기존 댓글에 대한 답글을 만듭니다. 참고: 최상위 댓글을 만들려면 commentThreads.insert 메서드를 사용하세요. 지금 사용해 보기
업데이트
댓글을 수정합니다. 지금 사용해보기
삭제
댓글을 삭제합니다. 지금 사용해보기
setModerationStatus
하나 이상의 댓글의 검토 상태를 설정합니다. API 요청은 댓글과 연결된 채널 또는 동영상의 소유자가 승인해야 합니다. 지금 사용해보기

리소스 표현

다음 JSON 구조에서 comments 리소스의 형식을 보여줍니다.

{
  "kind": "youtube#comment",
  "etag": etag,
  "id": string,
  "snippet": {
    "authorDisplayName": string,
    "authorProfileImageUrl": string,
    "authorChannelUrl": string,
    "authorChannelId": {
      "value": string
    },
    "channelId": string,
    "textDisplay": string,
    "textOriginal": string,
    "parentId": string,
    "canRate": boolean,
    "viewerRating": string,
    "likeCount": unsigned integer,
    "moderationStatus": string,
    "publishedAt": datetime,
    "updatedAt": datetime
  }
}

속성

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

속성
kind string
API 리소스의 유형을 식별합니다. 값은 youtube#comment입니다.
etag etag
이 리소스의 ETag입니다.
id string
YouTube에서 댓글을 고유하게 식별하는 데 사용하는 ID입니다.
snippet object
snippet 객체에는 댓글에 관한 기본 세부정보가 포함됩니다.
snippet.authorDisplayName string
댓글을 게시한 사용자의 표시 이름입니다.
snippet.authorProfileImageUrl string
댓글을 게시한 사용자의 아바타 URL입니다.
snippet.authorChannelUrl string
댓글 작성자의 YouTube 채널 URL입니다(있는 경우).
snippet.authorChannelId object
이 객체는 댓글 작성자의 YouTube 채널에 관한 정보를 캡슐화합니다(있는 경우).
snippet.authorChannelId.value string
댓글 작성자의 YouTube 채널 ID입니다(있는 경우).
snippet.channelId string
댓글과 연결된 YouTube 채널의 ID입니다.
snippet.textDisplay string
댓글의 텍스트입니다. 텍스트는 일반 텍스트 또는 HTML로 가져올 수 있습니다. (comments.list 및 commentThreads.list 메서드는 모두 선택한 텍스트 형식을 지정하는 textFormat 매개변수를 지원합니다.)

일반 텍스트도 원래 댓글 텍스트와 다를 수 있습니다. 예를 들어 동영상 링크를 동영상 제목으로 대체할 수 있습니다.
snippet.textOriginal string
댓글의 원래 텍스트입니다. 처음 게시되었거나 마지막으로 업데이트된 텍스트입니다. 인증된 사용자가 댓글 작성자인 경우에만 원본 텍스트가 반환됩니다.
snippet.parentId string
상위 댓글의 고유 ID입니다. 이 속성은 댓글이 다른 댓글에 대한 답글로 제출된 경우에만 설정됩니다.
snippet.canRate boolean
이 설정은 현재 뷰어가 댓글을 평가할 수 있는지 여부를 나타냅니다.
snippet.viewerRating string
시청자가 이 댓글에 부여한 평가입니다. 이 속성은 dislike 등급을 식별하지 않지만 이 동작은 변경될 수 있습니다. 그동안 시청자가 댓글을 긍정적으로 평가한 경우 속성 값은 like입니다. 사용자가 댓글에 부정적인 평점을 부여했거나 댓글을 평가하지 않은 경우를 비롯한 다른 모든 경우에 값은 none입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • like
  • none
snippet.likeCount unsigned integer
댓글이 받은 총 좋아요 수 (긍정적 평가)입니다.
snippet.moderationStatus string
댓글의 검토 상태입니다. 이 속성은 요청된 댓글이 작성된 채널 또는 동영상의 소유자가 API 요청을 승인한 경우에만 반환됩니다. 또한 API 요청에서 id 필터 매개변수를 사용한 경우 이 속성은 설정되지 않습니다.

이 속성의 유효한 값은 다음과 같습니다.
  • heldForReview
  • likelySpam
  • published
  • rejected
snippet.publishedAt datetime
댓글이 원래 게시된 날짜와 시간입니다. 값은 ISO 8601 형식으로 지정됩니다.
snippet.updatedAt datetime
의견이 마지막으로 업데이트된 날짜와 시간입니다. 값은 ISO 8601 형식으로 지정됩니다.