Mengubah komentar.
Dampak kuota: Panggilan ke metode ini memiliki biaya kuota 50 unit.
Kasus penggunaan umum
Permintaan
Permintaan HTTP
PUT https://www.googleapis.com/youtube/v3/comments
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. Anda setidaknya harus menyertakan 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:
|
Isi permintaan
Berikan resource komentar dalam isi permintaan. Untuk resource tersebut:
-
Anda dapat menetapkan nilai untuk properti ini:
snippet.textOriginal
Tanggapan
Jika berhasil, metode ini menampilkan resource komentar di 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. Meskipun ini adalah error sementara, biasanya ini menunjukkan bahwa input permintaan tidak valid. Periksa struktur resource comment dalam isi permintaan untuk memastikannya valid. |
forbidden (403) |
forbidden |
Komentar tidak dapat diperbarui 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 memperbarui komentar atau rangkaian komentar. |
notFound (404) |
commentNotFound |
Komentar yang ditentukan tidak dapat ditemukan. Periksa nilai properti id di isi permintaan untuk memastikan bahwa properti tersebut sudah benar. |
Cobalah!
Gunakan APIs Explorer untuk memanggil API ini dan melihat permintaan dan respons API.