이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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.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 형식으로 지정됩니다.