Membuat komentar tingkat teratas baru. Untuk menambahkan balasan ke komentar yang sudah ada, gunakan metode comments.insert
sebagai gantinya.
Dampak kuota: Panggilan ke metode ini memiliki biaya kuota 50 unit.
Kasus penggunaan umum
Permintaan
Permintaan HTTP
POST https://www.googleapis.com/youtube/v3/commentThreads
Otorisasi
Permintaan ini memerlukan otorisasi dengan setidaknya 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. Tetapkan nilai parameter ke snippet . Bagian snippet memiliki biaya kuota 2 unit.Daftar berikut berisi nama part yang dapat Anda sertakan dalam nilai parameter:
|
Isi permintaan
Berikan resource komentarThread dalam isi permintaan. Untuk resource tersebut:
-
Anda harus menentukan nilai untuk properti ini:
snippet.channelId
snippet.topLevelComment.snippet.textOriginal
-
Anda dapat menetapkan nilai untuk properti ini:
snippet.channelId
snippet.videoId
snippet.topLevelComment.snippet.textOriginal
Tanggapan
Jika berhasil, metode ini akan menampilkan resource komentarThread dalam isi respons.
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) |
channelOrVideoIdMissing |
Setiap rangkaian komentar harus ditautkan ke channel atau video.
|
badRequest (400) |
commentTextRequired |
Resource comment yang sedang dimasukkan 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 adalah error sementara, biasanya ini menunjukkan bahwa input permintaan tidak valid. Periksa struktur resource commentThread dalam isi permintaan untuk memastikannya valid. |
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 memberikan otorisasi permintaan API harus digabungkan dengan Akun Google pengguna untuk menyisipkan komentar atau rangkaian komentar. |
notFound (404) |
channelNotFound |
Saluran yang ditentukan tidak dapat ditemukan. Periksa nilai properti snippet.channelId untuk memastikan nilainya benar. |
notFound (404) |
videoNotFound |
Video yang ditentukan tidak dapat ditemukan. Periksa nilai properti snippet.videoId untuk memastikan nilainya benar. |
Cobalah!
Gunakan APIs Explorer untuk memanggil API ini dan melihat permintaan dan respons API.