CommentThreads

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.)
  • Nếu bình luận có liên quan đến một video, thì giá trị đó sẽ xác định kênh đã tải video đó lên. (Thuộc tính snippet.videoId xác định video.)
  • Nếu nhận xét đề cập đến chính kênh đó, thì thuộc tính snippet.videoId sẽ không có giá trị.
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.