Menambahkan rating suka atau tidak suka ke video, atau menghapus rating dari video.
Dampak kuota: Panggilan ke metode ini memiliki biaya kuota sebesar 50 unit.
CATATAN: Hal ini tidak memengaruhi jumlah suka/tidak suka resmi video.
Kasus penggunaan umum
Permintaan
Permintaan HTTP
POST https://www.googleapis.com/youtube/v3/videos/rate
Otorisasi
Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut (baca lebih lanjut tentang autentikasi dan otorisasi).
Cakupan |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
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 | ||
id |
string Parameter id menentukan ID video YouTube pada video yang diberi rating atau ratingnya dihapus. |
|
rating |
string Menentukan rating yang akan dicatat. Nilai yang diterima adalah:
|
Isi permintaan
Jangan berikan isi permintaan saat memanggil metode ini.
Respons
Jika berhasil, metode ini akan menampilkan kode respons 204
HTTP (No Content
).
Error
Tabel berikut mengidentifikasi pesan error yang dapat ditampilkan API sebagai respons terhadap panggilan ke metode ini. Lihat dokumentasi pesan error untuk detail selengkapnya.
Jenis error | Detail error | Deskripsi |
---|---|---|
badRequest (400) |
emailNotVerified |
Pengguna harus memverifikasi alamat email sebelum memberi rating. |
badRequest (400) |
invalidRating |
Permintaan berisi nilai yang tidak terduga untuk parameter rating . |
badRequest (400) |
videoPurchaseRequired |
Video rental hanya dapat diberi rating oleh pengguna yang menyewanya. |
forbidden (403) |
forbidden |
Video yang ingin Anda beri rating tidak dapat diberi rating. Permintaan mungkin tidak diotorisasi dengan benar. |
forbidden (403) |
videoRatingDisabled |
Pemilik video yang ingin Anda beri rating telah menonaktifkan rating untuk video tersebut. |
notFound (404) |
videoNotFound |
Video yang ingin Anda beri rating tidak dapat ditemukan. Periksa nilai parameter id permintaan untuk memastikannya sudah benar. |
Cobalah!
Gunakan APIs Explorer untuk memanggil API ini dan melihat permintaan dan respons API.