Comments: setModerationStatus

Menetapkan status moderasi satu atau beberapa komentar. Permintaan API harus diotorisasi oleh pemilik channel atau video yang terkait dengan komentar tersebut.

Dampak kuota: Panggilan ke metode ini memiliki biaya kuota sebesar 50 unit.

Kasus penggunaan umum

Permintaan

Permintaan HTTP

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

Otorisasi

Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut (baca selengkapnya tentang autentikasi dan otorisasi).

Cakupan
https://www.googleapis.com/auth/youtube.force-ssl

Parameter

Tabel berikut mencantumkan parameter yang didukung oleh kueri ini. Semua parameter yang tercantum adalah parameter kueri.

Parameter
Parameter yang diperlukan
id string
Parameter id menentukan daftar ID yang dipisahkan koma hingga 50 ID yang mengidentifikasi komentar yang status moderasinya akan Anda perbarui.
moderationStatus string
Mengidentifikasi status moderasi baru komentar yang ditentukan.

Acceptable values are:
  • heldForReview – Menandai komentar sebagai menunggu peninjauan oleh moderator.
  • published – Menghapus komentar untuk ditampilkan secara publik. Anda tidak dapat mengubah status moderasi komentar yang ditolak menjadi published.
  • rejected – Menolak komentar karena tidak layak ditampilkan. Tindakan ini juga secara efektif menyembunyikan semua balasan untuk komentar yang ditolak. Untuk menghapus komentar yang dibuat oleh pengguna lain dari channel atau video Anda, tetapkan status moderasinya ke rejected. Metode comments.delete hanya dapat digunakan oleh penulis asli komentar.
Parameter opsional
banAuthor boolean
Parameter banAuthor memungkinkan Anda menunjukkan bahwa Anda ingin otomatis menolak komentar tambahan yang ditulis oleh penulis komentar. Tetapkan nilai parameter ke true untuk memblokir penulis.

Parameter ini hanya valid jika parameter moderationStatus juga ditetapkan ke rejected.

Isi permintaan

Jangan berikan isi permintaan saat memanggil metode ini.

Respons

Jika berhasil, metode ini akan menampilkan kode respons HTTP 204 (No Content).

Error

Tabel berikut mengidentifikasi pesan error yang dapat ditampilkan API sebagai respons terhadap panggilan ke metode ini. Lihat dokumentasi pesan error untuk mengetahui detail selengkapnya.

Jenis error Detail error Deskripsi
badRequest (400) banWithoutReject Parameter banAuthor hanya dapat digunakan jika nilai parameter moderationStatus adalah rejected.
badRequest (400) operationNotSupported Komentar yang tidak didasarkan pada penawaran Google+ hanya menawarkan fungsi moderasi terbatas.
badRequest (400) processingFailure Server API gagal memproses permintaan dengan benar. Meskipun error ini dapat bersifat sementara, biasanya error ini menunjukkan bahwa input permintaan tidak valid. Error ini juga ditampilkan saat mencoba memoderasi komentar yang telah dihapus oleh pemberi komentar asli.
forbidden (403) forbidden Status moderasi satu atau beberapa komentar tidak dapat ditetapkan karena izin yang tidak memadai. Permintaan mungkin tidak diotorisasi. Error ini juga ditampilkan saat mencoba memoderasi ID komentar yang dihapus atau tidak valid.
notFound (404) commentNotFound Satu atau beberapa komentar yang coba diperbarui oleh permintaan tidak dapat ditemukan. Periksa nilai parameter id permintaan untuk memastikan nilai tersebut benar.

Cobalah!

Gunakan APIs Explorer untuk memanggil API ini dan melihat permintaan API serta respons API.