Comments: setModerationStatus

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

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 kueri ini. Semua parameter yang tercantum adalah parameter kueri.

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

Nilai yang dapat diterima adalah:
  • heldForReview – Menandai komentar sebagai menunggu peninjauan oleh moderator.
  • published – Menghapus komentar untuk ditampilkan secara publik.
  • rejected – Menolak komentar karena tidak cocok untuk ditampilkan. Tindakan ini juga secara efektif menyembunyikan semua balasan untuk komentar yang ditolak.
Parameter opsional
banAuthor boolean
Parameter banAuthor memungkinkan Anda menunjukkan bahwa Anda ingin otomatis menolak komentar tambahan apa pun yang ditulis oleh penulis komentar. Setel nilai parameter ke true untuk memblokir penulis.

Catatan: 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 204 HTTP (No Content).

Error

Tabel berikut mengidentifikasi pesan error yang dapat ditampilkan API sebagai respons terhadap panggilan ke metode ini. Lihat dokumentasi pesan error untuk 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 Google+ hanya menawarkan fungsi moderasi terbatas.
badRequest (400) processingFailure Server API gagal memproses permintaan. Meskipun mungkin merupakan error sementara, hal ini biasanya menunjukkan bahwa input permintaan tidak valid.
forbidden (403) forbidden Status moderasi satu atau beberapa komentar tidak dapat ditetapkan karena izin tidak memadai. Permintaan mungkin tidak diotorisasi dengan benar.
notFound (404) commentNotFound Satu atau beberapa komentar yang coba diperbarui oleh permintaan tidak dapat ditemukan. Periksa nilai parameter id permintaan untuk memastikan nilainya benar.

Cobalah!

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