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 dari video yang diberi rating atau ratingnya dihapus.
rating string
Menentukan rating yang akan direkam.

Nilai yang dapat diterima adalah:
  • dislike – Mencatat bahwa pengguna yang diautentikasi tidak menyukai video tersebut.
  • like – Mencatat bahwa pengguna yang diautentikasi menyukai video tersebut.
  • none – Menghapus rating yang sebelumnya ditetapkan pengguna yang diautentikasi untuk video tersebut.

Isi permintaan

Jangan berikan isi permintaan saat memanggil metode ini.

Respons

Jika berhasil, metode ini akan menampilkan kode respons HTTP 204 (No Content).

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) emailNotVerified Pengguna harus memverifikasi alamat emailnya sebelum memberikan rating.
badRequest (400) invalidRating Permintaan berisi nilai yang tidak diharapkan untuk parameter rating.
badRequest (400) videoPurchaseRequired Video sewa hanya dapat diberi rating oleh pengguna yang menyewanya.
forbidden (403) forbidden Video yang Anda coba beri rating tidak dapat diberi rating. Permintaan mungkin tidak diotorisasi dengan benar.
forbidden (403) videoRatingDisabled Pemilik video yang Anda coba beri rating telah menonaktifkan rating untuk video tersebut.
notFound (404) videoNotFound Video yang Anda coba beri rating tidak dapat ditemukan. Periksa nilai parameter id permintaan untuk memastikan nilai tersebut benar.

Cobalah!

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