comment 리소스에는 단일 YouTube 댓글에 관한 정보가 포함되어 있습니다. comment 리소스는 동영상 또는 채널에 관한 댓글을 나타낼 수 있습니다. 또한 댓글은 최상위 댓글이거나 최상위 댓글에 대한 답글일 수 있습니다.
메서드
API는 comments 리소스에 대해 다음 메서드를 지원합니다.
리소스 표현
다음 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 | stringAPI 리소스의 유형을 식별합니다. 값은 youtube#comment입니다. | 
| etag | etag이 리소스의 ETag입니다. | 
| id | stringYouTube에서 댓글을 고유하게 식별하는 데 사용하는 ID입니다. | 
| snippet | objectsnippet객체에는 댓글에 관한 기본 세부정보가 포함됩니다. | 
| 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입니다.이 속성의 유효한 값은 다음과 같습니다. 
 | 
| snippet.likeCount | unsigned integer댓글이 받은 총 좋아요 수 (긍정적 평가)입니다. | 
| snippet.moderationStatus | string댓글의 검토 상태입니다. 이 속성은 요청된 댓글이 작성된 채널 또는 동영상의 소유자가 API 요청을 승인한 경우에만 반환됩니다. 또한 API 요청에서 id필터 매개변수를 사용한 경우 이 속성은 설정되지 않습니다.이 속성의 유효한 값은 다음과 같습니다. 
 | 
| snippet.publishedAt | datetime댓글이 원래 게시된 날짜와 시간입니다. 값은 ISO 8601 형식으로 지정됩니다. | 
| snippet.updatedAt | datetime의견이 마지막으로 업데이트된 날짜와 시간입니다. 값은 ISO 8601 형식으로 지정됩니다. |