Uygulama: Puanlar

Aşağıdaki örnekler, video derecelendirmeleriyle ilgili işlevleri gerçekleştirmek için YouTube Data API'nin (v3) nasıl kullanılacağını gösterir.

Videolara oy verme

Bir video için kullanıcının puanını göndermek amacıyla 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. İlk iki değer bir derecelendirme belirler, üçü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ğeni) bir derecelendirme verir:

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

Geçerli kullanıcının bir video için aldığı oyu al

videos.getRating yöntemi, kimliği doğrulanmış geçerli kullanıcının bir veya daha fazla videoyla ilgili puanını almanızı sağlar. İsteğinizde id parametresinin değerini, derecelendirme verilerini aldığınız kaynakların YouTube video kimliklerinin virgülle ayrılmış listesine 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ı videosuyla ilgili derecelendirmesini getirmektedir. (Önceki örneği API Gezgini'nde çalıştırdıysanız API yanıtı, derecelendirmenin like olduğunu belirtmelidir.

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

Geçerli kullanıcının derecelendirdiği videoları al

videos.list yönteminin myRating parametresi, API isteğini yetkilendiren kullanıcının derecelendirdiği videoların listesini almanızı sağlar. Parametre değeri, beğenilen veya beğenilmeyen videoları geri almak isteyip istemediğinizi belirtir.

Aşağıdaki örnek istek, geçerli kullanıcının like puanı verdiği videoların listesini getirir. İ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ı izleyerek kullanıcının beğendiği videoların (ancak beğenmedikleri videoların) bir listesini de alabilirsiniz. Bu sürecin 1. adımında kanalın favori videoları için oynatma listesi kimliğini almak yerine kanalın beğenilen videolarının oynatma listesi kimliğini alın. contentDetails.relatedPlaylists.likes özelliği, söz konusu değeri içerir.

Böylece API, kullanıcının beğendiği videoların listesini videos.list veya playlistItems.list yöntemi ile 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.