CommentThreads

Tài nguyên commentThread chứa thông tin về một chuỗi bình luận trên YouTube, bao gồm một bình luận cấp cao nhất và các phản hồi (nếu có) cho bình luận đó. Tài nguyên commentThread biểu thị cho các bình luận về một video.

Cả bình luận cấp cao nhất và câu trả lời đề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 chứa tất cả câu trả lời cho một bình luận. Bạn cần sử dụng phương thức comments.list nếu muốn truy xuất tất cả phản hồi cho một bình luận cụ thể. Một số bình luận không có phản hồi.

Phương thức

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 các tham số yêu cầu API. Thử ngay.
chèn
Tạo nhận xét mới ở cấp cao nhất. Để thêm phản hồi cho một bình luận hiện có, hãy sử dụng phương thức comments.insert. Thử ngay.

Trình bày tài nguyên

Cấu trúc JSON hiển thị đị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
Thẻ 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 chuỗi bình luận.
snippet object
Đối tượng snippet chứa các thông tin chi tiết cơ bản về chuỗi bình luận. Tệp này cũng chứa nhận xét cấp cao nhất của luồng, 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 bình luận. Thuộc tính snippet.videoId giúp xác định video.
snippet.videoId string
Mã của video mà bình luận đề cập đến.
snippet.topLevelComment object
Bình luận cấp cao nhất của chuỗi bài đăng. Giá trị của thuộc tính là một 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ố lượt phản hồ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 chuỗi bài đăng (bao gồm tất cả các bình luận và phản hồi bình luận) có hiển thị với tất cả người dùng YouTube hay không.
replies object
Đối tượng replies là một vùng chứa chứa danh sách phản hồi cho bình luận (nếu có). Thuộc tính replies.comments đại diện cho 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 là một tài nguyên comment.

Danh sách này chứa số lượng phản hồi có hạn và trừ phi số lượng mục trong danh sách bằng giá trị của thuộc tính snippet.totalReplyCount, danh sách phản hồi chỉ là một tập hợp con trong tổng số phản hồi hiện có cho bình luận cấp cao nhất. Để truy xuất tất cả phản hồi cho bình luận cấp cao nhất, bạn cần gọi phương thức comments.list và dùng tham số yêu cầu parentId để xác định bình luận mà bạn muốn truy xuất phản hồi.