Trang này được dịch bởi Cloud Translation API.

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 phản hồi cho một 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 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 câu trả lời cho một nhận xét 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 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 kênh hoặc video liên kết với bình luận cấp 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 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.

Biểu diễn 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ã nhận dạng mà YouTube sử dụng để xác định riêng biệt bình luận đó.
`snippet`	`object` Đối tượng `snippet` chứa các 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 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 đó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 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` Nội dung của bình luận. Văn bản có thể được truy xuất ở dạng văn bản thuần tuý hoặc HTML. (Cả phương thức `comments.list` và `commentThreads.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ể xếp hạng bình luận đó hay không.
`snippet.viewerRating`	`string` Điểm xếp hạng mà người xem đã đánh giá cho bình luận này. Thuộc tính này không xác định `dislike` điểm xếp hạng, 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á 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. Tài sản này chỉ được trả về nếu yêu cầu API được chủ sở hữu của kênh hoặc video đưa ra bình luận được yêu cầu sử dụng. 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ờ mà bình luận được xuất bản về cơ bản. Giá trị được chỉ định ở định dạng ISO 8601.
`snippet.updatedAt`	`datetime` Ngày và giờ cập nhật nhận xét gần đây nhất. Giá trị được chỉ định ở định dạng ISO 8601.