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ề một video hoặc một kênh. Ngoài ra, nhận xét có thể là nhận xét cấp cao nhất hoặc câu trả lời cho nhận xét cấp cao nhất.
Phương thức
API hỗ trợ các phương thức sau cho tài nguyên comments
:
- list
- Trả về danh sách các nhận xét khớp với tham số yêu cầu API. Thử ngay.
- chèn
- Tạo câu trả lời cho một nhận xét 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. - cập nhật
- Sửa đổi một nhận xét. Thử ngay.
- xóa
- Xóa một nhận xét. Thử ngay.
- setModerationStatus
- Đặt trạng thái kiểm duyệt của một hoặc nhiều nhận xét. Yêu cầu API phải được chủ sở hữu kênh hoặc video liên kết với bình luận uỷ quyền. Thử ngay.
- markAsSpam
- Lưu ý: Phương thức này đã ngừng hoạt động và không còn được hỗ trợ.
- Thể hiện quan điểm của người gọi rằng một hoặc nhiều bình luận cần bị gắn cờ là bình luận rác.
Biểu diễn 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ã 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ề nhận xét đó. |
snippet.authorDisplayName |
string Tên hiển thị của người dùng đã đăng bình luận. |
snippet.authorProfileImageUrl |
string URL cho hình đại diện của người dùng đã đăng bình luận. |
snippet.authorChannelUrl |
string URL kênh YouTube của người viết bình luận, nếu có. |
snippet.authorChannelId |
object Đối tượng này bao gồm thông tin về kênh YouTube của người viết bình luận (nếu có). |
snippet.authorChannelId.value |
string Mã kênh YouTube của người viết bình luận, nếu có. |
snippet.channelId |
string Mã kênh YouTube liên kết với bình luận đó.
|
snippet.textDisplay |
string Nội dung 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ả hai phương thức comments.list và commentThreads.list đều hỗ trợ tham số textFormat chỉ định định dạng văn bản mong muốn.)Xin lưu ý rằng ngay cả văn bản thuần tuý cũng có thể khác với văn bản nhận xét gốc. 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, chưa qua xử lý của bình luận, như được đăng lần đầu hoặc lần cập nhật gần đây nhất. Văn bản gốc chỉ được trả về nếu người dùng đã xác thực có thể truy cập được văn bản gốc. Điều này chỉ được đảm bảo nếu người dùng là tác giả của nhận xét. |
snippet.parentId |
string Mã nhận dạng duy nhất của bình luận gốc. Tài sản này chỉ được đặt nếu nhận xét được gửi dưới dạng câu trả lời cho một nhận xét khác. |
snippet.canRate |
boolean Chế độ cài đặt này cho biết người xem hiện tại có thể xếp hạng bình luận đó 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. Xin lưu ý rằng tài sản này hiện không xác định mức phân loại dislike , mặc dù hành vi này có thể thay đổi. Hiện tại, giá trị tài sản là like nếu người xem đánh giá bình luận tích cực. Trong mọi trường hợp khác, giá trị sẽ là none , bao gồm cả việc người dùng đã xếp hạng bình luận tiêu cực hoặc chưa xếp hạng bình luận đó.Các giá trị hợp lệ của 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. Tài sản này chỉ được trả lại nếu yêu cầu API được chủ sở hữu kênh hoặc video đã đưa ra các nhận xét được yêu cầu. Ngoài ra, xin lưu ý rằng thuộc tính này sẽ không được thiết lập nếu yêu cầu API sử dụng thông 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ờ mà bình luận được xuất bản chính thức. Giá trị được chỉ định theo định dạng ISO 8601. |
snippet.updatedAt |
datetime Ngày và giờ cập nhật bình luận gần đây nhất. Giá trị được chỉ định theo định dạng ISO 8601. |