Penerapan: Rating

Contoh berikut menunjukkan cara menggunakan YouTube Data API (v3) untuk menjalankan fungsi yang terkait dengan rating video.

Memberi peringkat video

Panggil metode videos.rate untuk mengirimkan rating pengguna untuk video. Permintaan ini harus diotorisasi menggunakan OAuth 2.0.

Tetapkan dua parameter berikut dalam permintaan Anda:

  • Parameter id menentukan ID video YouTube dari video yang diberi rating (atau ratingnya dihapus).
  • Parameter rating menentukan rating yang ingin dicatat oleh pengguna yang memberikan otorisasi pada permintaan. Nilai parameter yang valid adalah like, dislike, dan none. Dua nilai pertama menetapkan rating, dan nilai ketiga menghapus rating apa pun yang sebelumnya ada untuk pengguna.

Contoh permintaan di bawah memberikan rating positif (suka) ke video pidato utama di konferensi Google I/O 2014:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?
        id=wtLJPvx7-ys
        &rating=like

Mengambil rating video pengguna saat ini

Metode videos.getRating memungkinkan Anda mengambil rating satu atau beberapa video dari pengguna yang saat ini diautentikasi. Dalam permintaan Anda, tetapkan nilai parameter id ke daftar ID video YouTube yang dipisahkan koma untuk resource yang data rating-nya Anda ambil. Perhatikan bahwa permintaan ini harus diotorisasi menggunakan OAuth 2.0.

Contoh permintaan di bawah ini mengambil rating pengguna saat ini untuk video pidato utama di konferensi Google I/O 2014. (Jika Anda menjalankan contoh sebelumnya di API Explorer, respons API akan menunjukkan bahwa rating-nya adalah like.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?
id=wtLJPvx7-ys

Mengambil video yang diberi rating oleh pengguna saat ini

Parameter myRating metode videos.list memungkinkan Anda mengambil daftar video yang diberi rating oleh pengguna yang mengizinkan permintaan API. Nilai parameter menunjukkan apakah Anda ingin mengambil video yang disukai atau tidak disukai.

Contoh permintaan di bawah mengambil daftar video yang diberi rating like oleh pengguna saat ini. Permintaan harus diotorisasi menggunakan OAuth 2.0.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like
Catatan: Anda juga dapat mengambil daftar video yang disukai pengguna (tetapi bukan video yang tidak disukai) dengan mengikuti alur untuk mengambil video favorit channel. Pada langkah 1 proses tersebut, ambil ID playlist untuk video yang disukai channel, bukan ID playlist untuk video favorit channel. Properti contentDetails.relatedPlaylists.likes berisi nilai.

Dengan demikian, API memungkinkan Anda mengambil daftar video yang disukai pengguna menggunakan metode videos.list atau metode playlistItems.list. Karena informasi yang ditampilkan di resource video berbeda dengan resource playlistItem, Anda dapat memilih metode yang paling sesuai dengan kebutuhan Anda.