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

Jeremy Walker, YouTube API Ekibi
Eylül 2013 (2/12/2013 tarihinde güncellendi)

Giriş

Kasım 2013'te kullanıma sunulan ve Google+ tarafından desteklenen yeni YouTube yorum sistemi, YouTube kullanıcılarının video başına geçmişe kıyasla çok daha fazla yorum almasını sağlıyor. Yorumlar bireysel kullanıcılarla alaka düzeyine göre sıralandığından, yeni sistem anlamlı ileti dizileri bulmayı da kolaylaştırıyor.

Yeni yorumlar şu anda YouTube Data API v3'te desteklenmemektedir. Bununla birlikte, API'nin eski sürümünü (v2) aşağıda belirtilen birkaç kısıtlamayla (ve yukarıda açıklanan avantajlarla) kullanmaya devam edebilirsiniz.

Yeni yorum sistemine geçiş yaptığımızdan, entegrasyonunuzun çalışmaya devam ettiğini doğrulamanızı ve herhangi bir hatayla karşılaşırsanız bizi uyarmanızı (youtube.com/dev adresinden sorun gönderin) ö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şındı.

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

Evet. Örneğin, bir videonun yorumlarını almak için API'yi kullanırsanız duyuruda belirtildiği gibi alaka düzeyine göre sıralanmış bir yorum feed'i alırsınız.* Yeni yorum sistemine geçişten bu yana yorumlar varsayılan olarak kronolojik sıraya göre gösterilmiyor. Ancak aşağıdaki örnekte gösterildiği gibi, API isteğinizde orderby parametresinin değerini published olarak ayarlayarak yorumları kronolojik olarak sıralayabilirsiniz:

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

Yorumlar feed'indeki next ve previous bağlantılarını kullanarak yorumlar üzerinden sayfaya yönlendirmeyle ilgili standart en iyi uygulamayı uygulamanızı öneririz. Bu sayede, daha önce görebildiğinizden çok daha fazla yorumu sayfalar arasında kaydırabilirsiniz.

Yorum feed'inde sayfa için start-index için açıkça bir değer ayarlarsanız (önerilmez) bu durum tutarsız davranışa neden olabilir ve yalnızca az sayıda yorum döndürülür.

Güncelleme (10.11.2013):

* Yorum feed'leri varsayılan olarak kişisel alaka düzeyine göre değil, genel alaka düzeyine göre sıralanır. Başka bir deyişle, kimliği doğrulanmış ve doğrulanmamış bir yorum feed'i isteği aynı sonuçları döndürür. API, herkese açık olmayan gönderileri içeren kişiselleştirilmiş bir yorum feed'ini destekler. Bu feed'i almak için kimliği doğrulanmış bir istek göndermeniz 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 feed'in biçimini gösteren bir feed var mı?

Artık tüm yorum feed'leri yeni biçimi desteklemektedir. 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 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 ile yeni yorum yazmak için birkaç koşul 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 şartlardan herhangi biri karşılanmazsa API bir hata döndürür.

Google+ tarafından desteklenen yorumlar, mesaj dizileri sunar. Bu değişiklik, YouTube yorum yanıtları için ne anlama geliyor?

Geçişten önce verilen yorum yanıtları artık normal yorum olarak gösteriliyor. Ayrıca YouTube API üzerinden yorumlara doğrudan yanıt vermek artık desteklenmemektedir. Şu anda YouTube API üzerinden yeni yorumları yanıtlamak mümkün değildir.

YouTube ve Google+ siteleri ve uygulamaları üzerinden yeni tarzda YouTube yorumlarına verilen yanıtlar, eski API'nin yorum feed'iyle döndürülmez. Ancak gerçek yanıtları Google+ API'leri aracılığıyla alabilirsiniz.

YouTube yorum feed'i girişi yeni stil bir yorumu temsil ediyorsa girişte <yt:googlePlusUserId> etiketi bulunur. Bu etiket mevcutsa ve yorumda yanıt varsa (yalnızca <yt:replyCount> öğesini kontrol edin), girişin <id> etiketinden Google+ etkinlik kimliğini ayrıştırabilirsiniz. Bu yoruma verilen son yanıtların listesini almak için Google+ API'nin comments:list yöntemini çağırmak üzere bu kimliği kullanabilirsiniz.

Aşağıdaki alıntıda, kalın metinle gösterilen bir Google+ etkinlik kimliğinin yorum feed'i girişinde nasıl göründüğü gösterilmektedir:

<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+'ta ne olur?

YouTube API üzerinden yapılan yorumlar, Google+ akışınızda bir yayın veya Google+ bildirimi oluşturmaz.

Yeni yorum sistemine geçişten bu yana yorumlar etkinlik akışında görünmeye devam ediyor mu?

Hayır, şimdi değil.

Eski API'deki Süper, yorumlar için çalışmaya devam ediyor mu?

Hayır, yorumlar için değil. SUP, kullanıcı etkinliği feed'ini kullanır. Yorumlar artık etkinlik feed'inde olmadığı için SUP'de gösterilmez.