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