Videos: rate

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:
  • dislike – Merekam bahwa pengguna terautentikasi tidak menyukai video.
  • like – Catatan bahwa pengguna terautentikasi menyukai video.
  • none – Menghapus rating yang sebelumnya ditetapkan 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 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.