Comments

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ề video hoặc kênh. Ngoài ra, bình luận có thể là bình luận cấp cao nhất hoặc bình luận trả lời bình luận cấp cao nhất.

Phương thức

API này hỗ trợ các phương thức sau đây cho tài nguyên comments:

list
Trả về danh sách các nhận xét khớp với các tham số yêu cầu API. Thử ngay.
chèn
Tạo một bình luận trả lời một bình luận 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.
update
Sửa đổi một bình luận. Thử ngay.
xóa
Xoá một bình luận. Thử ngay.
setModerationStatus
Đặt trạng thái kiểm duyệt của một hoặc nhiều bình luận. Yêu cầu API phải được chủ sở hữu của kênh hoặc video liên kết với các bình luận đó cho phép. Thử ngay.
markAsSpam
Lưu ý: Phương thức này không còn được dùng nữa và không còn được hỗ trợ.
Thể hiện ý kiến của phương thức gọi rằng một hoặc nhiều bình luận cần được gắn cờ là nội dung rác.

Biểu thị 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ã mà YouTube sử dụng để nhận dạng riêng biệt bình luận.
snippet object
Đối tượng snippet chứa thông tin cơ bản về bình luận.
snippet.authorDisplayName string
Tên hiển thị của người dùng đã đăng bình luận.
snippet.authorProfileImageUrl string
URL của hình đại diện của người dùng đã đăng bình luận.
snippet.authorChannelUrl string
URL của kênh YouTube của tác giả bình luận, nếu có.
snippet.authorChannelId object
Đối tượng này chứa thông tin về kênh YouTube của tác giả bình luận (nếu có).
snippet.authorChannelId.value string
Mã nhận dạng của kênh YouTube của tác giả bình luận, nếu có.
snippet.channelId string
Mã của kênh YouTube liên kết với bình luận.
snippet.textDisplay string
Văn bản của bình luận. Bạn có thể truy xuất văn bản ở định dạng văn bản thuần tuý hoặc HTML. (Cả phương thức comments.listcommentThreads.list đều hỗ trợ tham số textFormat, tham số này chỉ định định dạng văn bản đã chọn.)

Thậm chí, văn bản thuần tuý có thể khác với văn bản bình luận ban đầu. 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, thô của bình luận khi được đăng lần đầu hoặc cập nhật lần gần đây nhất. Văn bản gốc chỉ được trả về cho người dùng đã xác thực nếu họ là tác giả của bình luận.
snippet.parentId string
Mã nhận dạng duy nhất của nhận xét gốc. Thuộc tính này chỉ được đặt nếu bình luận được gửi dưới dạng câu trả lời cho một bình luận khác.
snippet.canRate boolean
Chế độ cài đặt này cho biết liệu người xem hiện tại có thể đánh giá bình luận hay không.
snippet.viewerRating string
Điểm xếp hạng mà người xem đã đưa ra cho bình luận này. Thuộc tính này không xác định điểm xếp hạng dislike, mặc dù hành vi này có thể thay đổi. Trong thời gian chờ đợi, giá trị thuộc tính là like nếu người xem đã đánh giá tích cực cho bình luận đó. Giá trị này là none trong mọi trường hợp khác, bao gồm cả trường hợp người dùng đã đánh giá bình luận theo hướng tiêu cực hoặc chưa đánh giá bình luận.

Các giá trị hợp lệ cho thuộc tính này là:
  • like
  • none
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. Thuộc tính này chỉ được trả về nếu yêu cầu API được chủ sở hữu kênh hoặc video mà bình luận được yêu cầu đăng trên đó cho phép. Ngoài ra, thuộc tính này sẽ không được đặt nếu yêu cầu API sử dụng tham số bộ lọc id.

Các giá trị hợp lệ cho thuộc tính này là:
  • heldForReview
  • likelySpam
  • published
  • rejected
snippet.publishedAt datetime
Ngày và giờ đăng bình luận ban đầu. Giá trị được chỉ định ở định dạng ISO 8601.
snippet.updatedAt datetime
Ngày và giờ gần nhất bình luận được cập nhật. Giá trị được chỉ định ở định dạng ISO 8601.