Comments: setModerationStatus

Đặt trạng thái kiểm duyệt của một hoặc nhiều bình luận. Chủ sở hữu kênh hoặc video có liên quan đến bình luận phải uỷ quyền cho yêu cầu API.

Tác động đến hạn mức: Mỗi lệnh gọi đến phương thức này có mức sử dụng hạn mức là 50 đơn vị.

Các trường hợp sử dụng phổ biến

Yêu cầu

Yêu cầu HTTP

POST https://www.googleapis.com/youtube/v3/comments/setModerationStatus

Ủy quyền

Yêu cầu này cần được uỷ quyền với ít nhất một trong các phạm vi sau (đọc thêm về quy trình xác thực và uỷ quyền).

Phạm vi
https://www.googleapis.com/auth/youtube.force-ssl

Thông số

Bảng sau đây liệt kê các tham số mà truy vấn này hỗ trợ. Tất cả các tham số được liệt kê đều là tham số truy vấn.

Thông số
Tham số bắt buộc
id string
Tham số id chỉ định một danh sách được phân tách bằng dấu phẩy gồm tối đa 50 mã nhận dạng để xác định những bình luận mà bạn đang cập nhật trạng thái kiểm duyệt.
moderationStatus string
Xác định trạng thái kiểm duyệt mới của các bình luận được chỉ định.

Các giá trị được chấp nhận là:
  • heldForReview – Đánh dấu một bình luận là đang chờ người kiểm duyệt xem xét.
  • published – Cho phép một bình luận xuất hiện công khai. Bạn không thể thay đổi trạng thái kiểm duyệt của một bình luận bị từ chối thành published.
  • rejected – Từ chối một bình luận vì không phù hợp để hiển thị. Thao tác này cũng ẩn tất cả câu trả lời cho bình luận bị từ chối. Để xoá bình luận của người dùng khác khỏi kênh hoặc video của bạn, hãy đặt trạng thái kiểm duyệt của bình luận đó thành rejected. Chỉ tác giả ban đầu của bình luận mới có thể sử dụng phương thức comments.delete.
Thông số tuỳ chọn
banAuthor boolean
Tham số banAuthor cho phép bạn cho biết rằng bạn muốn tự động từ chối mọi bình luận khác do tác giả của bình luận đó viết. Đặt giá trị tham số thành true để cấm tác giả.

Tham số này chỉ hợp lệ nếu tham số moderationStatus cũng được đặt thành rejected.

Nội dung yêu cầu

Đừng cung cấp nội dung yêu cầu khi gọi phương thức này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về mã phản hồi HTTP 204 (No Content).

Lỗi

Bảng sau đây xác định các thông báo lỗi mà API có thể trả về để phản hồi lệnh gọi đến phương thức này. Vui lòng xem tài liệu về thông báo lỗi để biết thêm chi tiết.

Loại lỗi Thông tin chi tiết về lỗi Mô tả
badRequest (400) banWithoutReject Bạn chỉ có thể sử dụng tham số banAuthor nếu giá trị tham số moderationStatus là rejected.
badRequest (400) operationNotSupported Những bình luận không dựa trên Google+ chỉ có chức năng kiểm duyệt hạn chế.
badRequest (400) processingFailure Máy chủ API không xử lý thành công yêu cầu. Mặc dù đây có thể là lỗi tạm thời, nhưng thường cho biết thông tin đầu vào của yêu cầu không hợp lệ. Lỗi này cũng được trả về khi cố gắng kiểm duyệt một bình luận đã bị người bình luận ban đầu xoá.
forbidden (403) forbidden Không thể đặt trạng thái kiểm duyệt của một hoặc nhiều bình luận do không có đủ quyền. Yêu cầu có thể chưa được uỷ quyền. Lỗi này cũng được trả về khi bạn cố gắng kiểm duyệt một mã bình luận đã bị xoá hoặc không hợp lệ.
notFound (404) commentNotFound Không tìm thấy một hoặc nhiều bình luận mà yêu cầu đang cố gắng cập nhật. Kiểm tra các giá trị của tham số id trong yêu cầu để đảm bảo rằng các giá trị đó chính xác.

Hãy dùng thử!

Sử dụng APIs Explorer để gọi API này và xem Yêu cầu API cũng như phản hồi của API.