CommentThreads: insert

Membuat komentar tingkat atas baru. Untuk menambahkan balasan ke komentar yang ada, gunakan metode comments.insert.

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

Kasus penggunaan umum

Permintaan

Permintaan HTTP

POST https://www.googleapis.com/youtube/v3/commentThreads

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
part string
Parameter part mengidentifikasi properti yang akan disertakan dalam respons API. Setel nilai parameter ke snippet. Bagian snippet memiliki biaya kuota 2 unit.

Daftar berikut berisi nama part yang dapat Anda sertakan dalam nilai parameter:
  • id
  • replies
  • snippet

Isi permintaan

Berikan resourcecommentThread dalam isi permintaan.

Untuk resource tersebut, Anda harus menentukan nilai untuk properti berikut:

  • snippet.channelId
  • snippet.videoId
  • snippet.topLevelComment.snippet.textOriginal

Respons

Jika berhasil, metode ini akan menampilkan resourcecommentThread dalam isi respons.

Error

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

Jenis error Detail error Deskripsi
badRequest (400) channelOrVideoIdMissing Setiap rangkaian komentar harus ditautkan ke video. Pastikan resource menentukan nilai untuk properti snippet.channelId dan snippet.videoId. Komentar video akan muncul di halaman tonton video.
badRequest (400) commentTextRequired Resource comment yang disisipkan harus menentukan nilai untuk properti snippet.topLevelComment.snippet.textOriginal. Komentar tidak boleh kosong.
badRequest (400) commentTextTooLong Resource comment yang disisipkan berisi terlalu banyak karakter dalam properti snippet.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata Metadata permintaan tidak valid.
badRequest (400) processingFailure Server API gagal memproses permintaan. Meskipun ini bisa menjadi error sementara, hal ini biasanya menunjukkan bahwa input permintaan tidak valid. Periksa struktur resource commentThread dalam isi permintaan untuk memastikan validitasnya.
forbidden (403) forbidden Rangkaian komentar tidak dapat dibuat karena izin tidak memadai. Permintaan mungkin tidak diotorisasi dengan benar.
forbidden (403) ineligibleAccount Akun YouTube yang digunakan untuk mengizinkan permintaan API harus digabungkan dengan Akun Google pengguna untuk menyisipkan rangkaian komentar atau komentar.
notFound (404) channelNotFound Saluran yang ditentukan tidak dapat ditemukan. Periksa nilai properti snippet.channelId untuk memastikannya sudah benar.
notFound (404) videoNotFound Video yang ditentukan tidak dapat ditemukan. Periksa nilai properti snippet.videoId untuk memastikannya sudah benar.

Cobalah!

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