Comments: update

Mengubah komentar.

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

Kasus penggunaan umum

Permintaan

Permintaan HTTP

PUT https://www.googleapis.com/youtube/v3/comments

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. Anda harus menyertakan setidaknya bagian snippet dalam nilai parameter karena bagian tersebut berisi semua properti yang dapat diperbarui oleh permintaan API.

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 dapat menetapkan nilai untuk properti berikut:

    • 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) commentTextTooLong Resource comment yang sedang diperbarui berisi terlalu banyak karakter di properti snippet.textOriginal.
badRequest (400) invalidCommentMetadata Metadata permintaan tidak valid.
badRequest (400) operationNotSupported Hanya komentar berbasis Google+ yang dapat diperbarui.
badRequest (400) processingFailure Server API gagal memproses permintaan dengan berhasil. Meskipun error ini mungkin bersifat sementara, biasanya error ini menunjukkan bahwa input permintaan tidak valid. Periksa struktur resource comment dalam isi permintaan untuk memastikan bahwa resource tersebut valid.
forbidden (403) forbidden Komentar tidak dapat diperbarui karena izin tidak memadai. Permintaan mungkin tidak diizinkan dengan benar.
forbidden (403) ineligibleAccount Akun YouTube yang digunakan untuk mengizinkan permintaan API harus digabungkan dengan Akun Google pengguna untuk memperbarui komentar atau rangkaian komentar.
notFound (404) commentNotFound Komentar yang ditentukan tidak dapat ditemukan. Periksa nilai properti id dalam isi permintaan untuk memastikan bahwa nilai tersebut sudah benar.

Cobalah!

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