Kami memperbarui Data API agar sesuai dengan cara YouTube menghitung penayangan untuk Shorts.
Pelajari lebih lanjut
Penerapan: Rating
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-11-23 UTC.
[null,null,["Terakhir diperbarui pada 2024-11-23 UTC."],[[["\u003cp\u003eThe YouTube Data API (v3) allows users to rate videos using the \u003ccode\u003evideos.rate\u003c/code\u003e method, with options to \u003ccode\u003elike\u003c/code\u003e, \u003ccode\u003edislike\u003c/code\u003e, or remove a rating (\u003ccode\u003enone\u003c/code\u003e), requiring OAuth 2.0 authorization.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve the currently authenticated user's rating for specific videos by using the \u003ccode\u003evideos.getRating\u003c/code\u003e method and providing a comma-separated list of video IDs, also requiring OAuth 2.0.\u003c/p\u003e\n"],["\u003cp\u003eThe API enables the retrieval of a list of videos rated by the current user, either liked or disliked, through the \u003ccode\u003evideos.list\u003c/code\u003e method and its \u003ccode\u003emyRating\u003c/code\u003e parameter, which also requires OAuth 2.0.\u003c/p\u003e\n"],["\u003cp\u003eAlternatively, users can retrieve a list of their liked videos by using the \u003ccode\u003eplaylistItems.list\u003c/code\u003e method and accessing the \u003ccode\u003econtentDetails.relatedPlaylists.likes\u003c/code\u003e property, which offers an alternative to the \u003ccode\u003evideos.list\u003c/code\u003e method.\u003c/p\u003e\n"]]],["The YouTube Data API (v3) facilitates video rating management. Using `videos.rate`, users can set or remove ratings (`like`, `dislike`, `none`) for specific videos via the `id` and `rating` parameters. `videos.getRating` retrieves a user's rating for videos, referencing video IDs. The `videos.list` method, with the `myRating` parameter, fetches videos the user has rated as \"like\", and similar functionality is available via the `playlistItems.list` method. All requests require OAuth 2.0 authorization.\n"],null,["# Implementation: Ratings\n\nThe following examples show how to use the YouTube Data API (v3) to perform functions related to video ratings.\n\nRate a video\n------------\n\nCall the [videos.rate](/youtube/v3/docs/videos/rate) method to submit a user's rating for a video. This request must be authorized using OAuth 2.0.\n\nSet the following two parameters in your request:\n\n\u003cbr /\u003e\n\n- The [id](/youtube/v3/docs/videos/rate#id) parameter specifies the YouTube video ID of the video that is being rated (or having its rating removed).\n- The [rating](/youtube/v3/docs/videos/rate#rating) parameter specifies the rating that the user authorizing the request wishes to record. Valid parameter values are `like`, `dislike`, and `none`. The first two values set a rating, and the third removes any rating that previously existed for the user.\n\n\u003cbr /\u003e\n\nThe sample request below gives a positive (like) rating to the video of the keynote speech at the 2014 Google I/O conference: \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?\n id=wtLJPvx7-ys\n &rating=like\n```\n\nRetrieve the current user's rating of a video\n---------------------------------------------\n\nThe [videos.getRating](/youtube/v3/docs/videos/getRating) method lets you retrieve the currently authenticated user's rating of one or more videos. In your request, set the [id](/youtube/v3/docs/videos/rate#id) parameter's value to a comma-separated list of YouTube video IDs for the resources for which you are retrieving rating data. Note that this request must be authorized using OAuth 2.0.\n\nThe sample request below retrieves the current user's rating of the video of the keynote speech at the 2014 Google I/O conference. (If you executed the previous example in the APIs Explorer, the API response should indicate that the rating is `like`. \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?\nid=wtLJPvx7-ys\n```\n\nRetrieve videos rated by the current user\n-----------------------------------------\n\nThe `videos.list` method's [myRating](/youtube/v3/docs/videos/list#myRating) parameter lets you retrieve a list of videos rated by the user authorizing the API request. The parameter value indicates whether you want to retrieve liked or disliked videos.\n\nThe sample request below retrieves a list of videos to which the current user gave a `like` rating. The request must be authorized using OAuth 2.0. \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?\npart=snippet\n&myRating=like\n``` \n**Note:** You can also retrieve a list of the user's liked videos (but not disliked videos) by following the flow for [retrieving a channel's favorite videos](#favorites). In step 1 of that process, instead of retrieving the playlist ID for the channel's favorite videos, retrieve the playlist ID for the channel's liked videos. The `contentDetails.relatedPlaylists.likes` property contains the value. \n\nThus, the API allows you to retrieve a list of videos that the user liked using either the `videos.list` method or the `playlistItems.list` method. Since different information is returned in a `video` resource than a `playlistItem` resource, you can choose the method that best suits your needs."]]
