CommentThreads

Tài nguyên commentThread chứa thông tin về 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 cho bình luận đó (nếu có). Tài nguyên commentThread biểu thị bình luận về một video.

Cả bình luận ở cấp cao nhất và phản hồi đều thực sự là tài nguyên comment được lồng trong tài nguyên commentThread. Tài nguyên commentThread không nhất thiết chứa tất cả phản hồi cho một bình luận. 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ả phản hồi của 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 này 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 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 câu trả lời cho một 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 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 để xác định riêng biệt chuỗi bình luận.
snippet object
Đối tượng snippet chứa thông tin cơ bản về luồng nhận xét. Tệp này cũng chứa nhận xét cấp cao nhất của luồng, là một tài nguyên comment.
snippet.channelId string
Kênh YouTube được liên kết với các bình luận trong chuỗi tin nhắ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.
snippet.topLevelComment object
Nhận xét ở cấp cao nhất của chuỗi bài đăng. 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 bài đăng hay không.
snippet.totalReplyCount unsigned integer
Tổng số 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 liệu chuỗi video, bao gồm tất cả bình luận và phản hồi bình luận của chuỗi 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 đối với 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ỉ chứa một số lượng câu trả lời giới hạn và trừ phi số mục trong danh sách bằng giá trị của thuộc tính snippet.totalReplyCount, thì danh sách các câu trả lời chỉ là một tập con trong tổng số câu trả lời hiện có cho nhận xét 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.