Uygulama: Derecelendirmeler

Aşağıdaki örneklerde, video puanlarıyla ilgili işlevleri yerine getirmek için YouTube Data API'sinin (v3) nasıl kullanılacağı gösterilmektedir.

Videolara oy verme

Bir kullanıcının videoya puan vermesini sağlamak 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 puanı 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. İlk iki değer bir derecelendirme belirler, üçüncüsü daha önce kullanıcının mevcut olduğu derecelendirmeleri kaldırır.

Aşağıdaki örnek istek, 2014 Google I/O konferansında açılış konuşmasının videosuna olumlu (beğenme) bir puan vermektedir:

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

Mevcut kullanıcının bir video için verdiği puanı alma

videos.getRating yöntemi, şu anda kimliği doğrulanmış kullanıcının bir veya daha fazla videoya verdiği puanı almanıza olanak tanır. İsteğinizde, id parametresinin değerini, derecelendirme verilerini aldığınız kaynaklar için YouTube video kimliklerinin virgülle ayrılmış 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ında açılış konuşmasının videosuna ilişkin derecelendirmesini alır. (Önceki örneği API Gezgini'nde yürüttüyseniz API yanıtı, derecelendirmenin like olduğunu belirtmelidir.

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

Mevcut kullanıcı tarafından oylanan videoları alma

videos.list yönteminin myRating parametresi, API isteğini yetkilendiren kullanıcı tarafından derecelendirilen videoların listesini almanıza olanak tanır. Parametre değeri, beğendiğiniz veya beğenmediğiniz videoları almak isteyip istemediğinizi belirtir.

Aşağıdaki örnek istek, mevcut kullanıcının like ile 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: Bir kanalın favori videolarını alma akışını uygulayarak kullanıcının beğendiği videoların listesini de alabilirsiniz. Bu sürecin 1. adımında, kanalın favori videoları için oynatma listesi kimliğini almak yerine kanal tarafından beğenilen videoların oynatma listesi kimliğini alın. contentDetails.relatedPlaylists.likes özelliği değeri içerir.

Dolayısıyla API, kullanıcının videos.list veya playlistItems.list yöntemini kullanarak sevdiğ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.