Tài nguyên commentThread
chứa thông tin về chuỗi nhận xét trên YouTube, trong đó có một nhận xét cấp cao nhất và các phản hồi (nếu có) cho nhận xét đó. Tài nguyên commentThread
có thể biểu thị nhận xét về một video hoặc một kênh.
Cả nhận xét cấp cao nhất và phản hồi thực ra đều là tài nguyên comment
lồng trong tài nguyên commentThread
. Tài nguyên commentThread
không nhất thiết phải chứa tất cả các câu trả lời cho một nhận xét và bạn cần phải sử dụng phương thức comments.list
nếu muốn truy xuất tất cả các câu trả lời cho một nhận xét cụ thể. Ngoài ra, xin lưu ý rằng một số bình luận không có phản hồi.
Phương pháp
API hỗ trợ các phương thức sau cho tài nguyên commentThreads
:
- list
- Trả về danh sách các chuỗi nhận xét khớp với thông số của yêu cầu API. Thử ngay.
- chèn
- Tạo nhận xét cấp cao nhất mới. Để thêm câu trả lời vào nhận xét hiện có, hãy sử dụng phương thức
comments.insert
. Thử ngay.
Biểu diễn tài nguyên
Cấu trúc JSON bên dưới cho thấy định dạng của tài nguyên commentThreads
:
{ "kind": "youtube#commentThread", "etag": etag, "id": string, "snippet": { "channelId": string, "videoId": string, "topLevelComment": comments Resource, "canReply": boolean, "totalReplyCount": unsigned integer, "isPublic": boolean }, "replies": { "comments": [ comments Resource ] } }
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#commentThread . |
etag |
etag Etag của tài nguyên này. |
id |
string Mã nhận dạng mà YouTube sử dụng để nhận dạng duy nhất chuỗi bình luận. |
snippet |
object Đối tượng snippet chứa thông tin cơ bản về chuỗi nhận xét. Nó cũng chứa nhận xét cấp cao nhất của chuỗi, đây là tài nguyên comment . |
snippet.channelId |
string Kênh YouTube liên kết với các bình luận trong chuỗi cuộc trò chuyện. (Thuộc tính snippet.videoId xác định video.)
|
snippet.videoId |
string Mã của video mà bình luận đề cập, nếu có. Nếu thuộc tính này không có hoặc không có giá trị, thì luồng áp dụng cho kênh này chứ không phải cho một video cụ thể. |
snippet.topLevelComment |
object Nhận xét cấp cao nhất của chuỗi. Giá trị của thuộc tính này là tài nguyên comment . |
snippet.canReply |
boolean Chế độ cài đặt này cho biết liệu người xem hiện tại có thể trả lời chuỗi tin nhắn hay không. |
snippet.totalReplyCount |
unsigned integer Tổng số tin nhắn trả lời đã được gửi để phản hồi bình luận cấp cao nhất. |
snippet.isPublic |
boolean Chế độ cài đặt này cho biết toàn bộ người dùng trên YouTube có thể thấy chuỗi cuộc trò chuyện, bao gồm cả mọi bình luận và phản hồi của bình luận hay không. |
replies |
object Đối tượng replies là một vùng chứa danh sách phản hồi cho bình luận (nếu có). Thuộc tính replies.comments thể hiện chính danh sách các nhận xét. |
replies.comments[] |
list Danh sách một hoặc nhiều phản hồi cho bình luận cấp cao nhất. Mỗi mục trong danh sách này là một tài nguyên comment .Danh sách này chứa số lượng câu trả lời có giới hạn, và trừ khi số lượng mục trong danh sách bằng giá trị của thuộc tính snippet.totalReplyCount , thì danh sách trả lời chỉ là một tập hợp con trong tổng số câu trả lời có sẵn cho nhận xét cấp cao nhất. Để truy xuất tất cả câu trả lời cho nhận xét cấp cao nhất, bạn cần gọi phương thức comments.list và sử dụng tham số yêu cầu parentId để xác định nhận xét mà bạn muốn truy xuất câu trả lời. |