Comments: insert

Membuat balasan ke komentar yang ada. Catatan: Untuk membuat komentar tingkat atas, gunakan metode commentThreads.insert.

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

Otorisasi

Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut (baca lebih lanjut 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 sebesar 2 unit.

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

Isi permintaan

Berikan resource komentar dalam isi permintaan. Untuk resource tersebut:

  • Anda harus menentukan nilai untuk properti ini:

    • snippet.textOriginal
    • snippet.parentId

  • Anda dapat menetapkan nilai untuk properti ini:

    • snippet.textOriginal

Respons

Jika berhasil, metode ini akan menampilkan resource komentar 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) commentTextRequired Resource comment yang disisipkan harus menentukan nilai untuk properti snippet.textOriginal. Komentar tidak boleh kosong.
badRequest (400) commentTextTooLong Resource comment yang disisipkan berisi terlalu banyak karakter dalam properti snippet.textOriginal.
badRequest (400) invalidCustomEmoji Resource comment yang disisipkan berisi emoji kustom yang tidak valid.
badRequest (400) invalidCommentMetadata Metadata permintaan tidak valid.
badRequest (400) operationNotSupported Pengguna API tidak dapat menyisipkan komentar sebagai balasan ke komentar tingkat atas yang diidentifikasi oleh properti snippet.parentId. Dalam resource commentThread, properti snippet.canReply menunjukkan apakah penonton saat ini dapat membalas thread.
badRequest (400) parentCommentIsPrivate Komentar induk yang ditentukan bersifat pribadi. API tidak mendukung balasan ke komentar pribadi.
badRequest (400) parentIdMissing Komentar yang disisipkan harus ditautkan ke komentar induk. Namun, resource comment dalam isi permintaan API tidak menentukan nilai untuk properti snippet.parentId.
badRequest (400) processingFailure Server API gagal memproses permintaan dengan benar. Meskipun ini dapat menjadi error sementara, biasanya hal ini menunjukkan bahwa input permintaan tidak valid. Periksa struktur resource comment dalam isi permintaan untuk memastikan resource tersebut valid.
forbidden (403) forbidden Komentar tidak dapat dibuat karena izin tidak mencukupi. Permintaan mungkin tidak diotorisasi dengan benar.
forbidden (403) ineligibleAccount Akun YouTube yang digunakan untuk mengotorisasi permintaan API harus digabungkan dengan Akun Google pengguna untuk menyisipkan komentar atau rangkaian komentar.
notFound (404) parentCommentNotFound Komentar induk yang ditentukan tidak dapat ditemukan. Periksa nilai properti snippet.parentId dalam isi permintaan untuk memastikan nilai tersebut benar.

Cobalah!

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