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 bình luận trả lời 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 đây cho tài nguyên comments
:
- list
- Trả về danh sách các nhận xét khớp với các tham số yêu cầu API. Thử ngay.
- chèn
- Tạo một bình luận trả lời một bình luận hiện có. Lưu ý: Để tạo một nhận xét 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 của một hoặc nhiều bình luận. Yêu cầu API phải được chủ sở hữu của kênh hoặc video liên kết với các bình luận đó cho phép. Thử ngay.
- markAsSpam
- Lưu ý: Phương thức này không còn được dùng nữa và không còn được hỗ trợ.
- Thể hiện ý kiến của phương thức gọi rằng một hoặc nhiều bình luận cần được gắn cờ là nội dung rác.
Biểu thị 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 } }
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 |
string Xác định loại tài nguyên API. Giá trị sẽ là youtube#comment . |
etag |
etag Etag của tài nguyên này. |
id |
string Mã mà YouTube sử dụng để nhận dạng 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 |
string Tên hiển thị của người dùng đã đăng bình luận. |
snippet.authorProfileImageUrl |
string URL của hình đại diện của người dùng đã đăng bình luận. |
snippet.authorChannelUrl |
string URL của kênh YouTube của tác giả bình luận, nếu có. |
snippet.authorChannelId |
object Đối tượng này chứa thông tin về kênh YouTube của tác giả bình luận (nếu có). |
snippet.authorChannelId.value |
string Mã nhận dạng của kênh YouTube của tác giả bình luận, nếu có. |
snippet.channelId |
string Mã của kênh YouTube liên kết với bình luận. |
snippet.textDisplay |
string Văn bản của bình luận. Bạn có thể truy xuất văn bản ở định 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.)Thậm chí, văn bản thuần tuý 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 |
string Văn bản gốc, thô của bình luận 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 |
string Mã nhận dạng duy nhất của nhận xét 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 |
boolean Chế độ cài đặt này cho biết liệu người xem hiện tại có thể đánh giá bình luận hay không. |
snippet.viewerRating |
string Điểm xếp hạng mà người xem đã đưa ra cho bình luận này. Thuộc tính này không xác định điểm xếp hạng dislike , mặc dù hành vi này có thể thay đổi. Trong thời gian chờ đợi, giá trị thuộc tính là like nếu người xem đã đánh giá tích cực cho bình luận đó. Giá trị này là none trong mọi trường hợp khác, bao gồm cả trường hợp người dùng đã đánh giá bình luận theo hướng tiêu cực hoặc chưa đánh giá bình luận.Các giá trị hợp lệ cho thuộc tính này là:
|
snippet.likeCount |
unsigned integer Tổng số lượt thích (điểm xếp hạng tích cực) mà bình luận nhận được. |
snippet.moderationStatus |
string Trạ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 yêu cầu API được chủ sở hữu kênh hoặc video mà bình luận được yêu cầu đăng trên đó cho phép. 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 |
datetime Ngày và giờ đăng bình luận ban đầu. Giá trị được chỉ định ở định dạng ISO 8601. |
snippet.updatedAt |
datetime Ngày và giờ gần nhất bình luận được cập nhật. Giá trị được chỉ định ở định dạng ISO 8601. |