Data API'yi, YouTube'un Shorts görüntülemelerini sayma şekliyle eşleşecek şekilde güncelliyoruz.
Daha fazla bilgi
Uygulama: Puanlar
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Aşağıdaki örneklerde, video derecelendirmeleriyle ilgili işlevleri gerçekleştirmek için YouTube Data API'nin (v3) nasıl kullanılacağı gösterilmektedir.
Videolara oy verme
Kullanıcının bir videoya verdiği puanı göndermek için videos.rate yöntemini çağırın. Bu istek, OAuth 2.0 kullanılarak yetkilendirilmelidir.
İsteğinizde aşağıdaki iki parametreyi ayarlayın:
id parametresi, derecelendirilen (veya derecelendirmesi kaldırılan) videonun YouTube video kimliğini belirtir.rating parametresi, isteği yetkilendiren kullanıcının kaydetmek istediği derecelendirmeyi belirtir. Geçerli parametre değerleri like, dislike ve none'dir. İlk iki değer bir derecelendirme ayarlar, üçüncü değer ise kullanıcı için daha önce var olan tüm derecelendirmeleri kaldırır.
Aşağıdaki örnek istek, 2014 Google I/O konferansındaki açılış konuşmasının videosuna olumlu (beğenme) puan verir:
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?
id=wtLJPvx7-ys
&rating=like
Mevcut kullanıcının bir videoya verdiği puanı alma
videos.getRating yöntemi, kimliği doğrulanmış kullanıcının bir veya daha fazla videoya verdiği derecelendirmeyi almanıza olanak tanır. İsteğinizde id parametresinin değerini, derecelendirme verilerini aldığınız kaynakların YouTube video kimliklerinin virgülle ayrılmış bir listesi olarak ayarlayın. Bu isteğin OAuth 2.0 kullanılarak yetkilendirilmesi gerektiğini unutmayın.
Aşağıdaki örnek istek, mevcut kullanıcının 2014 Google I/O konferansındaki açılış konuşmasının videosuna verdiği puanı alır. (Önceki örneği API Gezgini'nde çalıştırdıysanız API yanıtında derecelendirmenin like olduğu belirtilir.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?
id=wtLJPvx7-ys
Mevcut kullanıcı tarafından derecelendirilen videoları alma
videos.list yönteminin myRating parametresi, API isteğini yetkilendiren kullanıcı tarafından puanlanan videoların listesini almanıza olanak tanır. Parametre değeri, beğenilmiş veya beğenilmemiş videoları almak isteyip istemediğinizi belirtir.
Aşağıdaki örnek istek, mevcut kullanıcının like puanı verdiği videoların listesini alır. İstek, OAuth 2.0 kullanılarak yetkilendirilmelidir.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like
Not: Kanalın favori videolarını alma akışını uygulayarak kullanıcının beğendiği videoların listesini de (beğenmedikleri videolar hariç) alabilirsiniz. Bu işlemin 1. adımında, kanalın favori videolarının oynatma listesi kimliğini almak yerine, kanalın beğendiği videoların oynatma listesi kimliğini alın.
contentDetails.relatedPlaylists.likes mülkü değeri içerir.
Bu nedenle API,
videos.list yöntemini veya
playlistItems.list yöntemini kullanarak kullanıcının beğendiği videoların listesini almanıza olanak tanır.
video kaynağında
playlistItem kaynağından farklı bilgiler döndürüldüğünden ihtiyaçlarınıza en uygun yöntemi seçebilirsiniz.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2024-11-23 UTC.
[null,null,["Son güncelleme tarihi: 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."]]
