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 댓글을 게시한 사용자의 표시 이름입니다. |
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 형식으로 지정됩니다. |