Eski YouTube Data API v2'deki yorum değişiklikleri

Jeremy Walker, YouTube API Ekibi
Eylül 2013 (güncellenme tarihi: 02.12.2013)

Giriş

Kasım 2013'te kullanıma sunulan ve Google+ tarafından desteklenen yeni YouTube yorum sistemi, YouTube kullanıcılarının geçmişte olduğundan daha fazla sayıda yorum almasını sağlar. Yeni sistem, yorumların bireysel kullanıcılarla alaka düzeyine göre sıralandığı için anlamlı görüşmeleri bulmayı da kolaylaştırır.

Yeni yorumlar şu anda YouTube Data API v3'te desteklenmese de API'nin eski sürümünü (v2) aşağıda belirtilen birkaç uyarıyla (ve yukarıda belirtilen avantajlarla) kullanmaya devam edebilirsiniz.

Yeni yorum yapma sistemine geçiş yaptığımız için entegrasyonunuzun çalışmaya devam ettiğini onaylamanızı ve hatalarla (youtube.com/dev adresindeki dosya sorunları) karşılaşırsanız bizi uyarmanızı öneririz. Teşekkürler.

Sık Sorulan Sorular

Geçişten önce yayınlanan yorumlara ne oldu?

Geçişten önce yayınlanan yorumlar Google+ tarafından desteklenen yeni sisteme taşınmıştır.

Yorum feed'i hâlâ kullanılabilir mi?

Evet. Örneğin, bir videonun yorumlarını almak için API'yi kullanıyorsanız duyuruda belirtildiği gibi, alaka düzeyine göre sıralanmış yorumlar feed'i alırsınız.* Yeni yorum yapma sistemine geçildiğinden beri yorumlar varsayılan olarak kronolojik düzende değildir. Bununla birlikte, API isteğinizde orderby parametresinin değerini aşağıdaki örnekte gösterildiği gibi published olarak ayarlayarak yorumları kronolojik olarak sıralayabilirsiniz:

https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?orderby=published

Yorumlarda sayfalar arasında geçiş yapmak için yorumlar feed'indeki next ve previous bağlantılarını kullanmaya ilişkin standart en iyi uygulamayı izlemenizi öneririz. Böylece, önceden olduğundan çok daha fazla yoruma göz atma olanağından da yararlanırsınız.

Yorumlar aracılığıyla sayfa için start-index değerini açık bir şekilde ayarlarsanız (önerilmez) bu davranış tutarsız olabilir ve yalnızca az sayıda yorum döndürülür.

Güncelleme (10/11/2013):

* Varsayılan olarak yorum feed'leri kişisel alaka düzeyine değil, genel alaka düzeyine göre sıralanır. Başka bir deyişle, kimliği doğrulanmış ve kimliği doğrulanmamış bir yorum feed'i isteği aynı sonuçları döndürür. API, herkese açık olmayan yayınları içeren kişiselleştirilmiş bir yorum feed'ini destekler. Bu feed'i almak için kimliği doğrulanmış bir istekte bulunmanız ve API isteğinizde relevant-to-me parametresinin değerini aşağıdaki örnekte gösterildiği gibi true olarak ayarlamanız yeterlidir:

https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?relevant-to-me=true

Yeni özet akışının biçimini gösteren bir özet akışı var mı?

Tüm yorum feed'leri artık yeni biçimi destekliyor. Aşağıda bazı örnekler verilmiştir.

  • Alaka düzeyine dayalı feed:
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true
  • Kronolojik olarak temellenen feed:
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published

Yine de API aracılığıyla yorum oluşturabilir miyim?

Evet ancak v2 API'yi kullanarak yeni yorum yazmak için bazı şartlar vardır:

  1. Kimliği doğrulanmış kullanıcının Google+ hesabına bağlı bir YouTube kanalı olmalıdır (API ayrıntıları)
  2. İstek HTTPS üzerinden gönderilmelidir (eski istemci kitaplıklarının mevcut sürümleri bunu varsayılan olarak destekler)

Bu koşullardan herhangi biri karşılanmazsa API bir hata döndürür.

Google+ tarafından desteklenen yorumlar, mesaj dizisi sunar. Bu durum YouTube yorum yanıtları için ne anlama geliyor?

Geçişten önce yapılan yorum yanıtları artık normal yorumlar olarak görünüyor. Bununla birlikte, YouTube API üzerinden doğrudan yorumları yanıtlama özelliği de desteklenmemektedir. Şu an için yeni tarzdaki yorumları YouTube API üzerinden yanıtlamanın bir yolu yoktur.

YouTube ve Google+ siteleri ve uygulamaları üzerinden yeni stilde yapılan YouTube yorumlarına verilen yanıtlar, eski API'nin yorum feed'iyle dönüştürülmez. Ancak, gerçek yanıtları Google+ API'leri üzerinden alabilirsiniz.

YouTube yorum feed'i girişi yeni bir yorumu temsil ediyorsa girişte <yt:googlePlusUserId> etiketi bulunur. Bu etiket mevcutsa ve yorumda yanıt verildiyse (<yt:replyCount> öğesini kontrol etmeniz yeterlidir) Google+ Etkinlik Kimliğini girişin <id> etiketinden ayrıştırabilirsiniz. Bu yoruma verilen son yanıtların listesini almak için Google+ API'sinin comments:list yöntemini çağırmak amacıyla bu kimliği kullanabilirsiniz.

Aşağıdaki alıntı kalın metinle gösterilen bir Google+ Etkinlik Kimliği'nin yorum feed'i girişinde nasıl göründüğünü göstermektedir:

<entry>
  <id>tag:youtube,2008:video:xpI6VNvRTII:comment:z13rtnibotmidjggs04cdvzgvurngv3pwnw0k</id>
  <yt:googlePlusUserId>123456789</yt:googlePlusUserId>
  <yt:replyCount>4</yt:replyCount>
  <yt:channelId>UCxxxx_xxxxx</yt:channelId>
  ...
</entry>

YouTube API üzerinden yorum yaptığımda Google+'da ne olur?

YouTube API üzerinden yorum yapmak Google+ akışınızda bir yayın oluşturmaz veya Google+ bildirimi oluşturmaz.

Yeni yorum yapma sistemine geçiş yapıldıktan sonra yorumlar etkinlik feed'inde gösterilmeye devam ediyor mu?

Hayır, şimdi değil.

Eski API'de SUP, yorumlar için kullanılmaya devam ediyor mu?

Hayır, yorumlar için değil. SUP kullanıcı etkinliği feed'ine dayanır. Yorumlar artık etkinlik feed'inde bulunmadığı için SUP aracında gösterilmez.