Tài nguyên comment chứa thông tin về một bình luận trên YouTube. Tài nguyên comment có thể đại diện cho một bình luận về video hoặc kênh. Ngoài ra, bình luận đó có thể là bình luận cấp cao nhất hoặc là câu trả lời cho một bình luận cấp cao nhất.
Phương thức
API này hỗ trợ các phương thức sau cho tài nguyên comments:
- list
- Trả về danh sách các bình luận trùng khớp với các tham số yêu cầu API. Thử ngay.
- chèn
- Tạo câu trả lời cho một bình luận hiện có. Lưu ý: Để tạo một bình luận cấp cao nhất, hãy sử dụng phương thức
commentThreads.insert. Thử ngay. - update
- Sửa đổi một bình luận. Thử ngay.
- xóa
- Xoá một bình luận. Thử ngay.
- setModerationStatus
- Đặt trạng thái kiểm duyệt cho một hoặc nhiều bình luận. Chủ sở hữu kênh hoặc video có liên quan đến bình luận phải uỷ quyền cho yêu cầu API. Thử ngay.
Cách trình bày tài nguyên
Cấu trúc JSON sau đây cho thấy định dạng của tài nguyên 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,
"imageUrl": string
}
}Thuộc tính
Bảng sau đây xác định các thuộc tính xuất hiện trong tài nguyên này:
| Thuộc tính | |
|---|---|
kind |
stringXác định loại tài nguyên API. Giá trị sẽ là youtube#comment. |
etag |
etagEtag của tài nguyên này. |
id |
stringMã nhận dạng mà YouTube dùng để xác định riêng biệt bình luận. |
snippet |
objectĐối tượng snippet chứa thông tin cơ bản về bình luận. |
snippet.authorDisplayName |
stringTên hiển thị của người dùng đã đăng bình luận. |
snippet.authorProfileImageUrl |
stringURL cho hình đại diện của người dùng đã đăng bình luận. |
snippet.authorChannelUrl |
stringURL của kênh YouTube của người đăng bình luận (nếu có). |
snippet.authorChannelId |
objectĐối tượng này đóng gói thông tin về kênh YouTube của tác giả bình luận (nếu có). |
snippet.authorChannelId.value |
stringMã nhận dạng kênh YouTube của người đăng bình luận (nếu có). |
snippet.channelId |
stringMã nhận dạng của kênh YouTube liên kết với bình luận. |
snippet.textDisplay |
stringVăn bản của bình luận. Bạn có thể truy xuất văn bản ở dạng văn bản thuần tuý hoặc HTML. (Cả phương thức comments.list và commentThreads.list đều hỗ trợ tham số textFormat, tham số này chỉ định định dạng văn bản đã chọn.)Ngay cả văn bản thuần tuý cũng có thể khác với văn bản bình luận ban đầu. Ví dụ: tính năng này có thể thay thế đường liên kết đến video bằng tiêu đề video. |
snippet.textOriginal |
stringVăn bản thô ban đầu của bình luận như khi được đăng lần đầu hoặc cập nhật lần gần đây nhất. Văn bản gốc chỉ được trả về cho người dùng đã xác thực nếu họ là tác giả của bình luận. |
snippet.parentId |
stringMã nhận dạng duy nhất của bình luận gốc. Thuộc tính này chỉ được đặt nếu bình luận được gửi dưới dạng câu trả lời cho một bình luận khác. |
snippet.canRate |
booleanChế độ cài đặt này cho biết liệu người xem hiện tại có thể đánh giá nhận xét hay không. |
snippet.viewerRating |
stringĐiểm xếp hạng mà người xem đã dành cho bình luận này. Thuộc tính này không xác định mức phân loại dislike, mặc dù hành vi này có thể thay đổi. Trong thời gian chờ đợi, giá trị của thuộc tính này là like nếu người xem đã đánh giá tích cực về bình luận. Giá trị là none trong tất cả các trường hợp khác, kể cả khi người dùng đã xếp hạng tiêu cực cho bình luận hoặc chưa xếp hạng cho bình luận.Các giá trị hợp lệ cho thuộc tính này là:
|
snippet.likeCount |
unsigned integerTổng số lượt thích (lượt đánh giá tích cực) mà bình luận nhận được. |
snippet.moderationStatus |
stringTrạng thái kiểm duyệt của bình luận. Thuộc tính này chỉ được trả về nếu chủ sở hữu kênh hoặc video mà người dùng đã đăng bình luận được yêu cầu cho phép yêu cầu API. Ngoài ra, thuộc tính này sẽ không được đặt nếu yêu cầu API sử dụng tham số bộ lọc id.Các giá trị hợp lệ cho thuộc tính này là:
|
snippet.publishedAt |
datetimeNgày và giờ bình luận được xuất bản lần đầu. Giá trị được chỉ định ở định dạng ISO 8601. |
snippet.updatedAt |
datetimeNgày và giờ bình luận được cập nhật lần gần đây nhất. Giá trị được chỉ định ở định dạng ISO 8601. |
snippet.imageUrl |
stringURL của hình ảnh hoặc ảnh GIF động được đính kèm vào bình luận (nếu có). Thuộc tính này chỉ xuất hiện khi một bình luận có chứa hình ảnh hoặc ảnh GIF. URL này được phân phát dưới dạng một đường liên kết đã ký với thời gian tồn tại (TTL) là 6 giờ và sẽ hết hạn sau 6 giờ kể từ khi được truy xuất. |