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

Phương thức

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

list
Trả về danh sách nhận xét khớp với tham số yêu cầu API. Thử ngay.
chèn
Tạo phản hồi cho một bình luận hiện có. Lưu ý: Để tạo nhận xét ở cấp cao nhất, hãy sử dụng phương thức commentThreads.insert. Thử ngay.
cập nhật
Sửa đổi nhận xét. Thử ngay.
xóa
Xóa một nhận xét. Thử ngay.
setModerationStatus
Đặt trạng thái kiểm duyệt cho một hoặc nhiều bình luận. Yêu cầu API phải được chủ sở hữu kênh hoặc video liên kết với bình luận cho phép. Thử ngay.
markAsSpam
Lưu ý: Phương thức này đã ngừng hoạt động và không còn được hỗ trợ.
Thể hiện quan điểm của người gọi rằng một hoặc nhiều bình luận nên bị gắn cờ là bình luận rác.

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

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

Ngay cả văn bản thuần tuý cũng có thể khác với văn bản bình luận gốc. Ví dụ: Tùy chọn 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, chưa qua xử lý của bình luận, được đăng lần đầu hoặc đượ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 nhận xét.
snippet.parentId string
Mã nhận dạng duy nhất của bình luận mẹ. 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 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 đặt cho bình luận này. Tài sản 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 sẽ là like nếu người xem đánh giá bình luận tích cực. Trong mọi trường hợp khác, giá trị sẽ là none, bao gồm cả việc người dùng đã xếp hạng bình luận tiêu cực hoặc chưa xếp hạng bình luận đó.

Các giá trị hợp lệ cho tài sản 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 đưa ra nhận xét được yêu cầu. Ngoài ra, thuộc tính này sẽ không được đặt nếu yêu cầu API dùng tham số bộ lọc id.

Các giá trị hợp lệ cho tài sản này là:
  • heldForReview
  • likelySpam
  • published
  • rejected
snippet.publishedAt datetime
Ngày và giờ xuất bản bình luận chính thức. Giá trị được chỉ định theo định dạng ISO 8601.
snippet.updatedAt datetime
Ngày và giờ cập nhật bình luận gần đây nhất. Giá trị được chỉ định theo định dạng ISO 8601.