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 sedang diberi rating (atau rating-nya dihapus). - Parameter
rating
menentukan rating yang akan dicatat oleh pengguna yang mengizinkan permintaan. Nilai parameter yang valid adalahlike
,dislike
, dannone
. Dua nilai pertama menetapkan rating, dan nilai ketiga menghapus semua rating yang sebelumnya ada bagi pengguna.
Contoh permintaan di bawah ini memberikan peringkat positif (suka) pada video pidato utama pada konferensi Google I/O 2014:
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate? id=wtLJPvx7-ys &rating=like
Mengambil rating pengguna saat ini dari video
Metode videos.getRating
memungkinkan Anda mengambil rating pengguna yang saat ini diautentikasi untuk satu atau beberapa video. Dalam permintaan Anda, tetapkan nilai parameter id
ke daftar ID video YouTube yang dipisahkan koma untuk resource yang data pengambilannya Anda ambil. Perhatikan bahwa permintaan ini harus diotorisasi menggunakan OAuth 2.0.
Contoh permintaan di bawah ini menampilkan rating pengguna saat ini untuk video pidato utama pada konferensi Google I/O 2014. (Jika Anda menjalankan contoh sebelumnya di APIs 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
Ambil 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 ini mengambil daftar video yang rating like
-nya diberikan 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
contentDetails.relatedPlaylists.likes
berisi nilai.Dengan demikian, API memungkinkan Anda mengambil daftar video yang disukai pengguna menggunakan metode
videos.list
atau playlistItems.list
. Karena informasi yang berbeda ditampilkan dalam resource video
dibandingkan resource playlistItem
, Anda dapat memilih metode yang paling sesuai dengan kebutuhan Anda.