Videos: rate

Menambahkan rating suka atau tidak suka pada video, atau menghapus rating dari video.

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

CATATAN: Tindakan ini tidak akan memengaruhi jumlah suka/tidak suka resmi di 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 selengkapnya 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 dari video yang sedang diberi rating atau ratingnya dihapus.
rating string
Menentukan rating yang akan dicatat.

Nilai yang dapat diterima adalah:
  • dislike – Mencatat bahwa pengguna yang diautentikasi tidak menyukai video.
  • like – Catatan bahwa pengguna yang diautentikasi menyukai video.
  • none – Menghapus rating apa pun yang telah ditetapkan sebelumnya oleh pengguna terautentikasi untuk video.

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 mereka sebelum memberi rating.
badRequest (400) invalidRating Permintaan berisi nilai yang tidak terduga untuk parameter rating.
badRequest (400) videoPurchaseRequired Video rental hanya dapat dinilai oleh pengguna yang menyewanya.
forbidden (403) forbidden Video yang akan 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 pemberian rating untuk video tersebut.
notFound (404) videoNotFound Video yang coba Anda beri rating tidak dapat ditemukan. Periksa nilai parameter id permintaan untuk memastikan nilainya benar.

Cobalah!

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