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 diizinkan menggunakan OAuth 2.0.

Tetapkan dua parameter berikut dalam permintaan Anda:

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

Contoh permintaan di bawah ini memberikan rating positif (suka) pada video pidato keynote 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 video dari pengguna saat ini

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

Contoh permintaan di bawah ini mengambil rating pengguna saat ini atas video pidato keynote pada konferensi Google I/O 2014. (Jika Anda menjalankan contoh sebelumnya di APIs Explorer, respons API harus menunjukkan bahwa ratingnya adalah like.

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

Mengambil video yang dinilai oleh pengguna saat ini

Parameter myRating pada metode videos.list memungkinkan Anda mengambil daftar video yang diberi rating oleh pengguna yang memberi otorisasi 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 diizinkan 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 di channel. Pada langkah 1 dalam proses tersebut, alih-alih mengambil ID playlist untuk video favorit di channel, ambil ID playlist untuk video yang disukai di channel tersebut. Properti contentDetails.relatedPlaylists.likes berisi nilai.

Oleh karena itu, API memungkinkan Anda mengambil daftar video yang disukai pengguna menggunakan metode videos.list atau metode playlistItems.list. Karena informasi yang berbeda ditampilkan dalam resource video dan bukan resource playlistItem, Anda dapat memilih metode yang paling sesuai dengan kebutuhan Anda.