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
venone
. İ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
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.