Comments

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

메서드

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

list
API 요청 매개변수와 일치하는 댓글 목록을 반환합니다. 지금 사용해보기
insert
기존 댓글에 대한 답글을 작성합니다. 참고: 최상위 주석을 만들려면 commentThreads.insert 메서드를 사용하세요. 지금 사용해 보기
업데이트
댓글을 수정합니다. 지금 사용해보기
삭제
댓글을 삭제합니다. 지금 사용해보기
setModerationStatus
하나 이상의 댓글의 검토 상태를 설정합니다. 댓글과 연결된 채널 또는 동영상의 소유자가 API 요청을 승인해야 합니다. 지금 사용해보기
markAsSpam
참고: 이 메서드는 지원 중단되었으며 더 이상 지원되지 않습니다.
하나 이상의 댓글을 스팸으로 신고해야 한다는 호출자의 의견을 표현합니다.

리소스 표현

다음 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
Comment의 작성자 표시 이름입니다.
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.listcommentThreads.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 형식으로 지정됩니다.