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 eskisinden çok daha fazla yorum almasına olanak tanıyor. Yorumlar, kullanıcılarla alaka düzeyine göre sıralandığından yeni sistem anlamlı sohbetleri de bulmanızı kolaylaştırır.

Yeni yorumlar şu anda YouTube Data API v3'te desteklenmese de aşağıda açıklanan birkaç uyarı (ve yukarıda ele alınan avantajlar) ile API'nin eski sürümünü (v2) 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ı.

Yorumlar feed'i hâlâ mevcut mu?

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 yapma sistemine geçildiğinden, yorumlar artık varsayılan olarak kronolojik sırada değildir. Ancak, API isteğinizde orderby parametresinin değerini aşağıdaki örnekte gösterildiği gibi published olarak ayarlayarak yorumları yine de zamana göre 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 olduğundan çok daha fazla yoruma göz atabilme avantajına da sahip olursunuz.

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):

* Varsayılan olarak, yorum feed'leri 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. Bu API, herkese açık olmayan yayınları içeren kişiselleştirilmiş 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 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 yorumlar yazmak için bazı gereksinimler 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 yapılan yorum yanıtları artık normal yorumlar olarak görünüyor. Ayrıca, YouTube API aracılığıyla yorumlara doğrudan yanıt verme özelliği 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 tarz YouTube yorumlarına verilen yanıtlar, eski API'nin yorum feed'iyle döndürülmez. Ancak asıl yanıtları Google+ API'leri üzerinden alabilirsiniz.

YouTube yorum feed'i girişi yeni stil bir yorumu temsil ediyorsa girişte <yt:googlePlusUserId> etiketi bulunur. Bu etiket mevcutsa ve yoruma yanıt verilmişse (<yt:replyCount> öğesini kontrol etmeniz yeterlidir) Google+ Etkinlik Kimliği'ni girişin <id> etiketinden 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'si aracılığıyla bir yorum yaptığımda Google+'da ne olur?

YouTube API'sı yoluyla yorum yapmak, Google+ akışınızda bir yayın veya bir 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.