Comments: 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 uỷ quyền.

Ảnh hưởng đến hạn mức: Lệnh gọi đến phương thức này có chi phí theo 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

Tham số

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

Tham 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 các mã nhận dạng 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 những bình luận đã chỉ định.

Các giá trị được chấp nhận là:
  • heldForReview – Đánh dấu nhận xét là đang chờ người kiểm duyệt xem xét.
  • published – Xoá một nhận xét để hiển thị công khai.
  • rejected – Từ chối một nhận xét vì không phù hợp để hiển thị. Thao tác này cũng giúp ẩn tất cả câu trả lời cho bình luận bị từ chối một cách hiệu quả.
Tham số không bắt buộc
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 nhận xét khác mà tác giả của nhận xét đó viết. Hãy đặt giá trị thông số thành true để cấm tác giả.

Lưu ý: Thông số này chỉ hợp lệ nếu bạn cũng đặt tham số moderationStatus thành rejected.

Nội dung yêu cầu

Khô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ột 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 Chi tiết lỗi Nội dung mô tả
badRequest (400) banWithoutReject Bạn chỉ có thể dùng tham số banAuthor nếu giá trị tham số moderationStatus là rejected.
badRequest (400) operationNotSupported Nhận xét không dựa trên Google+ chỉ cung cấp chức năng kiểm duyệt có giới hạn.
badRequest (400) processingFailure Máy chủ API không thể xử lý yêu cầu thành công. Mặc dù đây có thể là lỗi tạm thời, nhưng lỗi này thường cho biết rằng dữ liệu đầu vào của yêu cầu không hợp lệ.
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. Có thể yêu cầu này không được uỷ quyền 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ị tham số id của yêu cầu để đảm bảo rằng các giá trị đó là chính xác.

Hãy dùng thử!

Dùng APIs Explorer để gọi API này, cũng như xem yêu cầu và phản hồi của API.