Uygulama: Puanlar

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.