Düzeltme Geçmişi

Bu sayfada YouTube Data API (v3) değişiklikleri ve belgelerle ilgili güncellemeler listelenmiştir. Bu değişiklik günlüğüne abone olun.

30 Nisan 2024

Not: Bu, kullanımdan kaldırma duyurusudur.

Bu güncelleme aşağıdaki değişiklikleri içerir:

API, kanal tartışmalarını ekleme veya alma özelliğini artık desteklememektedir. Bu değişiklik, YouTube web sitesinde desteklenen ve kanallara yorum yayınlamayı desteklemeyen işlevlerle tutarlıdır.

13 Mart 2024

Not: Bu, kullanımdan kaldırma duyurusudur.

Bu güncelleme aşağıdaki değişiklikleri içerir:

Şu öğe için sync parametresi: captions.insert ve captions.update yöntem desteği sonlandırıldı. YouTube, parametresini kullanın.

Bu değişikliğin bir sonucu olarak, geliştiriciler altyazı parçalarını güncellemediğiniz takdirde yükleme başarısız olur.

12 Mart 2024

Bu güncelleme aşağıdaki değişiklikleri içerir:

captions kaynağına ilişkin dokümanlar, snippet.name için izin verilen maksimum uzunluğun belirtileceği şekilde güncellendi. alanı 150 karakterdir. API, bir nameTooLong döndürür. hatasını alırsınız.

7 Mart 2024

Not: Bu, kullanımdan kaldırma duyurusudur.

channel kaynak özelliği brandingSettings.channel.moderateComments desteği sonlandırıldı. YouTube durdurulacak 7 Mart 2024 itibarıyla bu parametreyi destekler.

31 Ocak 2024

Bu güncelleme aşağıdaki değişiklikleri içerir:

channels.list yönteminin yeni forHandle parametresi, YouTube herkese açık kullanıcı adını belirterek kanal hakkında bilgi almanızı sağlar.

9 Kasım 2023

Comments altındaki videoId kaynağına yapılan tüm referanslar videoId kaynağı bir API çağrısı kullanılarak döndürülmediğinden kaldırıldı.

12 Eylül 2023

Not: Bu, kullanımdan kaldırma duyurusudur.

comments.markAsSpam yöntemi birkaç yıldır kullanımdan kaldırıldı. Bu yöntem YouTube'da zaten desteklenmemektedir ve artık API yoluyla destekleniyor.

comments.markAsSpam yöntemini çağırın.

22 Ağustos 2023

search.list yöntemi artık videoPaidProductPlacement parametresinden sonra bir değer girin. Bu parametre, arama sonuçlarını yalnızca içerik üretici, ücretli tanıtım içerdiğini belirtti.

18 Ağustos 2023

video kaynağının tanımı liveStreamingDetails.concurrentViewers YouTube Data API'nin döndürdüğü eşzamanlı izleyici sayılarının YouTube üzerinden sunulan işlenmiş, spam'den arındırılmış eşzamanlı izleyici sayısından farklı Analiz. İlgili içeriği oluşturmak için kullanılan YouTube Yardım Merkezi canlı yayın metrikleri hakkında daha fazla bilgi sağlar.

7 Ağustos 2023

12 Haziran 2023'te duyurulduğu gibi search.list yönteminin relatedToVideoId parametresi kullanımdan kaldırıldı. Bu parametre artık desteklenmeye başlandı ve parametreye yapılan referanslar API dokümanlarından kaldırıldı.

28 Haziran 2023

thumbnails.set yöntemi artık uploadRateLimitExceeded hatası, kanalın çok fazla içerik yüklediğini gösterir küçük resmi kullanmaya başladım. Daha sonra tekrar denemeniz gerekir.

12 Haziran 2023

Not: Bu, kullanımdan kaldırma duyurusudur.

search.list yönteminin relatedToVideoId parametresi kullanımdan kaldırıldı. YouTube, parametresini kullanabilirsiniz.

Şu anda search.list yönteminin belgelerinden faydalanabilirsiniz. Bu parametre search.list dokümanlarından tamamen kaldırılacak 7 Ağustos 2023'te veya sonrasında.

Ayrıca, ilgili videoların nasıl alınacağını gösteren bir API uygulama kılavuzundan kaldırılmıştır.

22 Ağustos 2022

video.statistics için düzeltilmiş tür ek açıklamalar alanlarından dizeye eklenecek.

5 Ağustos 2022

YouTube altyazı kimliklerinin oluşturulma şeklini değiştirdi. Bu değişiklikle birlikte tüm altyazı parçalarına yeni altyazı kimlikleri atanmasını isteyebilirsiniz. Bu değişiklik eski sürümlerle uyumsuz olabilir uygulamada depolandığı caption_id değerleri vardır, ancak veya e-tablolarda depolanan caption_id değerleri.

1 Aralık 2022 tarihinden itibaren captions.list, captions.update, captions.download ve captions.delete yöntemleri de hem eski hem de yeni altyazı parçası kimliklerini destekler. Ancak YouTube, 1 Aralık 2022'de veya bu tarihten sonra eski altyazı parçası kimliklerini desteklemeyi bırakacak. O sırada bu API yöntemlerinden herhangi birini çağırarak kimliği eski bir altyazı parçası olursa, captionNotFound hata.

Bu değişikliğe hazırlanmak için saklanan tüm altyazı parçası verilerini tamamen değiştirmeyi planlamalısınız. 1 Aralık 2022'ye kadar değişebileceğini unutmayın. Yani altyazı parçası depoladığınız tüm videolarda verilerini silmek istiyorsanız, depolanmış olan verileri silmeli ve ardından captions.list yöntemini alma ve verileri API yanıtında istediğiniz gibi depolayın ve gerekir.

12 Temmuz 2022

YouTube API Hizmetleri Hizmet Şartları güncellendi. Lütfen YouTube API Hizmetleri Hizmet Şartları - Düzeltme'yi inceleyin. Geçmiş'e göz atın.

27 Nisan 2022

videos.insert yöntemi açıklaması, yüklenen videolar için maksimum dosya boyutunun 128 GB'tan 256 GB'a yükseltildiğini belirtecek şekilde güncellendi.

8 Nisan 2022

subscriptions.list yönteminin myRecentSubscribers ve mySubscribers parametre tanımları API tarafından döndürülen maksimum abone sayısının sınırlı olabileceğini belirtecek şekilde güncellendi. Bu değişiklik, API davranışında bir değişiklik değil, belgelemeyle ilgili düzeltme niteliğindedir.

15 Aralık 2021

18 Kasım 2021'de duyurulduğu gibi, videoyu beğenmeme ile ilgili değişiklikler YouTube platformu genelinde, video kaynağın statistics.dislikeCount mülkü artık gizli.

Bu değişiklikle ilgili daha fazla bilgiyi YouTube'un resmi blogunda bulabilirsiniz.

18 Kasım 2021

Projedeki değişikliklerle birlikte video kaynağının tamamı olan YouTube platformu genelinde beğenmeme sayılarını gizli olarak ayarlayabilirsiniz. statistics.dislikeCount mülkü 13 Aralık 2021 itibarıyla gizli hale getirilecektir. Bu, mülkün yalnızca API isteği aşağıdaki gibiyse videos.list uç noktasından bir API yanıtına dahil edilir: Video sahibi tarafından doğrulanmıştır.

videos.rate uç noktası etkilenmez üzerinde durabilirsiniz.

Beğenmeme sayılarını herkese açık şekilde göstermeyen ancak yine de beğenmeme sayısına ihtiyaç duyan geliştiriciler API istemcisi, muafiyet için izin verilenler listesine eklenmek üzere başvuruda bulunabilir. Muafiyet başvurusunda bulunmak için bunu tamamlamalıdır başvuru formunu doldurun.

Bu değişiklikle ilgili daha fazla bilgiyi YouTube'un resmi blogunda bulabilirsiniz.

2 Temmuz 2021

Not: Bu, kullanımdan kaldırma duyurusudur.

commentThreads.update uç noktası kullanımdan kaldırıldı ve artık desteklenmiyor. Bu uç nokta işlevi, diğer API uç noktaları üzerinden kullanılabilen işlevi yineledi. Bunun yerine comments.update cihazını ara

yöntem ve kodunuz bir commentThreads kaynağı gerektiriyorsa commentThreads.list yöntemini çağırın.

1 Temmuz 2021

YouTube'un API Hizmetleri'ni kullanan tüm geliştiricilerin,varsayılan olarak ayrılan 10.000 birimlik kotanın üzerinde verilebilmesi için API Uygunluk Denetimi'ni tamamlaması gerekir. Bugüne kadar hem uygunluk denetim süreci hem de ek kota birimi ayırma istekleri, YouTube API Hizmetleri - Denetim ve Kota Artırma Formu'nu doldurup gönderen geliştiriciler tarafından gerçekleştirildi.

Bu süreçleri açıklığa kavuşturmak ve API Hizmetlerimizi kullanan geliştiricilerin ihtiyaçlarını daha iyi karşılamak için üç yeni form ve bu formları doldurmayla ilgili bir kılavuz ekliyoruz:

• Denetlenen Geliştirici İstekleri Formu: API Uygunluk Denetimi'nden geçmiş olan geliştiriciler, kendilerine ayrılan kotanın uzatılmasını istemek için bu kısa formu doldurup gönderebilirler.
• İtiraz Formu: API projeleri, uygunluk denetiminde başarısız olan (veya kota birimi artışını reddedilen) geliştiriciler bu formu doldurup gönderebilir.
• Denetim Formu Değişikliği: Geliştirici adına API istemcisini yöneten ve bir API projesiyle ilişkili yönetim değişikliği yaşayan (örneğin, hisse alımı veya satışı, birleşme veya diğer kurumsal işlemler yoluyla) geliştiriciler veya herhangi bir taraf bu formu doldurup göndermelidir. Bu sayede YouTube API ekibi kayıtlarımızı güncelleyebilir, yeni API projesinin kullanım alanına uygunluğunu denetleyebilir ve geliştiricinin mevcut kota tahsisini doğrulayabilir.

Her yeni form, YouTube API'yi hangi amaçla kullandığınızı bildirir ve size daha iyi yardımcı olabilmemizi sağlar.

Daha ayrıntılı bilgiyi yeni API Uygunluk Denetimleri kılavuzumuzda bulabilirsiniz.

12 Mayıs 2021

Not: Bu, kullanımdan kaldırma duyurusudur.

Bu güncelleme aşağıdaki API değişikliklerini kapsar:

• channel kaynağının contentDetails.relatedPlaylists.favorites özelliğinin desteği sonlandırıldı. Favori videolar işlevi için destek sonlandırılmıştır 28 Nisan 2016 tarihli revizyonda belirtildiği gibi birkaç yıl geçmiş girişi.

  Bu güncellemeden önce bir API istemcisi şunu yapmaya çalıştığında API, yeni bir oynatma listesi oluşturmaya devam ediyordu: var olmayan bir sık kullanılan oynatma listesine video ekleme. Bundan sonra, oynatma listesi bir hata döndürür. API bir hata döndürür. Favori oynatma listelerinde değişiklik yapma denemeleri Öğe ekleme, değiştirme veya silme yoluyla da önceki duyurular uyarınca herhangi bir anda hata döndürmeye başlayabilir.

• Aşağıdaki channel kaynağı mülklerinin desteği sonlandırıldı. Bu özellikler, YouTube Studio kullanıcı arayüzünde zaten desteklenmemektedir ve YouTube'da gösterilebilir. Bunun sonucunda, bunlar artık API üzerinden de desteklenmemektedir.

  • brandingSettings.channel.defaultTab
  • brandingSettings.channel.featuredChannelsTitle
  • brandingSettings.channel.featuredChannelsUrls[]
  • brandingSettings.channel.profileColor
  • brandingSettings.channel.showBrowseView
  • brandingSettings.channel.showRelatedChannels

  Tüm özellikler channel kaynak temsili ve bunların tanımları kaynağın mülk listesi. Ayrıca hatalar bu özelliklerle ilişkili dokümanlar, yönteme özel dokümanlardan kaldırılmıştır.

• Aşağıdaki channelSection kaynağı mülklerinin desteği sonlandırıldı. Bu özellikler, YouTube Studio kullanıcı arayüzünde zaten desteklenmemektedir ve YouTube'da gösterilebilir. Bunun sonucunda, bunlar artık API üzerinden de desteklenmemektedir.

  • snippet.style
  • snippet.defaultLanguage
  • snippet.localized.title
  • localizations
  • localizations.(key)
  • localizations.(key).title
  • targeting
  • targeting.languages[]
  • targeting.regions[]
  • targeting.countries[]

  Bu değişiklikle bağlantılı olarak, channelSection.list yöntemi hl parametresi ayrıca Desteklediği özellikler desteklenmediği için kullanımdan kaldırılmıştır.

  Tüm özellikler channelSection kaynak temsili ve bunların tanımları kaynağın mülk listesi. Ayrıca hatalar bu özelliklerle ilişkili dokümanlar, yönteme özel dokümanlardan kaldırılmıştır.

• channelSection kaynağının snippet.type mülk, aşağıdaki değerler kullanımdan kaldırılmıştır. Bu değerler YouTube'da zaten desteklenmiyor ve dolayısıyla artık API yoluyla da desteklenmemektedir.

  • likedPlaylists
  • likes
  • postedPlaylists
  • postedVideos
  • recentActivity
  • recentPosts

• playlist kaynağının snippet.tags[] özelliğinin desteği sonlandırıldı. Bu özellik zaten desteklenmiyor ve bu nedenle artık API aracılığıyla desteklenmemektedir.

9 Şubat 2021

playlistItem kaynağı iki yeni özelliği destekler:

• snippet.videoOwnerChannelId özelliği, oynatma listesi videosunu yükleyen kanalın kimliğini tanımlar.
• snippet.videoOwnerChannelTitle özelliği, oynatma listesi videosunu yükleyen kanalın adını tanımlar.

28 Ocak 2021

Bu güncelleme aşağıdaki değişiklikleri içerir:

• playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list ve playlists.update yöntemlerin tümü destekleniyor yeni bir playlistOperationUnsupported hatası. Hata, bir istek belirli bir oynatma listesi için izin verilmeyen bir işlem gerçekleştirmek. Örneğin, bir kullanıcı Kullanıcının yüklediği videolar oynatma listesinden bir videoyu silme veya oynatma listesini silme.

  Her durumda bu hata, 400 HTTP yanıt kodu (Hatalı İstek) döndürür.

• playlistItems.list yönteminin watchHistoryNotAccessible ve watchLaterNotAccessible hata belgelerden çıkarılmıştır. Kullanıcıların izleme geçmişi ve "daha sonra izle" listeleri, söz konusu hatalar API tarafından döndürülmez.

15 Ekim 2020

Geliştirici uygulamasına iki yeni bölüm eklendi Politikalar:

• Yeni Bölüm III.E.4.i, yerleştirilmiş ve YouTube oynatıcısı aracılığıyla toplanan ve gönderilen veriler hakkında ek bilgi. Siz herhangi bir yerleşik YouTube oynatıcısı aracılığıyla bize gönderdiğiniz tüm kullanıcı verilerinden, Kullanıcı, oynatma amacını belirtmek için oynatıcıyla etkileşimde bulunur. Paylaşılan verileri sınırlandırabilirsiniz Otomatik oynatma özelliğini false (yanlış) olarak ayarlayarak, kullanıcı oynatıcıyla etkileşimde bulunmadan önce YouTube'u oynatın.
• Yeni Bölüm III.E.4.j, içeriği sitelerinize yerleştirmeden önce çocuklara özel (Çocuklara Özel) (Çocuklara Özel) durumunu kontrol etme ve API İstemcinize yerleştirdiğiniz videoların ne zaman oluşturulduğunu bilmek sizin sorumluluğunuzdadır ve yerleşik oynatıcıdan toplanan verilerin uygun şekilde işlenmesi gerekir. Bu nedenle, YouTube Data API Hizmeti'ni kullanarak içeriği API'nize yerleştirmeden önce içeriğin durumunu kontrol edin Yerleşik YouTube oynatıcıları aracılığıyla istemci.

Yeni Finding the MadeForKids (Videonun MadeForKids) durumunu bulma kılavuzunda, YouTube Data API Hizmeti.

Bu değişikliklerle birlikte, Yerleşik Oynatıcı Parametresi dokümanları, Otomatik oynatmayı etkinleştirirseniz oynatma, kullanıcının oynatıcıyla etkileşimi olmadan gerçekleşir; oynatma Dolayısıyla veri toplama ve paylaşma, sayfa yüklendikten sonra gerçekleşir.

8 Ekim 2020

Bu güncelleme, channel kaynak:

• snippet.thumbnails (yeni oluşturulan reklam öğeleri için boş olabilir) otomatik olarak oluşturulur ve doldurulması bir günü bulabilir.
• statistics.videoCount mülkündeki her bir özellik, kanalın herkese açık videolarının sayısını (sahipler için bile) yansıtır. Bu davranış YouTube web sitesinde gösterilen sayılarla tutarlı.
• Raporda belirtilen kanal anahtar kelimeleri, brandingSettings.channel.keywords. 500 karakterlik maksimum uzunluğu aşmaları durumunda kısaltılabilir. ." 500 karakterlik limiti, anahtar kelime başına bir sınır değildir, bunun yerine tüm anahtar kelimelerin toplam uzunluğuna yönelik bir sınırdır. Bu davranış, YouTube web sitesindeki davranışla tutarlıdır.

9 Eylül 2020

Not: Bu, kullanımdan kaldırma duyurusudur.

Bu güncelleme aşağıdaki API değişikliklerini kapsar. Tüm değişiklikler şu tarihte veya daha sonra geçerli olacaktır: Bu duyurunun tarihi 9 Eylül 2020'dir. Bu doğrultuda, geliştiriciler artık aşağıda listelenen API özelliklerinden herhangi birini kullanması gerekir.

• Aşağıdaki API kaynakları, yöntemleri, parametreleri ve kaynak özellikleri kullanımdan kaldırıldı ve bu duyurunun yapıldığı tarihte veya bu tarihten sonra çalışmayı durduracak:
  • Aşağıdaki channel kaynağı özellikler:
    • statistics.commentCount mülkü
    • brandingSettings.image nesnesi ve tüm alt özellikleri
    • brandingSettings.hints listesi ve tüm alt mülkleri
  • channels.list yönteminin categoryId filtre parametresi
  • guideCategories kaynağı ve guideCategories.list yöntem
• Şunun için API yanıtları: channels.list yöntem numarası artık daha uzun prevPageToken API isteği managedByMe parametresi Hedef: true. Bu değişiklik prevPageToken özelliğini etkilemez diğer channels.list istekleri için çalışır ve bu, nextPageToken özelliğini kullanabilirsiniz.
• channel kaynağının contentDetails.relatedPlaylists.watchLater ve contentDetails.relatedPlaylists.watchHistory mülk duyuruldu 11 Ağustos 2016'da kullanımdan kaldırılacaktır. İlgili içeriği oluşturmak için kullanılan playlistItems.insert yönteminin ve playlistItems.delete yönteminin desteği Bu oynatma listeleri için desteği de artık tamamen sonlandırıldı ve iki özellik kaldırıldı. bazı bilgiler vereceğim.
• channels.list yönteminin mySubscribers parametresi 30 Temmuz 2013 tarihinde desteği sonlandırıldığı duyuruldu, belgelerden kaldırılmıştır. Şunu kullanın: subscriptions.list yöntem ve mySubscribers parametresini kullanarak kimliği doğrulanmış kullanıcının kanalı.
• channel kaynağının invideoPromotion nesnesi ve tüm alt öğeleri mülklerinin 27 Kasım 2017, belgelerden kaldırılmıştır.

29 Temmuz 2020

Ek part parametresiyle ilişkili maliyet. Anında geçerli olmak üzere, sizden yalnızca çağrılan yöntemin taban maliyetini ifade eder. Daha fazla bilgi edinmek için burada bulabilirsiniz.

Bu değişikliğin sonucunda, çoğu API çağrısının kota maliyeti marjinal şekilde daha düşük olur. bazı API çağrılarının maliyeti aynı kalır. Bu değişiklik hiçbir API'nin maliyetini artırmaz. çağrısının en iyi yolu. Genel olarak bu durumun olası etkisi, Google Cloud Console'da bir adım daha ileri gider.

Tüm geliştiricilerin uygunluk denetlemesini YouTube API Hizmetleri'ne sürekli erişim sağlamak için projelere dahil edilir.

Bu düzeltme geçmişi girişi ilk olarak 20 Temmuz 2020'de yayınlanmıştır.

28 Temmuz 2020

videos.insert aracılığıyla yüklenen tüm videolar 28 Temmuz 2020'den sonra oluşturulan doğrulanmamış API projelerine ait uç nokta, gizli görüntüleme moduna geçer. Bu kısıtlamayı kaldırmak için her projenin denetimden geçmelisiniz. Hizmet Şartları.

Video yüklemek için doğrulanmamış bir API istemcisi kullanan içerik üreticiler, aşağıdakileri açıklayan bir e-posta alırlar: videosu gizli olarak kilitlendiğinden ve kısıtlamadan kaçınmak için resmi bir müşteri olabilir.

28 Temmuz 2020'den önce oluşturulan API projeleri şu anda bu değişiklikten etkilenmiyor. Ancak tüm geliştiricilerin uygunluk denetimini tamamlayın .

21 Temmuz 2020

[28 Temmuz 2020'de güncellendi.] Bu düzeltmede atıfta bulunulan doküman güncellemesi geçmiş girişi 28 Temmuz 2020'de yeniden yayınlandı.

Dün, kota ücretlendirme işlemimizle ilgili bir doküman güncellemesi yayınladık. Ancak öngörülemeyen koşullar nedeniyle, kota değişikliği henüz yürürlüğe girmemiştir. Sonuç olarak doğruluğundan emin olmak üzere geri döndürüldü. Karışıklık olmaması için düzeltme değişikliği açıklayan geçmiş girişi kaldırıldı ve yakın gelecekte yeniden yayınlanacak.

7 Temmuz 2020

Not: Bu, kullanımdan kaldırma duyurusudur.

videos.insert yönteminin autoLevels ve stabilize parametreleri artık kullanımdan kaldırıldı ve hem parametreleri belgelerden kaldırılmıştır. Değerleri yoksayılır ve yeni yüklenen videoların işlenme şeklini belirler.

15 Haziran 2020

Yeni YouTube Geliştiriciye Uyma Politikalar kılavuzu, API müşterilerinizin politikalara uymasını sağlamanıza yardımcı olacak yönergeler ve örnekler sunar. YouTube API Hizmetleri'nin belirli bölümleri için Şartlar ve Politikalar (API Hizmet Şartları).

Bu kılavuz, YouTube'un API Hizmet Şartları'nın belirli yönlerini nasıl uyguladığı ve mevcut dokümanların yerine geçmez. Kılavuzda emin olun. Bu bilgilerin, özellik geliştirme sürecinizi basitleştirdiğini umuyoruz. politikalarımızı nasıl yorumladığımızı ve uyguladığımızı anlamanıza yardımcı olur.

4 Haziran 2020

Not: Bu, önceki bir kullanımdan kaldırma duyurusuna yönelik güncellemedir.

Kanal bülteni özelliği kullanımdan tamamen kaldırıldı. Bu değişiklik başlangıçta duyuruldu 17 Nisan 2020'de yürürlüğe girdi. Sonuç olarak activities.insert yöntemi hayır daha uzun süre desteklendiğini ve activities.list yöntemi artık kanal bültenlerini döndürmez. Daha fazla bilgi için lütfen YouTube Yardım Merkezi.

17 Nisan 2020

Not: Bu, kullanımdan kaldırma duyurusudur.

YouTube, kanal bülteni özelliğini kullanımdan kaldırıyor. Sonuç olarak activities.insert yöntemi ve activities.list yöntemini kullanarak kanal bültenlerini döndürmeyi bırakır. Bu değişiklikler, 2023'e kadar 19:00'dan (18 Mayıs 2020) itibaren Daha fazla bilgi için lütfen YouTube Yardım Merkezi.

31 Mart 2020

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni kaynaklar ve yöntemler

  • Yeni member kaynağı şunu temsil eder: bir YouTube kanalına üye olmanız gerekir. Üyesi, başka bir üyeye ve özel avantajlar elde ediyor. Örneğin üyeler, sohbet sırasında içerik üretici, sohbet için üyelere özel modunu etkinleştiriyor.

    Bu kaynak, sponsor yerini alır kaynağıdır. Bu kaynak, YouTube Live Streaming API'nın bir parçası olarak belgelenmiştir. İlgili içeriği oluşturmak için kullanılan sponsor kaynağının desteği sonlandırıldı ve API istemcilerinin çağrıları kullanmak için sponsors.list yöntemini Bunun yerine members.list yöntemini kullanın.

  • Yeni membershipsLevel kaynağı, API isteğini yetkilendiren içerik üreticinin yönettiği bir fiyatlandırma düzeyini tanımlar. membershipsLevels.list yöntemi, içerik üreticinin tüm üyelik düzeylerinin listesini alır.

10 Ocak 2020

API artık YouTube'un çağırdığı çocuklara yönelik içeriği tanımlama özelliğini desteklemektedir. "çocuklara özel". Daha fazla bilgi: "çocuklara özel" içerik başlıklı makalemize bakın.

channel ve video kaynakları, içerik üreticilerin ve izleyicilerin çocuklara özel içerikleri tespit edebilmesini sağlayan:

• selfDeclaredMadeForKids özelliği, içerik üreticilerinin channel veya videonun çocuklara özel olması gerekir.
  
  Kanallar için bu özellik, channels.update yöntemini çağırın. Videolar için bu özellik, videos.insert veya videos.update yöntem.
  
  Bu özelliğin yalnızca channel veya Kanal sahibi API isteğini yetkilendirdiyse video kaynak.
• madeForKids özelliği, tüm kullanıcıların "çocuklara özel" içeriklerini almasına olanak tanır durum bir kanalın veya video. Örneğin, selfDeclaredMadeForKids özelliğinin değerine göre belirlenir. Bkz. Daha fazla bilgi için YouTube Yardım Merkezi kanalınız, videolarınız veya yayınlarınızın kitlesini ayarlamayla ilgili bilgiler.

Ayrıca YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları da güncellendi. Lütfen YouTube API Hizmetleri Hizmet Şartları - Düzeltme'yi inceleyin. Geçmiş'e göz atın. YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları, Pasifik Saati'ne göre 10 Ocak 2020'de yürürlüğe girecektir.

10 Eylül 2019

API referans belgeleri, abonelerin sayısı YouTube'da ve bunun sonucunda da API yanıtlarında raporlanır. Bu değişikliğin bir sonucu olarak, YouTube Data API Hizmeti tarafından döndürülen abone sayıları, üç anlamlı değere yuvarlanır. yüzde 1000'den fazla abone sayısına ulaşıldı. Bu değişiklik channel kaynağın statistics.subscriberCount

Not: Bu değişiklik, kullanıcının Kendi kanallarıyla ilgili veriler için yetkili istek gönderdiğinde Kanal sahipleri, YouTube Studio'daki abone sayısını göz önünde bulundurun.

Örneğin, bir kanalın 123.456 abonesi varsa statistics.subscriberCount özelliği 123000 değerini içerir. Aşağıdaki tabloda abone sayılarının API yanıtlarında nasıl yuvarlandığına dair örnekler ve herkese açık diğer YouTube kullanıcı arayüzlerinde kısaltılamaz:

Örnek abone sayısı	YouTube Data API	Herkese açık YouTube kullanıcı arayüzleri
1.234	1230	1,23 B
12.345	12300	12,3 B
123.456	123000	123 B
1.234.567	1230000	1,23 M
12.345.678	12300000	12,3 M
123.456.789	123000000	123 M

4 Nisan 2019

Bu güncelleme aşağıdaki değişiklikleri içerir:

• API referans belgeleri, her yöntemin yaygın kullanım alanlarını daha iyi açıklamak ve API Gezgini widget'ı üzerinden dinamik, yüksek kaliteli kod örnekleri sağlamak için güncellendi. Örnek için channels.list yönteminin belgelerine bakın. Artık sayfalarda API yöntemlerini açıklayan iki yeni öğe bulunuyor:

  • API Gezgini widget'ı, yetkilendirme kapsamlarını seçmenize, örnek parametre ve özellik değerleri girmenize, ardından gerçek API istekleri göndermenize ve gerçek API yanıtlarını görmenize olanak tanır. Widget aynı zamanda eksiksiz kod örneklerini gösteren tam ekran görünüm de sunar. Bu örnekler, girdiğiniz kapsamları ve değerleri kullanacak şekilde dinamik olarak güncellenir.

  • Yaygın kullanım alanları bölümünde, sayfada açıklanan yöntemin bir veya daha fazla yaygın kullanım alanı açıklanmaktadır. Örneğin, belirli bir kanalla ilgili verileri veya geçerli kullanıcının kanalıyla ilgili verileri almak için channels.list yöntemini çağırabilirsiniz.

    API Gezgini'ni kullanım alanınıza ait örnek değerlerle doldurmak veya bu değerler doldurulmuş olarak tam ekran API Gezgini'ni açmak için bu bölümdeki bağlantıları kullanabilirsiniz. Bu değişikliklerin amacı, kendi uygulamanızda uygulamaya çalıştığınız kullanım alanı için doğrudan geçerli olan kod örneklerini görmenizi kolaylaştırmaktır.

  Kod örnekleri şu anda Java, JavaScript, PHP, Python ve curl için desteklenmektedir.

• Kod örnekleri aracı da yukarıda açıklanan özelliklerin tümünü sunan yeni bir kullanıcı arayüzüyle güncellendi. Bu aracı kullanarak farklı yöntemlerin kullanım alanlarını keşfedebilir, API Gezgini'ne değer yükleyebilir ve Java, JavaScript, PHP ve Python'da kod örnekleri almak için tam ekran API Gezgini'ni açabilirsiniz.

  Bu değişiklikle birlikte, daha önce Java, JavaScript, PHP ve Python için mevcut kod örneklerini listeleyen sayfalar kaldırıldı.

• Java, JavaScript, PHP ve Python için hızlı başlangıç kılavuzları güncellendi. Düzeltilen kılavuzlarda, API Gezgini'ndeki kod örnekleri kullanılarak bir örneğin API anahtarı ve OAuth 2.0 istemci kimliği ile başka bir örneğin nasıl çalıştırılacağı açıklanmaktadır.

Yukarıda açıklanan değişikliklerin, 2017'de API dokümanlarına eklenen etkileşimli bir aracın yerini aldığını unutmayın.

9 Temmuz 2018

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channel kaynağının snippet.thumbnails özelliğinin tanımı güncellendi. Bu güncellemeyle birlikte kodunuzun, uygulamanızda küçük resimleri gösterirken resim URL'lerini tam olarak API yanıtlarında döndürüldüğü şekilde kullanması gerektiğini belirtmek isteriz. Örneğin, uygulamanız, API yanıtında döndürülen bir URL'deki https alanı yerine http alan adını kullanmamalıdır.

  Temmuz 2018'den itibaren, kanal küçük resmi URL'leri yalnızca https alanında kullanılabilecek. URL'ler, API yanıtlarında bu şekilde görünecek. Bu süre sonunda, http alanından YouTube resimleri yüklemeye çalışırsa uygulamanızda bozuk resimler görebilirsiniz.

• Not: Bu, kullanımdan kaldırma duyurusudur.

  video kaynağının recordingDetails.location.altitude özelliği kullanımdan kaldırıldı. Videoların bu özellik için değer döndüreceğinin garantisi yoktur. Benzer şekilde, API istekleri söz konusu mülk için bir değer ayarlamaya çalışsa bile gelen veriler depolanmayabilir.

22 Haziran 2018

Önceki adıyla Uygulama Kılavuzu Uygulama ve Taşıma rehberi, v2 API'den v3 API'ye. Ayrıca, desteği sonlandırılmış olduğundan emin olun.

27 Kasım 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Not: Bu, kullanımdan kaldırma duyurusudur.

  YouTube, API'de channel kaynağının invideoPromotion nesnesi aracılığıyla desteklenen Öne Çıkan Video ve Öne Çıkan Web Sitesi özelliklerine yönelik desteği kaldırıyor. Sonuç olarak, tüm alt özellikleri dahil olmak üzere bu nesnenin desteği sonlandırılmıştır.

  14 Aralık 2017 tarihine kadar invideoPromotion verilerini almaya ve ayarlamaya devam edebilirsiniz. Bu tarihten sonra:

  • channels.list çağrılırken invideoPromotion bölümünü alma girişimleri, boş bir invideoPromotion döndürür veya hiçbir invideoPromotion verisi döndürmez.
  • channels.update çağrılırken invideoPromotion verilerini güncelleme girişimleri en az 27 Mayıs 2018 tarihine kadar başarılı bir yanıt döndürür, ancak işlem yok olarak kabul edilir, yani gerçekte güncelleme yapmazlar.

  27 Mayıs 2018'den sonra bu istekler, örneğin invalidPromotion öğesinin geçersiz bir parça olduğunu belirtmek için hata mesajları döndürebilir.

16 Kasım 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Etkileşimli kod snippet'i aracı artık Node.js kod örneklerini desteklemektedir. Örnekler, channels.list yöntemi gibi neredeyse tüm API yöntemlerinin dokümanlarında da görülebilir.

  Özelleştirilebilir örnekler, size bir Node.js uygulaması için kullanım durumuna özgü bir başlangıç noktası sunmak üzere tasarlanmıştır. İşlevler, Node.js hızlı başlangıç kılavuzundaki koda benzer. Ancak örnekler hızlı başlangıç kılavuzunda görünmeyen bazı yardımcı program işlevleri içerir:

  • removeEmptyParameters işlevi, API isteği parametrelerine karşılık gelen anahtar/değer çiftlerinin bir listesini alır ve değer içermeyen parametreleri kaldırır.
  • createResource işlevi, bir API kaynağındaki özelliklere karşılık gelen anahtar/değer çiftlerinin listesini alır. Daha sonra özellikleri insert ve update işlemlerinde kullanılabilecek bir JSON nesnesine dönüştürür. Aşağıdaki örnekte, bir dizi özellik adı ve değer ile kodun bunlar için oluşturacağı JSON nesnesi gösterilmektedir:

    # Key-value pairs:
    {'id': 'ABC123',
     'snippet.title': 'Resource title',
     'snippet.description': 'Resource description',
     'status.privacyStatus': 'private'}
    
    # JSON object:
    {
     'id': 'ABC123',
     'snippet': {
       'title': 'Resource title',
       'description': 'Resource description',
     },
     'status': {
       'privacyStatus': 'private'
     }
    }

    .

  Bu örneklerin tümü indirilip yerel olarak çalıştırılmak üzere tasarlanmıştır. Daha fazla bilgi için kod snippet'i aracı talimatlarındaki tam kod örneklerini yerel olarak çalıştırma ile ilgili ön koşulları inceleyin.

25 Ekim 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Etkileşimli kod snippet'i aracındaki Python kod örnekleri, kullanımdan kaldırılan oauth2client kitaplığı yerine google-auth ve google-auth-oauthlib kitaplıklarını kullanacak şekilde güncellendi.

  Bu değişikliğe ek olarak, araç artık biraz farklı yetkilendirme akışları kullanan yüklü Python uygulamaları ve Python web sunucusu uygulamaları için tam kod örnekleri sağlıyor. Örneklerin tamamını (ve bu değişikliği) görmek için:

  1. Etkileşimli kod snippet'i aracına veya channels.list yöntemi gibi herhangi bir API yönteminin dokümanlarına gidin.
  2. Kod örneklerinin üzerindeki Python sekmesini tıklayın.
  3. Snippet'ten tam örneğe geçiş yapmak için sekmelerin üzerindeki açma/kapatma düğmesini tıklayın.
     
  4. Sekmede artık InstalledAppFlow yetkilendirme akışını kullanan eksiksiz bir kod örneği gösterilir. Örneğin üzerindeki açıklamada bu durum açıklanmakta ve ayrıca bir web sunucusu uygulamasının örneğine bağlantı verilmektedir.
  5. Web sunucusu örneğine geçmek için bağlantıyı tıklayın. Bu örnek için Flask web uygulaması çerçevesi ve farklı bir yetkilendirme akışı kullanılmaktadır.

  Bu örneklerin tümü indirilip yerel olarak çalıştırılmak üzere tasarlanmıştır. Örnekleri çalıştırmak isterseniz kod snippet'i aracı talimatlarında tam kod örneklerini yerel olarak çalıştırma talimatlarına bakın.

29 Ağustos 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• search.list yönteminin forContentOwner parametresinin tanımı, parametrenin true olarak ayarlanması durumunda type parametresinin video olarak ayarlanması gerektiğini belirtecek şekilde güncellendi.
• search.list yönteminin regionCode parametresinin tanımı, parametrenin arama sonuçlarını belirtilen bölgede görüntülenebilen videolarla kısıtladığını netleştirmek için güncellendi.
• YouTube marka logolarını ve simgelerini güncelledi. Yeni "YouTube ile geliştirildi" Logoları markalama kuralları sayfasından indirebilirsiniz. Bu sayfada diğer yeni YouTube logoları ve simgeleri de gösterilir ve YouTube marka sitesinden indirilebilir.

24 Temmuz 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• iOS için yeni bir YouTube Data API hızlı başlangıç kılavuzu kullanıma sunuldu. Bu rehberde, Objective-C veya Swift ile yazılmış basit bir iOS uygulamasında YouTube Data API'nin nasıl kullanılacağı açıklanmaktadır.
• YouTube Veri API'sına yönelik etkileşimli kod snippet'i aracı artık bu aracın bazı özelliklerini açıklayan dokümanlar da içeriyor:
  • API isteklerini yürütme
  • Kod snippet'leri ve tam kod örnekleri arasında geçiş yapma
  • Ortak metin işlevlerini kullanma
  • Mevcut kaynakları yükleme (güncelleme yöntemleri için)

  Not: Araç, API yöntemleriyle ilgili API referans dokümanlarına da yerleştirilmiştir (örnek).

1 Haziran 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Not: Bu, kullanımdan kaldırma duyurusudur.

  Aşağıdaki video kaynak özelliklerinin desteği sonlandırılıyor. Özellikler 1 Aralık 2017'ye kadar desteklenecek olsa da bu tarihe kadar videoların bu tesisler için değer döndürmeye devam edeceğinin garantisi yoktur. Benzer şekilde, bu özellik değerlerini ayarlayan videos.insert ve videos.update istekleri, söz konusu tarihten önce hata oluşturmaz ancak gelen veriler depolanmayabilir.

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude

17 Mayıs 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• API referans belgeleri, kod snippet'lerini daha yaygın ve etkileşimli hale getirmek üzere güncellendi. channels.list veya videos.rate gibi API yöntemlerini açıklayan sayfalarda artık Java, JavaScript, PHP, Python, Ruby, Apps Komut Dosyası ve Go'daki kod snippet'lerini görüntüleyip özelleştirmenize olanak tanıyan etkileşimli bir araç bulunuyor.

  Belirli bir yöntem için araç, bir veya daha fazla kullanım alanı için kod snippet'leri gösterir ve her kullanım alanı, söz konusu yöntemi çağırmanın yaygın bir yöntemini açıklar. Örneğin, belirli bir kanal veya geçerli kullanıcının kanalı hakkındaki verileri almak için channels.list yöntemini çağırabilirsiniz.

  Ayrıca kod örnekleriyle etkileşimde bulunabilirsiniz:

  • Parametre ve özellik değerlerini değiştirdiğinizde, kod snippet'leri sağladığınız değerleri yansıtacak şekilde dinamik olarak güncellenir.

  • Kod snippet'leri ve tam örnekler arasında geçiş yapın. Kod snippet'i, kodun API yöntemini çağıran kısmını gösterir. Tam bir örnek, istekleri yetkilendirmek ve göndermek için kullanılan ortak kodun yanı sıra söz konusu snippet'i içerir. Tam örnekler, komut satırından veya yerel web sunucusundan kopyalanıp çalıştırılabilir.

  • Bir düğmeyi tıklayarak istekleri yürütün. (İstekleri yürütmek için aracı sizin adınıza API'yi çağıracak şekilde yetkilendirmeniz gerekir.)

  Bu aracın, kullanılabildiği sayfalarda API Gezgini'nin yerini aldığını unutmayın. (Her sayfada bir bağlantı görüntülenir. Böylece, üzerinde çalıştığınız isteği API Gezgini'nde de yükleyebilirsiniz.)

• Veri API'sı Kod Snippet'leri aracı da yukarıda açıklanan özelliklerin tümünü sunan yeni bir kullanıcı arayüzüyle güncellendi. Bu sayfada kullanılabilen başlıca yeni özellikler şunlardır:

  • Veri yazan API istekleri için destek.
  • Java örnekleri için destek.
  • Kullanıcıları yetkilendirmek ve API istekleri oluşturmak için daha esnek ve kapsamlı standart kod.

27 Nisan 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni hızlı başlangıç kılavuzlarında, YouTube Data API isteklerinde bulunan basit bir uygulamanın nasıl oluşturulacağı açıklanmaktadır. Şu anda Android, Apps Komut Dosyası, Go, Java, JavaScript, Node.js, PHP, Python ve Ruby için kılavuzlar mevcuttur.

30 Mart 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channel kaynağının yeni topicDetails.topicCategories[] özelliği, kanalın içeriğini açıklayan Wikipedia URL'lerinin listesini içerir. URL'ler, kaynağın topicDetails.topicIds[] özelliğinde döndürülen konu kimliklerine karşılık gelir.
• playlistItem kaynağının yeni contentDetails.videoPublishedAt özelliği, videonun YouTube'da yayınlandığı zamanı tanımlar. Kaynak zaten snippet.publishedAt özelliğini içeriyor. Bu özellik, öğenin oynatma listesine eklendiği zamanı tanımlar.
• channel kaynağı gibi video kaynağı da artık topicDetails.topicCategories[] özelliğini döndürüyor. Bu özellik, videonun içeriğini açıklayan Wikipedia URL'lerinin listesini içerir. video kaynakları için URL'ler, kaynağın topicDetails.relevantTopicIds[] özelliğinde döndürülen konu kimliklerine karşılık gelir.
• video kaynağının yeni contentDetails.contentRating.mpaatRating özelliği, Amerikan Sinema Filmleri Derneği'nin bir film fragmanına veya önizlemesine verdiği derecelendirmeyi tanımlar.

27 Şubat 2017

İlk olarak 11 Ağustos 2016'da duyurulduğu gibi YouTube, desteklenen konu kimlikleri listesini özel bir liste olarak değiştirdi. Desteklenen konu kimliklerinin tam listesi channel ve video kaynakları için topicDetails özelliklerinin yanı sıra search.list yönteminin topicId parametresine dahil edilir.

Seçilen listede bazı değişiklikler yapıldığını unutmayın:

• Aşağıdaki konular Society kategorisinin alt konuları olarak eklendi:

  Ad	konu kimliği
  İşletme	/m/09s1f
  Sağlık	/m/0kt51
  Askeriye	/m/01h6rj
  Politika	/m/05qt0
  Din	/m/06bvp

• Daha önce Entertainment konusunun alt öğesi olan Animated cartoon konusu kaldırıldı.
• Daha önce Music konusunun alt öğesi olan Children's music konusu kaldırıldı.

Bu değişikliğin sonucunda, bir videoyla ilgili konular artık her zaman video kaynağının topicDetails.relevantTopicIds[] özellik değerinde döndürülüyor.

29 Kasım 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Konu kimlikleri listesinde, 10 Şubat 2017 itibarıyla desteklenecek üç küçük değişiklik yapılacak:

  • Daha önce Sports kategorisinin alt öğesi olan Professional wrestling kategorisi, artık Entertainment kategorisinin alt öğesidir.
  • Entertainment alt öğesi olan TV shows kategorisi yenidir.
  • Daha önce Lifestyle adlı çocuğun alt öğesi olan Health kategorisi kaldırıldı.

  Ayrıca birkaç üst kategori olduğunu unutmayın (Entertainment, Gaming, Lifestyle, Music ve Sports). Tennis gibi bir alt kategoriyle ilişkilendirilen videolar da üst kategoriyle (Sports) ilişkilendirilir.

10 Kasım 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• 11 Ağustos 2016'da ilk kez duyurulduğu gibi, Freebase ve Freebase API'nin kullanımdan kaldırılması, konu kimlikleriyle ilgili bazı değişiklikler gerektirmektedir. Konu Kimlikleri, channel ve video kaynaklarıyla ilişkili konuları tanımlar. Belirli bir konuyla ilgili kanalları veya videoları bulmak için topicId arama parametresini de kullanabilirsiniz.

  10 Şubat 2017'de YouTube, şimdiye kadar döndürülen çok daha ayrıntılı kimlikler yerine küçük bir konu kimliği grubu döndürmeye başlayacak. Ayrıca, kanalların ve videoların mevcut API davranışıyla tutarlı olarak herhangi bir konuyla ilişkilendirilmesinin garanti edilmediğini unutmayın.

  API istemcilerinizi bu değişikliklere hazırlayabilmeniz için aşağıdaki API parametrelerinin ve özelliklerinin tanımları, bu tarihten sonra desteklenecek konu kimliklerinin listelendiği şekilde güncellendi. Kategori listesinin tüm tesisler için aynı olduğunu unutmayın.

  • channel kaynağının topicDetails.topicIds[] özelliği.
  • video kaynağının topicDetails.relevantTopicIds[] özelliği.
  • search.list yönteminin topicId parametresi.

• Not: Bu, kullanımdan kaldırma duyurusudur.

  Aşağıdaki özelliklerin desteği sonlandırılıyor:

  • channel kaynağının topicDetails.topicIds[] özelliği. Bu özellik 10 Kasım 2017'ye kadar desteklenecektir.
  • video kaynağının topicDetails.relevantTopicIds[] özelliği. Bu özellik 10 Kasım 2017'ye kadar desteklenecektir.
  • video kaynağının topicDetails.topicIds[] özelliği. Bu özellik, 10 Şubat 2017'den sonraki değerleri içermeyecektir. (Bu tarihten sonra topicDetails.relevantTopicIds[] özelliği değeri, videoyla ilişkilendirilmiş tüm konuları tanımlar.)

• Freebase'in desteği sonlandırıldığından, Freebase Topics ile Arama kılavuzu dokümanlardan kaldırıldı. Bu kılavuzda, bir uygulamanın Freebase API ile nasıl çalışacağını göstermek için kod örnekleri sağlanmıştır.

  Ayrıca konu kimlikleriyle ilgili çeşitli kod örnekleri de search.list yönteminin dokümanlarından kaldırıldı.

2 Kasım 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni mülkler ve parametreler

  • video kaynağı birkaç yeni özellik içeriyor:

    • player.embedHtml özelliği, videoyu oynatan bir oynatıcıyı yerleştirmek için kullanabileceğiniz bir <iframe> etiketi içerir. Yeni player.embedHeight ve player.embedWidth özellikleri, yerleşik oynatıcının boyutlarını tanımlar. Bu özellikler yalnızca API isteği, maxHeight veya maxWidth parametrelerinden en az biri için bir değer belirtirse döndürülür. Bu iki yeni parametre, bu düzeltme geçmişi girişinde daha sonra açıklanmaktadır.

    • Yeni hasCustomThumbnail özelliği, videoyu yükleyen kullanıcının video için özel bir küçük resim sağlayıp sağlamadığını gösterir. Bu özelliği yalnızca video yükleyicisi görebilir.

    • Yeni fpbRatingReasons[], videonun FPB (Güney Afrika) derecelendirmesini alma nedenlerini tanımlar.

    • Yeni mcstRating, videonun Vietnam'da aldığı derecelendirmeyi tanımlar.

  • videos.list yöntemi maxHeight ve maxWidth olmak üzere iki yeni parametreyi destekler. video kaynaklarında player bölümünü alırken iki parametreden birini veya her ikisini birden kullanabilirsiniz.

    Varsayılan olarak, player.embedHtml özelliğinde döndürülen <iframe> yüksekliği 360 pikseldir. Genişlik, videonun en boy oranıyla eşleşecek şekilde ayarlanır. Böylece, yerleştirilmiş oynatıcıda videoyu çerçeveleyen siyah çubuklar olmaz. Örneğin, bir videonun en boy oranı 16:9 ise oynatıcının genişliği 640 piksel olur.

    Yeni parametrelerle, varsayılan boyutlar yerine, yerleştirme kodunun uygulama düzeninize uygun bir yükseklik ve/veya genişliği kullanması gerektiğini belirtebilirsiniz. API sunucusu, yerleşik oynatıcıda videoyu çerçeveleyen siyah çubukların olmamasını sağlamak için oynatıcı boyutlarını uygun şekilde ölçeklendirir. Her iki parametrenin de yerleşik oynatıcının maksimum boyutlarını belirttiğini unutmayın. Dolayısıyla, her iki parametre de belirtilirse boyut, söz konusu boyut için izin verilen maksimum miktardan küçük olabilir.

    Örneğin, bir videonun en boy oranının 16:9 olduğunu varsayalım. Bu nedenle, maxHeight veya maxWidth parametresi ayarlanmamışsa player.embedHtml etiketi 640x360 boyutunda bir oynatıcı içerir.

    • maxHeight parametresi 720 olarak ayarlanıp maxWidth parametresi ayarlanmamışsa API 1280x720 boyutunda bir oynatıcı döndürür.
    • maxWidth parametresi 960 olarak ayarlanıp maxHeight parametresi ayarlanmamışsa API 960x540 boyutunda bir oynatıcı döndürür.
    • maxWidth parametresi 960 ve maxHeight parametresi 450 olarak ayarlanırsa API, 800x450 boyutunda bir oynatıcı döndürür.

    Yukarıda açıklanan yeni player.embedHeight ve player.embedWidth özellikleri, oynatıcının boyutlarını tanımlar.

• Mevcut yöntemler, özellikler ve parametrelerde yapılan güncellemeler

  • channelSection kaynak açıklaması, bir kanalın hedefleme verileri ayarlamadan en fazla 10 raf oluşturabileceğini ve hedefleme verileriyle en fazla 100 raf oluşturabileceğini belirtecek şekilde güncellendi.

    Ayrıca, channelSection kaynağının targeting özelliği, hedefleme seçeneklerinin yalnızca API kullanılarak ayarlanabileceğini yansıtacak şekilde güncellendi. Kanal bölümü, YouTube web sitesindeki kullanıcı arayüzü kullanılarak değiştirilirse hedefleme seçenekleri silinir.

  • i18nLanguage kaynağının snippet.name özelliğinin tanımı, değerin bir dilin adını i18nLanguage.list yönteminin hl parametresi tarafından belirtilen dilde yazıldığı şekilde temsil edecek şekilde düzeltildi.

  • playlistItem kaynağının contentDetails.note özelliği, özellik değerinin maksimum uzunluğunun 280 karakter olduğunu belirtecek şekilde güncellendi.

  • playlistItem kaynağının contentDetails.startAt ve contentDetails.endAt özellikleri kullanımdan kaldırıldı. Bu alanlar playlistItems.insert veya playlistItems.update isteklerinde ayarlanırsa yoksayılır.

  • playlistItems.delete ve playlistItems.update yöntemleri artık, diğer birçok yöntem için zaten desteklenen onBehalfOfContentOwner parametresini desteklemektedir. Bu yöntemi kullanan isteklerin de https://www.googleapis.com/auth/youtubepartner kapsamına erişim sağlayan bir jetonla yetkilendirilmesi gerekir.

  • search.list yönteminin publishedBefore ve publishedAfter parametreleri, parametre değerlerinin kapsayıcı olduğunu belirtmek için güncellendi. Örneğin publishedBefore parametresi ayarlanırsa API, belirtilen zamanda veya önce oluşturulan kaynakları döndürür.

  • video kaynağının contentDetails.contentRating.grfilmRating özelliği üç ek değeri destekler: grfilmK12, grfilmK15 ve grfilmK18.

  • videos.insert yöntemi açıklaması, yüklenen videolar için maksimum dosya boyutunun 64 GB'tan 128 GB'a yükseltildiğini belirtecek şekilde güncellendi.

• Yeni ve güncellenmiş hatalar

  • API aşağıdaki yeni hataları destekler:

    Hata türü	Hata ayrıntısı	Açıklama
    forbidden (403)	homeParameterDeprecated	activities.list yöntemi, kullanıcının ana sayfa etkinliği verilerinin bu API üzerinden kullanılamadığını belirtmek için bu hatayı döndürür. Yetkisiz bir istekte home parametresini true olarak ayarlarsanız bu hata oluşabilir.
    invalidValue (400)	invalidContentDetails	playlistItems.insert yöntemi, istekteki contentDetails nesnesinin geçersiz olduğunu belirtmek için bu hatayı döndürür. Bu hatanın nedeni, contentDetails.note alanının 280 karakterden uzun olmasıdır.
    forbidden (403)	watchHistoryNotAccessible	playlistItems.list yöntemi, isteğin "izleme geçmişi"ni almaya çalıştığını belirtmek için bu hatayı döndürür. ancak bunlar API kullanılarak alınamaz.
    forbidden (403)	watchLaterNotAccessible	playlistItems.list yöntemi, isteğin "daha sonra izle" özelliğini almaya çalıştığını belirtmek için bu hatayı döndürür. ancak bunlar API kullanılarak alınamaz.
    badRequest (400)	uploadLimitExceeded	videos.insert yöntemi, kanalın yükleyebileceği video sayısını aştığını belirtmek için bu hatayı döndürür.
    forbidden (403)	forbiddenEmbedSetting	videos.update yöntemi, API isteğinin video için geçersiz bir yerleştirme ayarı belirlemeye çalıştığını belirtmek üzere bu hatayı döndürür. Bazı kanalların, canlı yayınlar için yerleşik oynatıcı sunma iznine sahip olmayabileceğini unutmayın. Daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın.

  • Oynatma listesine kopya video eklerseniz playlistItems.insert yöntemi artık hata döndürmez. Bu hata, yinelenen videolara izin vermeyen ancak artık desteklenmeyen bazı oynatma listelerinde (ör. favori videolar) meydana geldi. Oynatma listelerinde genellikle yinelenen videolara izin verilir.

• Diğer güncellemeler

  • 15 Eylül 2016 için düzeltme geçmişi girişi, channel kaynağının contentDetails.relatedPlaylists.watchHistory ve contentDetails.relatedPlaylists.watchLater özelliklerinin bir yanıta dahil edildiğinde her zaman sırasıyla HL ve WL değerlerini içerdiğini netleştirmek için güncellendi. Ayrıca, bu özellikler yalnızca yetkili bir kullanıcı, kullanıcının kendi kanalı hakkında veri alıyorsa dahil edilir.

15 Eylül 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• 11 Ağustos 2016 tarihli düzeltme geçmişi güncellemesinde, desteklenen konu kimlikleri grubunun 10 Şubat 2017 itibarıyla değişeceği gerçeği de dahil olmak üzere, konu kimlikleriyle ilgili çeşitli değişiklikler ele alınmıştır. Desteklenecek konuların listesi 10 Kasım 2016'da yayınlanacaktır.

• Aşağıdaki değişiklikler artık geçerli. Bu değişikliklerle ilgili bildirim, 11 Ağustos 2016 tarihli düzeltme geçmişi güncellemesinde paylaşılmıştır:

  • activities.list yöntemi, home parametresi true olarak ayarlanmış şekilde çağrılırsa API yanıtı, oturumu kapalı olan YouTube kullanıcısının ana sayfada göreceği öğelere benzer öğeler içerir.

    Bu değişikliğin amacı, 11 Ağustos 2016 tarihli düzeltme geçmişi güncellemesinde açıklanan davranıştan daha iyi bir kullanıcı deneyimi sunmaktır. Bu güncellemede, home parametresini kullanan isteklerin boş liste döndüreceği belirtiliyordu.

  • channel kaynağının contentDetails.relatedPlaylists.watchHistory ve contentDetails.relatedPlaylists.watchLater özellikleri artık tüm kanallar için sırasıyla HL ve WL değerlerini içeriyor.

    Daha net bir ifadeyle, bu özellikler yalnızca kullanıcının kendi kanalı hakkında veri alan yetkili bir kullanıcı tarafından görülebilir. Yetkili bir kullanıcı, kullanıcının kendi kanalı hakkında veri alırken bile özellikler her zaman HL ve WL değerlerini içerir. Bu nedenle, izleme geçmişi ve daha sonra izle oynatma listesi kimlikleri API aracılığıyla alınamaz.

    Ayrıca, kanalın izleme geçmişi veya daha sonra izle oynatma listesi için oynatma listesi ayrıntılarını (playlists.list) veya oynatma listesi öğelerini (playlistItems.list) alma istekleri artık boş listeler döndürüyor. Bu davranış HL ve WL yeni değerlerinin yanı sıra API istemcinizin önceden depolamış olabileceği tüm izleme geçmişi veya "daha sonra izle" oynatma listesi kimlikleri için de geçerlidir.

• video kaynağının fileDetails.recordingLocation nesnesi ve alt özellikleri artık döndürülmüyor. Daha önce bu veriler (ör. üst fileDetails nesnesi) yalnızca video sahibi tarafından alınabiliyordu.

11 Ağustos 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• YouTube Mühendislik ve Geliştiriciler Blogu'nda ayrıntılı olarak ele alınan, yeni yayınlanan YouTube API Hizmetleri Hizmet Şartları ("Güncellenen Şartlar"), mevcut Hizmet Şartları'nda kapsamlı güncellemeler sağlar. Bu güncelleme, 10 Şubat 2017'de yürürlüğe girecek Güncellenen Şartlar'a ek olarak, geliştiricilerin uyması gereken politikaların açıklanmasına yardımcı olacak birkaç destekleyici belge içerir.

  Yeni dokümanların tamamı Güncellenen Şartlar'ın düzeltme geçmişinde açıklanmaktadır. Ayrıca, Güncellenen Şartlar'da veya bu destekleyici belgelerde gelecekte yapılacak değişiklikler de söz konusu düzeltme geçmişinde açıklanacaktır. Söz konusu dokümandaki bir bağlantıdan, düzeltme geçmişinde yapılan değişiklikleri içeren bir RSS özet akışına abone olabilirsiniz.

• Freebase ve Freebase API'nin kullanımdan kaldırılması, konu kimlikleriyle ilgili çeşitli değişikliklere neden oluyor. Konu kimlikleri, aşağıdaki API kaynaklarında ve yöntemlerinde kullanılır:

  • channel kaynağının topicDetails bölümü, kanalla ilişkili konuları tanımlar.
  • video kaynağının topicDetails bölümü, videoyla ilişkili konuları tanımlar.
  • search.list yönteminin topicId parametresi, belirli bir konuyla ilgili videoları veya kanalları aramanızı sağlar.

  Bu özelliklerde yapılan değişiklikler şunlardır:

  • 10 Şubat 2017'den itibaren YouTube, şimdiye kadar döndürülen çok daha ayrıntılı kimlikler yerine küçük bir konu kimliği grubu döndürmeye başlayacak. Desteklenen bu konular grubu, Spor veya Basketbol gibi üst düzey kategorileri tanımlar, ancak örneğin, belirli takımları veya oyuncuları tanımlamaz. Başvurunuzu bu değişikliğe hazırlamak için zamanınız olması amacıyla, desteklenen konular listesini duyuracağız.

  • Önceden almış olduğunuz Freebase konu kimlikleri, 10 Şubat 2017 tarihine kadar içerik aramak için kullanılabilir. Ancak bu süre geçtikten sonra, arama sonuçlarını konuya göre almak için yalnızca önceki öğede tanımlanan daha küçük konu grubunu kullanabilirsiniz.

  • 10 Şubat 2017'den sonra, desteklenen daha küçük konu kimlikleri grubunda olmayan bir konu kimliği kullanarak sonuçları aramaya çalışırsanız API, boş bir sonuç kümesi döndürür.

• Bazı API alanları ve parametreleri, 12 Eylül 2016'dan itibaren geçerli olmak üzere kullanımdan kaldırılacaktır:

  • activities.list yönteminin home parametresi, yetkili bir kullanıcının YouTube ana sayfasında görüntülenecek etkinlik feed'ini alabilmesini sağladı. 12 Eylül 2016'dan sonra bu parametreyi kullanan istekler boş liste döndürür.

  • channel kaynağının contentDetails.relatedPlaylists.watchHistory ve contentDetails.relatedPlaylists.watchLater özellikleri yalnızca kullanıcının kendi kanalı hakkında veri alan yetkili bir kullanıcı tarafından görülebilir. 12 Eylül 2016'dan sonra contentDetails.relatedPlaylists.watchHistory, HL değerini, contentDetails.relatedPlaylists.watchLater özelliği ise tüm kanallar için WL değerini döndürür.

    Kanalın izleme geçmişi veya daha sonra izle oynatma listesi için oynatma listesi ayrıntılarını (playlists.list) alma istekleri, 12 Eylül 2016'dan sonra boş liste döndürecek. Bu oynatma listelerinden herhangi birindeki oynatma listesi öğelerini (playlistItems.list) alma istekleri de bu süre dolduktan sonra boş bir liste döndürür. Bu durum HL ve WL yeni değerlerinin yanı sıra API istemcinizin önceden depolamış olabileceği tüm izleme geçmişi veya "daha sonra izle" oynatma listesi kimlikleri için de geçerlidir.

  • video kaynağının fileDetails.recordingLocation nesnesi veya alt mülklerinden herhangi biri, 12 Eylül 2016'dan sonra artık döndürülmeyecek. Üst fileDetails nesnesi yalnızca video sahibi tarafından alınabildiğinden bu veriler yalnızca video sahibi tarafından alınabilir.

13 Haziran 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channel kaynağının contentDetails.googlePlusUserId özelliği kullanımdan kaldırıldı. Önceden, bu özellik yalnızca kanal bir Google+ profiliyle ilişkilendirilmişse mevcuttu. Kullanımdan kaldırma işleminin ardından mülk artık hiçbir channel kaynağına dahil edilmeyecek.

• comment kaynağının snippet.authorGoogleplusProfileUrl özelliği kullanımdan kaldırıldı. Önceden, bu özellik yalnızca kanal bir Google+ profiliyle ilişkilendirilmişse mevcuttu. Kullanımdan kaldırma işleminin ardından mülk artık hiçbir comment kaynağına dahil edilmeyecek.

Desteğin sonlandırılmasının ardından bu mülklerin ikisi de döndürülmeyeceğinden, her iki mülk de ilgili kaynak belgelerinden kaldırılmıştır.

31 Mayıs 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• subscriptions.list yönteminin yeni myRecentSubscribers parametresi, kimliği doğrulanmış kullanıcının kanalının abonelerinin listesini, kanala abone oldukları zamanın ters kronolojik sırasına göre alır.

  Yeni parametrenin yalnızca kimliği doğrulanmış kullanıcının kanalındaki en son 1.000 abonenin alınmasını desteklediğini unutmayın. Abonelerin tam listesini almak için mySubscribers parametresini kullanın. Aboneleri belirli bir sırada döndürmeyen bu parametre, alınabilecek abone sayısını sınırlamaz.

• snippet.thumbnails.(key) özelliğinin tanımı; etkinlik, playlistItem, playlist, arama sonucu, thumbnail ve video kaynakları için güncellendi. Bu güncellemeyle birlikte bazı videolarda ek küçük resim boyutları kullanılabilir.

  • standard görseli 640 piksel genişliğinde ve 480 piksel yüksekliğinde.
  • maxres görseli 1.280 piksel genişliğinde ve 720 piksel yüksekliğinde.

• channelSection.list yönteminin part parametresinin tanımı, targeting bölümünün 2 kota birimi karşılığında alınabileceğini belirtecek şekilde güncellendi.

• Uygun şekilde yetkilendirilmemiş bir istek, bir video kaynağının fileDetails, processingDetails veya suggestions parçalarını almaya çalıştığında videos.list yöntemi artık yasak (403) hatası döndürüyor. Bu bölümler yalnızca videonun sahibi tarafından kullanılabilir.

17 Mayıs 2016

Yeni Veri API'sı Kod Snippet'leri aracı, YouTube Data API'nin yaygın kullanım alanları için kısa kod snippet'leri sağlar. Kod snippet'leri şu anda Apps Komut Dosyası, Go, JavaScript, PHP, Python ve Ruby'deki tüm salt okunur API yöntemleri için kullanılabilir.

Her yöntem için araç, bir veya daha fazla kullanım alanına yönelik kod örnekleri gösterir. Örneğin, search.list yöntemi için beş kod snippet'i sağlar:

• Videoları anahtar kelimeye göre listeleyin
• Videoları konuma göre listeleme
• Canlı etkinlikleri listeleyin
• Kimliği doğrulanan kullanıcının videolarını ara
• İlgili videoları listeleyin

Araç, her kullanım alanı için API isteğinde kullanılan parametreleri gösterir. Parametre değerlerini değiştirebilirsiniz. Bu durumda araç, kod snippet'lerini sağladığınız parametre değerlerini yansıtacak şekilde günceller.

Son olarak, araç her isteğe verilen API yanıtını görüntüler. İstek parametrelerini değiştirdiyseniz API yanıtı, sağladığınız parametre değerlerini temel alır. API yanıtlarının gösterilmesi için aracı sizin adınıza istek göndermek üzere yetkilendirmeniz gerektiğini unutmayın.

28 Nisan 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• video kaynağının yeni contentDetails.projection özelliği, videonun projeksiyon biçimini belirtir. Geçerli özellik değerleri: 360 ve rectangular.

• video kaynağının recordingDetails.location ve fileDetails.recordingLocation özellikleri, iki mülk arasındaki farkı açıklayacak şekilde güncellendi:

  • recordingDetails.location özelliği, video sahibinin videoyla ilişkilendirmek istediği konumu tanımlar. Bu konum, herkese açık videolarda düzenlenebilir, aranabilir ve herkese açık videolarda kullanıcılara gösterilebilir.
  • fileDetails.recordingLocation özelliğinin değeri sabittir ve yüklenen orijinal video dosyasıyla ilişkili konumu temsil eder. Değer, yalnızca video sahibi tarafından görülebilir.

• channel kaynağının contentDetails.relatedPlaylists.favorites özelliğinin tanımı, özellik değerinin boş bir oynatma listesine işaret eden ve getirilemeyen bir oynatma listesi kimliği içerebileceğini belirtecek şekilde güncellendi. Bunun nedeni, favori videolar işlevinin desteğinin sonlandırılmış olmasıdır. Bu mülkün, API kullanımdan kaldırma politikasına tabi olmadığını unutmayın.

• comments.insert, comments.update, commentThreads.insert veya commentThreads.update yöntemiyle döndürülebilen ineligibleAccount hatasının tanımı; API isteğini yetkilendirmek için kullanılan YouTube hesabı, kullanıcının Google Hesabı ile birleştirilmediğinde hatanın ortaya çıkacağını yansıtacak şekilde güncellendi.

20 Nisan 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channels.update yönteminin part parametresinin tanımı, localizations parametresinin de bu parametre için geçerli bir değer olduğunu belirtecek şekilde güncellendi.

• Başlangıç kılavuzunun Kota Kullanımı bölümü, gerçek kota ve kota kullanımınızı görebileceğiniz Google Developer Console'a bağlanacak şekilde güncellendi.

16 Mart 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Mevcut kaynak ve yöntemlerde yapılan güncellemeler

  • channelBanner kaynak dokümanları, yüklenen kanal banner resmi için önerilen boyutun 2560 x 1440 piksel olduğu belirtilecek şekilde güncellendi. Minimum boyut (2048 piksel x 1152 piksel) değişmedi.

  • channel kaynağının yeni snippet.customUrl özelliği, kanalla ilişkili özel URL'yi tanımlar. (Tüm kanalların özel URL'leri yoktur.) YouTube Yardım Merkezi'nde, özel URL almayla ilgili uygunluk koşulları ve URL'nin nasıl ayarlanacağı açıklanmaktadır.

  • channel kaynağının brandingSettings.watch nesnesi ve tüm alt özellikleri kullanımdan kaldırıldı.

  • search.list isteğine verilen API yanıtı artık regionCode özelliği içeriyor. Bu özellik, arama sorgusu için kullanılan bölge kodunu tanımlar. Bölge kodu, API'ye belirtilen ülke için arama sonuçları döndürmesi talimatını verir.

    Özellik değeri, bölgeyi tanımlayan iki harfli ISO ülke kodudur. i18nRegions.list yöntemi, desteklenen bölgelerin listesini döndürür. Varsayılan değer US değeridir. Desteklenmeyen bir bölge belirtilirse YouTube, sorguyu işlemek için varsayılan değer yerine başka bir bölge seçebilir.

  • videoAbuseReportReason kaynağının snippet.label ve snippet.secondaryReasons[].label özelliklerinin tanımları, mülklerin kötüye kullanım raporuna ilişkin nedenlerle yerelleştirilmiş etiket metni içerdiğini belirtecek şekilde güncellendi.

    Ayrıca, videoAbuseReportReasons.list yöntemi artık API yanıtında etiket metni için kullanılması gereken dili belirten hl parametresini desteklemektedir. Varsayılan parametre değeri: en_US.

  • video kaynağının yeni contentDetails.contentRating.ecbmctRating özelliği, Türkiye Kültür ve Turizm Bakanlığı Değerlendirme ve Sınıflandırma Kurulu'ndan alınan bir videonun derecelendirmesini belirtir.

    Ayrıca, diğer derecelendirme sistemlerinin API mülkleri aşağıdaki yeni özellik değerlerini destekler:

    • contentDetails.contentRating.fpbRating (Güney Afrika)
      Derecelendirme: 10; özellik değeri: fpb10
    • contentDetails.contentRating.moctwRating (Tayvan)
      Derecelendirme: R-12; özellik değeri: moctwR12
    • contentDetails.contentRating.moctwRating (Tayvan)
      Derecelendirme: R-15; özellik değeri: moctwR15

  • video kaynağının liveStreamingDetails.activeLiveChatId mülkü, videoyla ilişkilendirilmiş etkin canlı sohbetin kimliğini içerir. Özellik değeri yalnızca video, canlı sohbetin etkin olduğu güncel bir canlı yayınsa mevcuttur. Yayın ve canlı sohbet sona erdikten sonra, mülk artık video için döndürülmez.

  • video kaynağının status.rejectionReason özelliği, legal yeni özellik değerini destekler.

• API aşağıdaki yeni hataları destekler:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest (400)	notEditable	channelSections.insert, channelSections.update ve channelSections.delete yöntemleri, belirtilen kanal bölümünün oluşturulamayacağını, güncellenemeyeceğini veya silinemeyeceğini belirtmek için bu hatayı döndürür.
  badRequest (400)	styleRequired	channelSections.insert ve channelSections.update yöntemleri, API isteğinde gönderilen channelSection kaynağının snippet.style özelliği için bir değer belirtmesi gerektiğini belirtmek üzere bu hatayı döndürür.
  badRequest (400)	typeRequired	channelSections.insert ve channelSections.update yöntemleri, API isteğinde gönderilen channelSection kaynağının snippet.type özelliği için bir değer belirtmesi gerektiğini belirtmek üzere bu hatayı döndürür.
  badRequest (400)	processingFailure	commentThreads.list yöntemi, API sunucusunun isteği başarılı bir şekilde işleyemediğini belirtmek için bu hatayı döndürür. Bu geçici bir hata olsa da genellikle istek girişinin geçersiz olduğunu gösterir. Geçerli olduğundan emin olmak için istek gövdesindeki commentThread kaynağının yapısını kontrol edin.
  forbidden (403)	commentsDisabled	commentThreads.list yöntemi, videoId parametresiyle tanımlanan videoda yorumların devre dışı bırakıldığını belirtmek için bu hatayı döndürür.
  badRequest (400)	commentTextTooLong	commentThreads.insert yöntemi, eklenen comment kaynağının snippet.topLevelComment.snippet.textOriginal özelliğinde çok fazla karakter içerdiğini belirtmek için bu hatayı döndürür.
  invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	playlistItems.insert yöntemi, oynatma listesine eklemeye çalıştığınız videonun zaten başka bir dizi oynatma listesinde olduğunu belirtmek için bu hatayı döndürür. Dizi oynatma listeleri hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın.
  badRequest (400)	subscriptionForbidden	subscriptions.insert yöntemi, maksimum abonelik sayısına ulaştığınızı veya son zamanlarda çok fazla sayıda abonelik oluşturduğunuzu belirtmek için bu hatayı döndürür. İkinci durumda, birkaç saat sonra isteği yeniden deneyebilirsiniz.
  badRequest (400)	invalidCategoryId	videos.update yöntemi, yüklenen video kaynağındaki snippet.categoryId özelliğinin geçersiz bir kategori kimliği belirttiğini belirtmek için bu hatayı döndürür. Desteklenen kategorileri almak için videoCategories.list yöntemini kullanın.
  badRequest (400)	invalidDescription	videos.update yöntemi, yüklenen video kaynağındaki snippet.description özelliğinin geçersiz bir değer belirttiğini belirtmek için bu hatayı döndürür.
  badRequest (400)	invalidPublishAt	videos.update yöntemi, yüklenen video kaynağındaki status.publishAt özelliğinin geçersiz bir zamanlanmış yayınlama zamanı belirttiğini belirtmek için bu hatayı döndürür.
  badRequest (400)	invalidRecordingDetails	videos.update yöntemi, yüklenen video kaynağındaki recordingDetails nesnesinin geçersiz kayıt ayrıntılarını belirttiğini belirtmek için bu hatayı döndürür.
  badRequest (400)	invalidTags	videos.update yöntemi, yüklenen video kaynağındaki snippet.tags özelliğinin geçersiz bir değer belirttiğini belirtmek için bu hatayı döndürür.
  badRequest (400)	invalidTitle	videos.update yöntemi, yüklenen video kaynağındaki snippet.title özelliğinin geçersiz veya boş bir video başlığı belirttiğini belirtmek için bu hatayı döndürür.
  badRequest (400)	invalidVideoMetadata	videos.update yöntemi, istek meta verilerinin geçersiz olduğunu belirtmek için bu hatayı döndürür. Bu hata, istek bir video kaynağının snippet bölümünü güncellerse ancak hem snippet.title hem de snippet.categoryId özellikleri için bir değer ayarlamazsa oluşur.

18 Aralık 2015

Avrupa Birliği (AB) yasaları uyarınca, AB'deki son kullanıcılara belirli açıklamalar yapılması ve bu kullanıcılardan izin alınması zorunludur. Bu nedenle, Avrupa Birliği'ndeki son kullanıcılar için AB Kullanıcı Rızası Politikası'na uymanız gerekir. Bu şartla ilgili bir bildirimi YouTube API Hizmet Şartlarımıza ekledik.

19 Kasım 2015

API artık playlist ve video kaynaklarının snippet.title ve snippet.description özellikleri, channelSection kaynağının snippet.title özelliği ve channel kaynağının snippet.description özelliği için yerelleştirilmiş metinleri ayarlama ve alma özelliğini destekliyor.

• Yerelleştirilmiş başlıklar ve açıklamalar oluşturma

  Bir kaynak için insert veya update yöntemini çağırırken söz konusu kaynağın yerelleştirilmiş değerlerini ayarlayabilirsiniz. Bir kaynağın yerelleştirilmiş değerlerini ayarlamak için aşağıdakilerin ikisini de yapın:

  • Kaynağın snippet.defaultLanguage özelliği için bir değer ayarlandığından emin olun. Bu özellik, kaynağın snippet.title ve snippet.description özelliklerinin dilini tanımlar. Değeri, desteklenen herhangi bir uygulama dili veya diğer ISO 639-1:2002 dil kodlarının çoğu olabilir. Örneğin, başlığı ve açıklaması İngilizce olan bir video yüklerseniz snippet.defaultLanguage özelliğini en olarak ayarlarsınız.

    channel kaynaklarını güncelleme not: channel kaynağı için snippet.defaultLanguage özelliğini ayarlamak amacıyla brandingSettings.channel.defaultLanguage özelliğini güncellemeniz gerekir.

  • localizations nesnesini, güncellediğiniz kaynağa ekleyin. Her nesne anahtarı, bir uygulama dilini veya ISO 639-1:2002 dil kodunu tanımlayan bir dizedir ve her anahtar, kaynağın yerelleştirilmiş başlığını (ve açıklamasını) içeren bir nesneyle eşlenir.

    Aşağıdaki örnek snippet, kaynağın varsayılan dilini İngilizce olarak ayarlar. Ayrıca videolara yerelleştirilmiş Almanca ve İspanyolca başlıklar ile açıklamalar da ekler:

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        ...
      },
      "localizations":
        "de": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        },
        "es": {
          "title": "Jugar al fútbol",
          "description": "Nosotros jugamos fútbol en el parque los domingos",
        }
      }
    }

  Önemli: Bir kaynağın yerelleştirilmiş verilerini güncellediğinizde, API isteğinizin verilerin mevcut tüm yerelleştirilmiş sürümlerini içermesi gerektiğini unutmayın. Örneğin, yukarıdaki örnekte videoya Portekizce verileri eklemeyle ilgili daha sonra bir istek gönderdiyseniz isteğin Almanca, İspanyolca ve Portekizce için yerelleştirilmiş verileri içermesi gerekir.

• Yerelleştirilmiş değerler alma

  API, bir kaynağın yerelleştirilmiş değerlerini almak için iki yöntemi destekler:

  • YouTube web sitesinin desteklediği belirli bir uygulama dili ile ilgili yerelleştirilmiş verileri almak için channels.list, channelSections.list, playlists.list veya videos.list isteğinize hl parametresini ekleyin. Söz konusu dilde yerelleştirilmiş kaynak ayrıntıları varsa kaynağın snippet.localized nesnesi, yerelleştirilmiş değerleri içerir. Ancak yerelleştirilmiş ayrıntılar mevcut değilse snippet.localized nesnesi, kaynağın varsayılan dilindeki kaynak ayrıntılarını içerir.

    Örneğin, bir videos.list isteğinin yukarıda açıklanan video için yerelleştirilmiş Almanca ve İspanyolca verilerle ilgili verileri aldığını varsayalım. hl parametresi de değerine ayarlanırsa kaynak aşağıdaki verileri içerir:

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        "localized": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        }
        ...
      }
    }

    Bununla birlikte, hl parametresi fr olarak ayarlandıysa, kaynağın varsayılan dili İngilizce olduğundan ve yerelleştirilmiş Fransızca ayrıntılar mevcut olmadığından snippet.localized nesnesi İngilizce başlığı ve açıklamayı içerir.

    Önemli: hl parametresi yalnızca YouTube web sitesinin desteklediği uygulama dillerini tanımlayan değerleri destekler. Yerelleştirilmiş metnin diğer dillerde kullanılıp kullanılamadığını öğrenmek için kaynağın localizations bölümünü alarak yerelleştirilmiş metnin mevcut olup olmadığını belirlemeniz gerekir.
    
    Örneğin, yerelleştirilmiş metnin Apalaş İngilizcesi kullanılıp kullanılamadığını öğrenmek için yerelleştirmelerin tam listesini almanız gerekir.
    
    

  • Bir kaynak alırken söz konusu kaynağın tüm yerelleştirilmiş ayrıntılarını almak için part parametre değerine localizations ekleyin. Geçerli YouTube uygulama dili olmayan bir dil için yerelleştirilmiş veri alıyorsanız tüm yerelleştirmeleri almak için bu yaklaşımı kullanmanız, ardından istenen yerelleştirilmiş verilerin mevcut olup olmadığını belirlemek için filtreleme yapmanız gerekir.

• Yerelleştirilmiş metin değerleriyle ilgili hatalar

  API, yerelleştirilmiş metin değerleri için aşağıdaki yeni hataları da destekler:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest (400)	defaultLanguageNotSetError	Bu hata, bir kaynak için localizations nesnesini eklemeye veya güncellemeye çalışan isteğin, söz konusu kaynak için snippet.defaultLanguage özelliği ayarlanmadığından başarısız olduğunu belirtir. channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert ve videos.update yöntemleri bu hatayı destekler.
  badRequest (400)	localizationValidationError	Bu hata, kaynağın localizations nesnesindeki değerlerden birinin doğrulanamadığını gösterir. Örneğin, nesne geçersiz bir dil kodu içeriyorsa bu hata oluşabilir. channels.update, channelSections.insert, channelSections.update, playlists.insert ve playlists.update yöntemleri bu hatayı destekler.

4 Kasım 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Mevcut kaynak ve yöntemlerde yapılan güncellemeler

  • search.list yönteminin order parametresi, canlı yayınları viewCount ölçütüne göre sıralarsanız API sonuçlarının yayınlarına göre sıralanacağını belirtmek için güncellendi. Yayınlar devam ederken eşzamanlı izleyici sayısı

  • search.list yönteminin relatedToVideoId parametresi, parametre ayarlanırsa desteklenen diğer parametrelerin yalnızca part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (video olarak ayarlanması gerekir) ve fields olduğunu belirtecek şekilde güncellendi. Bu güncelleme, API davranışında bir değişikliğe işaret etmez.

  • video kaynağının snippet.publishedAt özelliğinin tanımı, videonun yayınlandığı tarih ve saati belirten özellik değerinin videonun yüklendiği zamandan farklı olabileceğini belirtecek şekilde güncellendi. Örneğin, bir video özel video olarak yüklenir ve daha sonra herkese açık hale getirilirse özellik değeri, videonun herkese açık hale getirildiği zamanı belirtir. Güncellenen tanımda, gizli ve liste dışı videolar için değerin nasıl doldurulduğu da açıklanmaktadır.

    Bu değişiklik, API davranışında bir değişikliğe işaret etmez.

  • video kaynağının status.publishAt özelliğinin tanımı şu şekilde güncellendi:

    • videos.update yöntemini çağırırken bu özelliğin değerini ayarlarsanız video zaten özel olsa bile status.privacyStatus özellik değerini de private olarak ayarlamanız gerekir.
    • İstek, geçmişteki bir zamanda bir videonun yayınlanmasını planlarsa video hemen yayınlanır. Dolayısıyla, status.publishAt özelliğini geçmiş bir tarihe ve saate ayarlamanın etkisi, videonun privacyStatus özelliğinin private yerine public olarak değiştirilmesiyle aynıdır.

  • video kaynağının contentDetails.contentRating.cncRating özelliği, videonun Fransa'nın sınıflandırma sinematografiği Komisyonundan aldığı derecelendirmeyi belirtir. Bu mülk, kullanımdan kaldırılan contentDetails.contentRating.fmocRating özelliğinin yerini almaktadır.

  • channel kaynağının brandingSettings.channel.keywords tanımı, daha önce açıklandığı gibi özellik değerinin virgülle ayrılmış bir liste değil, boşlukla ayrılmış bir dize listesi içerdiğini doğru şekilde yansıtacak şekilde güncellendi. Bu güncelleme, API davranışında bir değişikliğe işaret etmez.

  • thumbnails.set yöntemiyle ilgili dokümanlar, istek gövdesinin yüklediğiniz ve videoyla ilişkilendirdiğiniz küçük resmi içerdiğini doğru bir şekilde yansıtacak şekilde güncellendi. İsteğin gövdesi thumbnail kaynağı içermiyor. Daha önce dokümanlarda, bu yöntemi çağırırken bir istek gövdesi sağlamamanız gerektiği belirtiliyordu. Bu güncelleme, API davranışında bir değişikliğe işaret etmez.

  • activity kaynağının açıklaması, activities.list yönteminin şu anda yeni video yorumlarıyla ilgili kaynakları içermediğini yansıtacak şekilde güncellendi. Kaynağın snippet.type ve contentDetails.comment değerleri de güncellendi.

• Yeni ve güncellenmiş hatalar

  • API artık aşağıdaki hataları desteklemektedir:

    Hata ayrıntıları
    activities.insert	HTTP Yanıt Kodu badRequest (400) Neden invalidMetadata Açıklama kind özelliği, sağlanan kimlik türüyle eşleşmiyor.
    commentThreads.update comments.insert comments.update	HTTP Yanıt Kodu badRequest (400) Neden commentTextTooLong Açıklama Eklenen veya güncellenen comment kaynağı, snippet.topLevelComment.snippet.textOriginal özelliğinde çok fazla karakter içeriyor.
    playlistItems.insert playlistItems.update	HTTP Yanıt Kodu forbidden (403) Neden playlistItemsNotAccessible Açıklama İstek, belirtilen oynatma listesi öğesini ekleme, güncelleme veya silme konusunda gerektiği gibi yetkilendirilmemiş.
    playlists.delete playlists.insert playlists.update	HTTP Yanıt Kodu badRequest (400) Neden playlistForbidden Açıklama Bu işlem yasaklanmıştır veya istek düzgün şekilde yetkilendirilmemiştir.
    search.list	HTTP Yanıt Kodu badRequest (400) Neden invalidLocation Açıklama location ve/veya locationRadius parametre değeri yanlış biçimlendirilmiş.
    search.list	HTTP Yanıt Kodu badRequest (400) Neden invalidRelevanceLanguage Açıklama relevanceLanguage parametre değeri yanlış biçimlendirilmiş.
    subscriptions.insert	HTTP Yanıt Kodu badRequest (400) Neden subscriptionForbidden Açıklama Bu hata, aşağıdakilerden herhangi biri doğru olduğunda ortaya çıkar: Oluşturmaya çalıştığınız abonelik zaten mevcut Maksimum abonelik sayınıza zaten ulaştınız Kendi kanalınıza abone olmaya çalışıyorsunuz, bu desteklenmiyor. Yakın zamanda çok fazla abonelik oluşturdunuz ve isteği tekrar denemeden önce birkaç saat beklemeniz gerekiyor.
    videos.update	HTTP Yanıt Kodu badRequest (400) Neden invalidDefaultBroadcastPrivacySetting Açıklama İstek, varsayılan yayın için geçersiz bir gizlilik ayarı belirlemeye çalışıyor.

28 Ağustos 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Mevcut kaynak ve yöntemlerde yapılan güncellemeler

  • video kaynağının statistics.favoriteCount özelliği kullanımdan kaldırıldı.

    Kullanımdan kaldırma politikamız uyarınca, bu mülk bu duyurunun ardından en az bir yıl boyunca video kaynakları arasında yer almaya devam edecektir. Ancak özellik değeri artık her zaman 0 olarak ayarlanıyor.

7 Ağustos 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Mevcut kaynak ve yöntemlerde yapılan güncellemeler

  • video kaynağının snippet.tags[] özelliğinin tanımı, API sunucusunun tesis değerinin uzunluğunu nasıl hesapladığı hakkında daha fazla bilgi sağlamak için güncellendi. Bu güncellemenin, API'nin davranışında bir değişikliğe işaret etmediğini unutmayın.

    Özellikle tanımda, bir etiket boşluk içeriyorsa API sunucusunun etiket değerini tırnak işaretleri içindeymiş gibi işlediği ve tırnak işaretlerinin karakter sınırına dahil edildiği anlamına gelir. Dolayısıyla, karakter sınırlamaları açısından, Foo-Baz etiketi yedi karakter içerirken Foo Baz etiketi dokuz karakter içerir.

  • commentThreads.insert yöntemi artık shareOnGooglePlus parametresini desteklememektedir. Bu parametre daha önce, bir yorumun ve bu yoruma verilen yanıtların yazarın Google+ profilinde de yayınlanması gerekip gerekmediğini belirtir. Parametre bir istek tarafından gönderilirse API sunucusu parametreyi yoksayar ancak isteği işler.

18 Haziran 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Mevcut kaynak ve yöntemlerde yapılan güncellemeler

  • commentThreads.list yönteminin yeni order parametresi, API yanıtının yorum ileti dizilerini listelemesi gereken sırayı belirtir. İleti dizileri zamana veya alaka düzeyine göre sıralanabilir. Varsayılan davranış, görevleri zamana göre sıralamaktır.

  • video kaynağının yeni snippet.defaultAudioLanguage özelliği, videonun varsayılan ses parçasında konuşulan dili belirtir.

  • video kaynağının contentDetails.licensedContent mülkünün tanımı, içeriğin ilk olarak bir YouTube içerik iş ortağına bağlı kanala yüklenmiş ve daha sonra bu iş ortağı tarafından hak talebinde bulunulmuş olması gerektiğini netleştirecek şekilde güncellendi. Bu durum, gerçek API davranışında bir değişiklik anlamına gelmez.

  • captions.delete, captions.download, captions.insert, captions.list ve captions.update yöntemleri artık onBehalfOfContentOwner parametresini desteklemektedir. Bu parametre, diğer birçok yöntem için zaten desteklenmektedir. Bu yöntemi kullanan isteklerin de https://www.googleapis.com/auth/youtubepartner kapsamına erişim sağlayan bir jetonla yetkilendirilmesi gerekir.

• Yeni ve güncellenmiş hatalar

  • API artık aşağıdaki hataları desteklemektedir:

    Hata ayrıntıları
    videos.rate	HTTP Yanıt Kodu badRequest (400) Neden emailNotVerified Açıklama Kullanıcının videoyu derecelendirmeden önce e-posta adresini doğrulaması gerekir.
    videos.rate	HTTP Yanıt Kodu badRequest (400) Neden videoPurchaseRequired Açıklama Kiralık videolar, yalnızca videoları kiralayan kullanıcılar tarafından değerlendirilebilir.

  • subscriptions.delete ve subscriptions.insert yöntemleri artık accountClosed ve accountSuspended hatalarını desteklememektedir.

27 Nisan 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni kaynaklar ve yöntemler

  • Yeni videoAbuseReportReason kaynağı, bir videonun kötüye kullanım amaçlı içerik barındırdığı için işaretlenme nedeni hakkında bilgi içeriyor. videoAbuseReportReasons.list yöntemi, videoların işaretlenme nedenlerinin tüm nedenlerini içeren bir liste almanızı sağlar.

  • Yeni videos.reportAbuse yöntemi, kötüye kullanım amaçlı içerik barındıran videoları gerçekten işaretlemek için yeni bir yöntem sunar. İsteğin gövdesi, videonun işaretlendiğini ve videonun kötüye kullanım amaçlı içerik barındırmasının nedenini belirten bir JSON nesnesi içerir. Geçerli nedenler, yukarıda açıklanan videoAbuseReportReason.list yönteminden edinilebilir.

    Taşıma rehberi de kötüye kullanım amaçlı videoyu bildirme örneğiyle güncellendi. Bu değişiklikle birlikte v3 API, artık desteklemesi planlanan tüm v2 API özelliklerini desteklemektedir. Bu özelliklerin tümü geçiş kılavuzunda da açıklanmaktadır.

• Mevcut kaynak ve yöntemlerde yapılan güncellemeler

  • search.list yönteminin yeni forDeveloper filtre parametresi, aramayı yalnızca geliştiricinin uygulaması veya web sitesi aracılığıyla yüklenen videoları alacak şekilde kısıtlar. forDeveloper parametresi, q parametresi gibi isteğe bağlı arama parametreleriyle birlikte kullanılabilir.

    Bu özellik için yüklenen her video, Google Developers Console'da geliştiricinin uygulamasıyla ilişkilendirilmiş proje numarasıyla otomatik olarak etiketlenir.

    Bir arama isteği, sonrasında forDeveloper parametresini true olarak ayarladığında, API sunucusu geliştiriciyi tanımlamak için isteğin yetkilendirme kimlik bilgilerini kullanır. Bu nedenle, geliştirici, sonuçları geliştiricinin kendi uygulaması veya web sitesi üzerinden yüklenen videolarla kısıtlayabilir ancak diğer uygulamalar veya siteler üzerinden yüklenen videolarla değiştiremez.

    Yeni özellik, v2 API'nin desteklediği geliştirici etiketleri işlevine benzer ancak aynı olmasa da işlevler sunar.

  • channel kaynağının yeni snippet.country mülkü, kanal sahiplerinin kanallarını belirli bir ülkeyle ilişkilendirmesini sağlar.

    Not: Bir channel kaynağı için snippet.country özelliğini ayarlamak isterseniz brandingSettings.channel.country özelliğini güncellemeniz gerekir.

  • API artık channelSection kaynakları için hedeflemeyi destekliyor. Kanal bölümü hedefleme, bir içerik bölümünün görünürlüğünü belirli ölçütlere uyan kullanıcılarla kısıtlamak için bir yol sağlar.

    API, üç hedefleme seçeneği sunar. Bir kanal bölümünün görünür olması için kullanıcının tüm hedefleme ayarlarını karşılaması gerekir.

    • targeting.languages[]: YouTube uygulama dillerinin listesi. Bu dillerden birini seçen kullanıcılar, ilgili kanal bölümünü görebilir.

    • targeting.regions[]: YouTube'un tercih ettiği içerik bölgelerinin listesi. Kanal bölümünü, bu bölgelerden birini seçen kullanıcıların yanı sıra söz konusu bölgelerden birini otomatik olarak seçen kullanıcılar da görebilir.

    • targeting.countries[]: Kanal bölümünün göründüğü ülkelerin listesidir. Listedeki her değer bir ISO 3166-1 alpha-2 ülke kodudur.

  • video kaynağının contentDetails.duration özelliğinin tanımı, değerin saat, gün vb. bilgileri yansıtabileceğini yansıtacak şekilde düzeltildi.

  • channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete ve videos.delete yöntemiyle ilgili dokümanlar, başarılı olduğunda bu yöntemlerin tümünün HTTP 204 yanıt kodu (No Content) döndüreceğini yansıtacak şekilde düzeltildi.

• Yeni ve güncellenmiş hatalar

  • API artık aşağıdaki hataları desteklemektedir:

    Hata türü	Hata ayrıntısı	Açıklama
    badRequest (400)	targetInvalidCountry	Eklenen channelSection kaynağı targeting.countries[] özelliği için geçersiz bir değer içeriyorsa channelSections.insert ve channelSections.update yöntemleri bu hatayı döndürür.
    badRequest (400)	targetInvalidLanguage	Eklenen channelSection kaynağı targeting.languages[] özelliği için geçersiz bir değer içeriyorsa channelSections.insert ve channelSections.update yöntemleri bu hatayı döndürür.
    badRequest (400)	targetInvalidRegion	Eklenen channelSection kaynağı targeting.regions[] özelliği için geçersiz bir değer içeriyorsa channelSections.insert ve channelSections.update yöntemleri bu hatayı döndürür.
    badRequest (400)	operationNotSupported	API kullanıcısı, snippet.parentId özelliği tarafından tanımlanan üst düzey yoruma yanıt olarak yorum ekleyemiyorsa comments.insert yöntemi bu hatayı döndürür. Bir commentThread kaynağında snippet.canReply özelliği, geçerli görüntüleyenin ileti dizisine yanıt verip veremeyeceğini gösterir.
    badRequest (400)	invalidChannelId	İstekteki channelId parametresi geçersiz bir kanal kimliği belirtiyorsa search.list yöntemi bu hatayı döndürür.
    badRequest (400)	subscriptionForbidden	API kullanıcısı, kullanıcının kendi kanalına abone olmaya çalışırsa subscriptions.insert yöntemi bu hatayı döndürür.

  • captions.update yöntemi artık invalidMetadata ve videoNotFound hatalarını desteklememektedir.

16 Nisan 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Taşıma rehberi, v2 API'deki yorum işlevini kullanmaya devam eden uygulamaların nasıl taşınacağını açıklayacak şekilde güncellendi.

  Kılavuzda, v2 API'nin desteklemediği ancak v3 API'de desteklenen çeşitli yorum yapma özellikleri de açıklanmaktadır. Bunlardan bazıları:

  • Kanal hakkında yorum alma
  • Bir kanalla ilgili tüm yorum ileti dizilerini alma. Bu, API yanıtının kanal veya herhangi bir kanal hakkında yorumları içerebileceği anlamına gelir.
  • Yorumun metnini güncelleme
  • Bir yorumu spam olarak işaretleme
  • Bir yorumun denetleme durumunu ayarlama

• Push bildirimlerine abone olma kılavuzu, bildirimlerin daha önce belirtildiği gibi yalnızca Google PubSubHubBub merkezine gönderildiğini, Superfeedr merkezine aktarılmadığını yansıtacak şekilde güncellendi.

9 Nisan 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• API'nin yeni commentThread ve comment kaynakları yorumları almanıza, eklemenize, güncellemenize, silmenize ve yönetmenize olanak tanır.

  • commentThread kaynağı, üst düzey yorumu ve varsa ilgili yoruma verilen yanıtları içeren YouTube yorum ileti dizisiyle ilgili bilgileri içerir. commentThread kaynağı bir video veya kanal hakkındaki yorumları temsil edebilir.

    Üst düzey yorum ve yanıtlar aslında commentThread kaynağının içine yerleştirilmiş comment kaynaklarıdır. commentThread kaynağının bir yoruma verilen tüm yanıtları içermesinin gerekli olmadığını ve belirli bir yoruma verilen tüm yanıtları almak istiyorsanız comments.list yöntemini kullanmanız gerekir. Ayrıca bazı yorumlara yanıt verilmedi.

    API, commentThread kaynakları için aşağıdaki yöntemleri destekler:

    • commentThreads.list: Yorum ileti dizilerinin listesini alın. Belirli bir video veya kanalla ilişkili yorumları almak için bu yöntemi kullanın.
    • commentThreads.insert – Yeni bir üst düzey yorum oluşturur. (Mevcut bir yorumu yanıtlamak için comments.insert yöntemini kullanın.)
    • commentThreads.update – Üst düzey bir yorumu değiştirebilirsiniz.

  • comment kaynağı, tek bir YouTube yorumuyla ilgili bilgileri içerir. comment kaynağı, bir video veya kanal hakkındaki bir yorumu temsil edebilir. Ayrıca, yorum üst düzey bir yorum veya üst düzey bir yorumun yanıtı olabilir.

    API, comment kaynakları için aşağıdaki yöntemleri destekler:

    • comments.list – Yorum listesini al. Belirli bir yoruma verilen tüm yanıtları almak için bu yöntemi kullanın.
    • comments.insert – Mevcut bir yoruma yanıt oluşturun.
    • comments.update – Yorumu değiştirme
    • comments.markAsSpam – Bir veya daha fazla yorumu spam olarak işaretleyin.
    • comments.setModerationStatus: Bir veya daha fazla yorumun denetleme durumunu ayarlayın. Örneğin, herkese açık olarak görüntülenmek üzere yapılan bir yorumu temizleyebilir veya gösterilmeye uygun olmayan bir yorumu reddedebilirsiniz. API isteği, yorumlarla ilişkili kanalın veya videonun sahibi tarafından yetkilendirilmelidir.
    • comments.delete – Yorumu silme.

  2 Nisan 2015 tarihindeki düzeltme geçmişinde açıklanan API'nin yeni https://www.googleapis.com/auth/youtube.force-ssl kapsamının comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert ve commentThreads.update yöntemlerine yapılan çağrılar için gerekli olduğunu unutmayın.

• Yeni Push bildirimlerine abone olma kılavuzunda, API'nin web tarafından erişilebilen kaynaklar için sunucudan sunucuya yayınlama/abone olma protokolü olan PubSubHubBub aracılığıyla sunulan yeni push bildirimleri desteği açıklanmaktadır. Bir kanal aşağıdaki etkinliklerden herhangi birini gerçekleştirdiğinde, PubSubHubBub geri çağırma sunucunuz Atom özet akışı bildirimleri alabilir:

  • Kullanıcı bir video yüklediğinde
  • Bir videonun başlığını günceller
  • Bir videonun açıklamasını günceller

• Taşıma rehberi de push bildirimleri için yeni desteğe yer verecek şekilde güncellendi. Ancak v2 API, v3 API'de desteklenmeyen başka birçok push bildirimi türünü desteklediğinden, PubSubHubBub desteğinden bahsedilmesi bu kılavuzun Kullanımdan kaldırılanlar bölümünde listelenmeye devam etmektedir.

• API'nin yeni https://www.googleapis.com/auth/youtube.force-ssl kapsamı, daha önce https://www.googleapis.com/auth/youtube kapsamını destekleyen tüm API yöntemleri için artık geçerli bir kapsam haline geldi.

• API artık aşağıdaki hataları desteklemektedir:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest (400)	invalidRating	İstek, rating parametresi için beklenmeyen bir değer içeriyorsa videos.rate yöntemi bu hatayı döndürür.

• subscriptions.insert yöntemi, daha önce istekle tanımlanan abonenin abonelik oranı sınırını aştığını belirten subscriptionLimitExceeded hatasını artık desteklememektedir.

2 Nisan 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni captions kaynağı, bir YouTube altyazı parçasını temsil etmektedir. Bir altyazı parçası tam olarak bir YouTube videosuyla ilişkilendirilir.

  API; altyazı parçalarını listeleme, ekleme, güncelleme, indirme ve silme yöntemlerini destekler.

• Taşıma rehberi de v2 API'sinde altyazı işlevini kullanmaya devam eden uygulamaların nasıl taşınacağını açıklayacak şekilde güncellendi.

• API'nin yeni https://www.googleapis.com/auth/youtube.force-ssl kapsamı, API sunucusuyla iletişimin SSL bağlantısı üzerinden yapılmasını gerektirir.

  Bu yeni kapsam, https://www.googleapis.com/auth/youtube kapsamıyla aynı erişimi sağlar. Aslında bu iki kapsam işlevsel olarak aynıdır, çünkü YouTube API sunucusu yalnızca bir HTTPS uç noktası aracılığıyla kullanılabilir. Sonuç olarak, https://www.googleapis.com/auth/youtube kapsamı SSL bağlantısı gerektirmese de, aslında API isteğinde bulunmanın başka bir yolu yoktur.

  Yeni kapsam, caption kaynağının tüm yöntemlerine yapılan çağrılar için gereklidir.

11 Mart 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• YouTube Data API (v3) taşıma rehberi, v3 API'nin desteklediği ve v2 API'nin desteklemediği özelliklerin listelendiği Yeni v3 API'si adlı yeni bir sekme içerir. Aynı özellikler daha önce de yer alıyordu ve rehberdeki diğer sekmelerde listelenmeye devam ediyor. Örneğin, bir kanalın video içi tanıtım kampanyası verilerinin nasıl güncelleneceğini açıklayan yeni özellik, Kanallar (profiller) sekmesinin altında da listelenir.

• YouTube Data API (v3) taşıma rehberi, v3 API'nin aşağıdaki v2 API özelliğini destekleyeceğini belirtecek şekilde güncellendi:

  • Video işaretleme

• YouTube Data API (v3) taşıma rehberi, aşağıdaki v2 API özelliklerinin v3 API'de desteklenmeyeceğini belirtecek şekilde güncellendi:

  • Video önerilerini alma: v3 API, yalnızca geçerli API kullanıcısı için önerilen videoların bulunduğu bir listeyi almaz. Bununla birlikte, activities.list yöntemini çağırıp home parametre değerini true olarak ayarlayarak önerilen videoları bulmak için v3 API'sini kullanabilirsiniz.

    API yanıtında, snippet.type özelliğinin değeri recommendation ise kaynak, önerilen bir videoya karşılık gelir. Bu durumda contentDetails.recommendation.reason ve contentDetails.recommendation.seedResourceId özellikleri, videonun neden önerildiğiyle ilgili bilgileri içerir. Yanıtın belirli bir sayıda önerilen video içereceğinin garantisi olmadığını unutmayın.

  • Kanal önerilerini alma

  • Yeni abonelik videolarını alma – v3 API, yalnızca API kullanıcısının abone olduğu kanallara yakın zamanda yüklenen videoları içeren bir liste almaz. Bununla birlikte, activities.list yöntemini çağırıp home parametre değerini true olarak ayarlayarak yeni abonelik videoları bulmak için v3 API'sini kullanabilirsiniz.

    API yanıtında, snippet.type özelliğinin değeri upload ise kaynak, yeni bir abonelik videosuna karşılık gelir. Yanıtın belirli sayıda yeni abonelik videosu içereceğinin garantisi olmadığını unutmayın.

  • RSS özet akışı desteği

  • Feed güncellemeleri için push bildirimleri: v2 API, YouTube kullanıcıları için kullanıcı etkinliği feed'lerini izlemek amacıyla Basit Güncelleme Protokolü (Super) veya PubSubHubbub kullanan push bildirimlerini destekliyordu. Yeni kanal abonelikleriyle ilgili olarak, videolar değerlendirildiğinde, paylaşıldığında, favori olarak işaretlendiğinde, yorumlandığında veya yüklendiğinde bildirimler alınıyordu.

    v3 API'si, PubSubHubbub protokolünü kullanan push bildirimlerini destekler ancak bildirimler yalnızca video yüklemelerini ve video başlıklarına veya video açıklamalarına yapılan güncellemeleri kapsar.

  • Kanal konumu: v2 API'si, kanalın herkese açık YouTube profiline girildiği şekliyle kullanıcının konumunu tanımlamak için <yt:location> etiketini kullandı. Bazı geliştiriciler bir kanalı belirli bir ülkeyle ilişkilendirmek için bu alanı kullansalar da alanın verileri bu amaç için tutarlı bir şekilde kullanılamadı.

  • Geliştirici etiketlerini ayarlama veya alma: v2 API, video yüklendiği sırada anahtar kelimeleri veya geliştirici etiketlerini bir videoyla ilişkilendirme özelliğini destekliyordu. Geliştirici etiketleri YouTube kullanıcılarına gösterilmez ancak video sahipleri, belirli bir geliştirici etiketiyle eşleşen videoları alabilir.

    v3 API, benzer ancak aynı olmayan bir özellik sunar. Özellikle, bir geliştirici kendi uygulaması tarafından yüklenen videoları arayabilir. Bu özellik için yüklenen her video, Google Developers Console'da geliştiricinin uygulamasıyla ilişkilendirilmiş proje numarasıyla otomatik olarak etiketlenir. Ardından geliştirici, video aramak için aynı proje numarasını kullanır.

  • Videoları yayınlanma tarihine, görüntüleme sayısına veya derecelendirmeye göre listeleme: v2 API'sinde orderby parametresi, oynatma listesindeki videoları konuma, süreye, yayınlanma tarihine, başlığa ve diğer birkaç değere göre sıralamanıza olanak tanır. v3 API'sinde oynatma listesi öğeleri genellikle konuma göre artan düzende sıralanır ve diğer sıralama seçenekleri kullanılamaz.

    Birkaç istisna vardır. Yeni bir yükleme, favori video, beğenilen veya son izlenen video, aşağıdaki oynatma listesi türleri için otomatik olarak ilk öğe (snippet.position=0) olarak eklenir. Bu nedenle, bu listelerin her biri, öğelerin listeye eklenme zamanlarına dayalı olarak en yeniden en eski öğeye doğru etkili bir şekilde sıralanır.

    • kullanıcı yüklemeleri
    • favori videolar
    • beğendiği videolar
    • izleme geçmişi

    Ancak "Daha sonra izle" bölümüne yeni bir öğe eklenir. oynatma listesi o listedeki son öğe olarak eklenir. Dolayısıyla, bu liste etkili şekilde en eski öğeden en yeni öğeye doğru sıralanır.

  • Toplu işleme – v3 API, v2 API'nin desteklediği toplu işleme kullanım alanlarından birini destekler. v3 API'sının channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list ve videos.list yöntemlerinin tümü, kimliklerin virgülle ayrılmış listesini (video kimlikleri, kanal kimlikleri vb.) belirtmek için kullanılabilen id parametresini destekler. Bu yöntemleri kullanarak tek bir istekle birden fazla kaynağın listesini alabilirsiniz.

  Bu değişikliklerle birlikte kılavuz artık mevcut API sürümünde (v3) desteği sonlandırılacak eski (v2) API'de desteklenen tüm işlevleri tanımlamaktadır.

4 Mart 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channelSections.delete ve channelSections.update yöntemleri artık, diğer birçok yöntem için zaten desteklenen onBehalfOfContentOwner parametresini desteklemektedir.

• Aşağıdaki mülkler ve bunların alt mülkleri kullanımdan kaldırılmıştır:

  • brandingSettings.image.backgroundImageUrl
  • brandingSettings.image.largeBrandedBannerImageImapScript
  • brandingSettings.image.largeBrandedBannerImageUrl
  • brandingSettings.image.smallBrandedBannerImageImapScript
  • brandingSettings.image.smallBrandedBannerImageUrl

  Not: Bu mülklerin hiçbiri, API'nin Kullanımdan Kaldırılması Politikası'na tabi değildi.

• video kaynağının yeni contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons özelliği, videonun neden DJCQT (Brezilya) derecelendirmesini aldığını açıklayan nedenleri tanımlar.

• API artık aşağıdaki hataları desteklemektedir:

  Hata türü	Hata ayrıntısı	Açıklama
  notFound (404)	channelNotFound	İsteğin id parametresi, bulunamayan bir kanalı belirtiyorsa channels.update yöntemi bu hatayı döndürür.
  badRequest (400)	manualSortRequiredinvalidValue	İstek, oynatma listesi öğesinin konumunu ayarlamaya çalışırsa ancak oynatma listesinde manuel sıralama kullanılmazsa playlistItems.insert ve playlistItems.update yöntemleri bu hatayı döndürür. Örneğin, oynatma listesi öğeleri tarihe veya popülerliğe göre sıralanabilir. İstek gövdesinde gönderilen kaynaktan snippet.position öğesini kaldırarak bu hatayı giderebilirsiniz. Oynatma listesi öğesinin listede belirli bir konuma sahip olmasını istiyorsanız önce oynatma listesinin sıralama ayarını Manuel olarak güncellemeniz gerekir. Bu ayar YouTube Video Yöneticisi'nden düzenlenebilir.
  forbidden (403)	channelClosed	İsteğin channelId parametresi kapalı bir kanalı belirtiyorsa playlists.list yöntemi bu hatayı döndürür.
  forbidden (403)	channelSuspended	İsteğin channelId parametresi askıya alınmış bir kanalı belirtiyorsa playlists.list yöntemi bu hatayı döndürür.
  forbidden (403)	playlistForbidden	İsteğin id parametresi isteği desteklemiyorsa veya istek düzgün şekilde yetkilendirilmemişse playlists.list yöntemi bu hatayı döndürür.
  notFound (404)	channelNotFound	İsteğin channelId parametresi, bulunamayan bir kanalı belirtiyorsa playlists.list yöntemi bu hatayı döndürür.
  notFound (404)	playlistNotFound	İsteğin id parametresi, bulunamayan bir oynatma listesi belirtiyorsa playlists.list yöntemi bu hatayı döndürür.
  notFound (404)	videoNotFound	İsteğin id parametresi, bulunamayan bir videoyu belirtirse videos.list yöntemi bu hatayı döndürür.
  badRequest (400)	invalidRating	İstek, rating parametresi için beklenmeyen bir değer içerirse videos.rate yöntemi bu hatayı döndürür.

2 Mart 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• search.list yöntemi artık belirli bir dille en alakalı sonuçları istemenize olanak tanıyan relevanceLanguage parametresini desteklemektedir.

  YouTube Data API (v3) taşıma rehberi de bu yeni parametrenin nasıl kullanılacağını açıklayacak şekilde güncellendi. Bu parametre, mevcut API sürümü (v3) ile kullanımdan kaldırılmış önceki sürüm (v2) arasında önceden bulunan bir özellik eksikliğini giderir.

• YouTube Data API (v3) taşıma rehberi de v2 API'nin filmleri, fragmanları, televizyon programlarını, televizyon sezonlarını ve televizyon bölümlerini açıklamak için sağladığı özel feed'ler ve meta veri alanlarının kullanımdan kaldırılacağını belirtecek şekilde güncellendi.

14 Ocak 2015

Bu güncelleme aşağıdaki değişiklikleri içerir:

• YouTube Data API (v3) taşıma rehberi, JavaScript kullanarak video yüklemek için v3 API'nin nasıl kullanılacağını açıklayacak şekilde güncellendi. (Ayrıntılar için Video yükleme bölümüne bakın.) Bu işlev, v2 API'nin desteklediği tarayıcı tabanlı yükleme işleviyle benzerdir. Taşıma kılavuzunda yapılan bu değişikliğin gerçek bir API değişikliğini değil, istemci taraflı JavaScript ile video yüklemek için yeni örnek kodun kullanılabilirliğini yansıttığını unutmayın.

  JavaScript istemci kitaplığı ve CORS ile video yükleme desteği verildiğinden, geçiş rehberinde artık tarayıcı tabanlı yükleme, v3 API'de desteği sonlandırılabilecek bir özellik olarak listelenmemektedir.

• videos.insert yöntemine ilişkin dokümanlar, yukarıda açıklanan yeni JavaScript kod örneğini içerecek şekilde güncellendi. YouTube Data API (v3) için JavaScript kod örnekleri listesi de güncellendi.

11 Kasım 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• search.list yöntemine yapılan bir çağrının kota maliyeti 100 birim olarak değişti.

  Önemli: Çoğu durumda, daha düşük bir kota maliyetiyle bilgi almak için diğer API yöntemlerini kullanabilirsiniz. Örneğin, GoogleDevelopers kanalına yüklenen videoları bulmaya yönelik bu iki yöntemi göz önünde bulundurun.

  • Kota maliyeti: 100 birim

    search.list yöntemini çağırın ve GoogleDevelopers araması yapın.

  • Kota maliyeti: 6 birim

    Doğru kanal kimliğini bulmak için channels.list yöntemini çağırın. forUsername parametresini GoogleDevelopers ve part parametresini contentDetails olarak ayarlayın. API yanıtında contentDetails.relatedPlaylists.uploads özelliği, kanalın yüklenen videoları için oynatma listesi kimliğini belirtir.

    Ardından, playlistItems.list yöntemini çağırın ve playlistId parametresini yakalanan kimlik, part parametresini ise snippet olarak ayarlayın.

8 Ekim 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channel kaynağı iki yeni mülk içeriyor:

  • status.longUploadsStatus özelliği, kanalın 15 dakikadan uzun videolar yüklemeye uygun olup olmadığını gösterir. Bu özellik yalnızca kanal sahibi API isteğini yetkilendirdiyse döndürülür. Geçerli özellik değerleri şunlardır:

    • allowed: Kanal, 15 dakikadan uzun videolar yükleyebilir.
    • eligible – Kanal, 15 dakikadan uzun videolar yükleyebilir ancak öncelikle bu özelliği etkinleştirmesi gerekir.
    • disallowed: Kanal, 15 dakikadan uzun videolar yükleyemez veya yüklemeye uygun değildir.

    Bu değerler hakkında daha fazla bilgi için mülk tanımına bakın. Ayrıca YouTube Yardım Merkezi'nde de bu özellikle ilgili daha ayrıntılı bilgi bulabilirsiniz.

  • invideoPromotion.useSmartTiming özelliği, kanalın tanıtım kampanyasında "akıllı zamanlama" kullanılıp kullanılmadığını gösterir. Bu özellik, tanıtımların videonun tıklanma olasılığının daha yüksek olduğu ve izleme deneyimini kesintiye uğratma olasılığının daha düşük olduğu bir noktada göstermeye çalışır. Bu özellik ayrıca her videoda gösterilecek tek bir tanıtım seçer.

• video kaynağının snippet.title ve snippet.categoryId özelliklerinin tanımları, API'nin videos.update yöntemine yapılan çağrıları işleme şeklini netleştirmek için güncellendi. Bir video kaynağının snippet bölümünü güncellemek için bu yöntemi çağırırsanız bu özelliklerin her ikisi için de bir değer belirlemeniz gerekir.

  Bir video kaynağının snippet bölümünü güncellemeye çalışır ve bu özelliklerin her ikisi için de değer ayarlamazsanız API, invalidRequest hatası verir. Bu hatanın açıklaması da güncellendi.

• video kaynağının Yeni Zelanda Film ve Edebiyat Sınıflandırma Ofisi'ndeki bir videonun derecelendirmesini tanımlayan contentDetails.contentRating.oflcRating özelliği, artık iki yeni derecelendirmeyi destekliyor: oflcRp13 ve oflcRp16. Bunlar, sırasıyla RP13 ve RP16 derecelendirmelerine karşılık gelir.

• channelBanners.insert yöntemi artık şu hatayı desteklemektedir:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest	bannerAlbumFull	Kanal sahibinin YouTube Kanal Resmi albümünde çok fazla resim var. Kanal sahibi http://photos.google.com adresine gitmeli, albümler sayfasına gitmeli ve bu albümdeki resimlerden bazılarını kaldırmalıdır.

12 Eylül 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• search.list yöntemine yapılan bir çağrının kota maliyeti, belirtilen kaynak bölümlerinin maliyetine ek olarak 1 birimden 2 birim olarak değiştirildi.

13 Ağustos 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• subscriptions.insert yöntemi artık şu hatayı desteklemektedir:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest	subscriptionLimitExceeded	İstekle tanımlanan abone, abonelik ücreti sınırını aştı. Birkaç saat içinde daha fazla abonelik satın almayı deneyebilirsiniz.

12 Ağustos 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Uygulamanızı YouTube Data API'ye (v3) Taşıma başlıklı yeni kılavuzda, YouTube Data API'de (v2) bulunan işlevleri yerine getirmek için YouTube Data API'nin (v3) nasıl kullanılacağı açıklanmaktadır. Eski API, 4 Mart 2014 tarihi itibarıyla resmi olarak kullanımdan kaldırılmıştır. Bu kılavuzun amacı, v2 API'yi kullanmaya devam eden uygulamaları en son API sürümüne taşımanıza yardımcı olmaktır.

8 Temmuz 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• playlists.insert yöntemi artık şu hatayı desteklemektedir:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest	maxPlaylistExceeded	Bu hata, kanalda izin verilen maksimum sayıda oynatma listesine sahip olduğu için oynatma listesi oluşturulamıyorsa ortaya çıkar.

18 Haziran 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Her bir API yönteminin açıklaması, söz konusu yönteme yapılan çağrının neden olduğu kota maliyetini içerecek şekilde güncellenmiştir. Benzer şekilde, part parametrelerinin tanımları da API çağrısında alınabilecek her bölümün kota maliyetini belirtecek şekilde güncellendi. Örneğin, subscriptions.insert yöntemine yapılan bir çağrının kota maliyeti yaklaşık 50 birimdir. subscription kaynağı da üç bölüm (snippet, contentDetails ve subscriberSnippet) içeriyor ve bunların her birinin iki birim maliyeti var.

  Kota maliyetlerinin uyarı yapılmaksızın değişebileceğini lütfen unutmayın.

• video kaynağı artık videoların çeşitli ulusal derecelendirme kurumlarından aldığı derecelendirmeleri tanımlayan 43 yeni içerik derecelendirme sistemini desteklemektedir.

28 Mayıs 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• search.list yöntemi artık, coğrafi konumla ilişkilendirilmiş videoları aramanıza olanak tanıyan location ve locationRadius parametrelerini desteklemektedir. İstek, sonuçları konuma göre alabilmek amacıyla her iki parametre için de bir değer belirtmelidir. İstek, iki parametreden yalnızca birini içeriyorsa API hata döndürür.

  • location parametresi, dairesel coğrafi alanın merkezindeki enlem/boylam koordinatlarını belirtir.

  • locationRadius parametresi, bir videoyla ilişkilendirilen konumun, videonun arama sonuçlarına dahil edilmeye devam edebileceği alanın ortasından alabileceği maksimum mesafeyi belirtir.

13 Mayıs 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channel kaynağının invideoPromotion.items[] özelliği, kanalınız için genellikle yalnızca bir tanıtılan öğe ayarlayabileceğinizi belirtecek şekilde güncellendi. Çok fazla sayıda tanıtılan öğe eklemeye çalışırsanız API, HTTP 400 durum koduna sahip bir tooManyPromotedItems hatası döndürür.

• channelSection kaynağında artık birkaç yeni öne çıkan içerik türüyle ilgili bilgi bulunabilir. channelSection kaynağının snippet.type özelliği artık aşağıdaki değerleri destekliyor:

  • postedPlaylists - kanal sahibinin kanal etkinlik feed'inde yayınladığı oynatma listeleri
  • postedVideos - kanal sahibinin kanal etkinlik feed'inde yayınladığı videolar
  • subscriptions: Kanal sahibinin abone olduğu kanallar

• video kaynağının yeni contentDetails.contentRating.ifcoRating özelliği, bir videonun İrlanda Film Sınıflandırma Ofisi'nden aldığı derecelendirmeyi tanımlar.

• watermark kaynağının position.cornerPosition özelliğinin tanımı, filigranın her zaman oynatıcının sağ üst köşesinde gösterileceği şekilde güncellendi.

• search.list yöntemi için q parametresinin tanımı, sorgu teriminin belirli bir arama terimiyle ilişkilendirilmiş videoları hariç tutmak için DEĞİL (-) Boole operatörünü kullanabileceğini belirtecek şekilde güncellendi. Değer, çeşitli arama terimlerinden biriyle ilişkilendirilmiş videoları bulmak için Boole VEYA (|) operatörünü de kullanabilir.

• Bir search.list çağrısına API yanıtında döndürülen pageInfo.totalResults özelliğinin tanımı, değerin yaklaşık bir değer olduğunu ve tam bir değeri temsil etmeyebileceğini belirtecek şekilde güncellendi. Ayrıca, maksimum değer 1.000.000'dur. Sayfalara ayırma bağlantıları oluşturmak için bu değeri kullanmamalısınız. Bunun yerine, sayfalara ayırma bağlantılarının gösterilip gösterilmeyeceğini belirlemek için nextPageToken ve prevPageToken özellik değerlerini kullanın.

• watermarks.set ve watermarks.unset yöntemleri, API'nin bu yöntemlere gönderilen başarılı istekler için HTTP 204 yanıt kodu döndürdüğünü yansıtacak şekilde güncellendi.

2 Mayıs 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni i18nLanguage kaynağı, YouTube web sitesinin desteklediği bir uygulama dilini tanımlar. Uygulama dili, kullanıcı arayüzü dili olarak da adlandırılabilir. YouTube web sitesi için bir uygulama dili, Google Hesabı ayarlarına, tarayıcı diline veya IP konumuna göre otomatik olarak seçilebilir ve kullanıcı, YouTube site alt bilgisinden istediği kullanıcı arayüzü dilini manuel olarak da seçebilir.

  API, desteklenen uygulama dillerini listelemek için bir yöntemi destekler. Desteklenen diller, videoCategories.list ve guideCategories.list gibi API yöntemleri çağrılırken hl parametresinin değeri olarak kullanılabilir.

• Yeni i18nRegion kaynağı, YouTube kullanıcısının tercih edilen içerik bölgesi olarak seçebileceği bir coğrafi alanı tanımlar. İçerik bölgesi, içerik yerel ayarı olarak da adlandırılabilir. YouTube web sitesi için, YouTube alanı veya kullanıcının IP konumu gibi buluşsal yöntemlere göre otomatik olarak bir içerik bölgesi seçilebilir. Ayrıca, kullanıcı YouTube sitesinin altbilgisinden istediği içerik bölgesini manuel olarak da seçebilir.

  API, desteklenen içerik bölgelerini listeleme yöntemini destekler. Desteklenen bölge kodları; search.list, videos.list, activities.list ve videoCategories.list gibi API yöntemlerini çağırırken regionCode parametresinin değeri olarak kullanılabilir.

7 Nisan 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni channelSection kaynağı, bir kanalın öne çıkarmayı tercih ettiği bir dizi video hakkında bilgi içerir. Örneğin, bir bölümde kanalın son yüklemeleri, en popüler yüklemeleri veya bir ya da daha fazla oynatma listesindeki videoları öne çıkarabilirsiniz.

  API, kanal bölümlerini listeleme, ekleme, güncelleme veya silme yöntemlerini destekler. Belirli bir kanal kimliğini belirterek veya benzersiz kanal bölümü kimliklerinin listesini belirterek kimliği doğrulanmış kullanıcının kanalına ilişkin kanal bölümleri listesini alabilirsiniz.

  Hata dokümanları da API'nin özellikle bu yeni yöntemler için desteklediği hata mesajlarını açıklayacak şekilde güncellendi.

• video kaynağının fileDetails nesnesinin tanımı, söz konusu nesnenin yalnızca videonun processingDetails.fileDetailsAvailability özelliğinin available değerine sahip olması durumunda döndürüleceğini açıklayacak şekilde güncellendi.

  Benzer şekilde, video kaynağının suggestions nesnesinin tanımı, bu nesnenin yalnızca videonun processingDetails.tagSuggestionsAvailability özelliği veya processingDetails.editorSuggestionsAvailability özelliğinin available değerine sahip olması durumunda döndürüleceğini açıklayacak şekilde güncellendi.

• videos.insert ve videos.update yöntemleriyle ilgili dokümanlar, bu yöntemler çağrılırken status.publishAt özelliğinin ayarlanabileceğini yansıtacak şekilde güncellendi.

• channel kaynağının invideoPromotion nesnesinin tanımı, nesnenin yalnızca kanal sahibi tarafından alınabileceğini açıklayacak şekilde güncellendi.

• videos.rate yönteminin parametre listesi, söz konusu yöntemin aslında onBehalfOfContentOwner parametresini desteklemediğini yansıtacak şekilde güncellendi. Bu parametreyi ayarlayan videos.rate istekleri 500 hatası döndürdüğünden, bir doküman hatasıdır.

31 Mart 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• video kaynağının yeni status.publishAt özelliği, gizli bir videonun yayınlanmasının planlandığı tarihi ve saati belirtmenizi sağlar. Bu özellik yalnızca videonun gizlilik durumu private ise ve video hiç yayınlanmamışsa ayarlanabilir. Bu yeni mülk, kullanımdan kaldırma politikasına tabi değildir.

13 Mart 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• API artık channel kaynakları için contentOwnerDetails bölümünü desteklemektedir. Yeni kısım, kanala bağlı YouTube iş ortaklarıyla alakalı kanal verilerini (ör. kanala bağlı içerik sahibinin kimliği ve içerik sahibi ile kanalın bağlandığı tarih ve saat) içerir. Bu yeni bölümün kullanımdan kaldırma politikasına tabi olmadığını unutmayın.

• Dokümanlarda artık aşağıdaki özellikler için desteklenen maksimum karakter uzunluğu listelenmektedir:

  Kaynak	Özellik	Maksimum uzunluk
  channel	invideoPromotion.items[].customMessage	40 karakter
  video	snippet.title	100 karakter
  video	snippet.description	5.000 bayt
  video	snippet.tags	500 karakter. Özellik değerinin bir liste olduğunu ve listedeki öğeler arasındaki virgüllerin sınıra dahil edildiğini unutmayın.

• channel kaynağının brandingSettings.watch.featuredPlaylistId özelliği kullanımdan kaldırıldı. API, değerini ayarlamaya çalışırsanız hata döndürür.

• Aşağıdaki video kaynak özellikleri, bir videoyu eklerken veya güncellerken ayarlanabilecek değerler listesine eklendi:

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude
  • recordingDetails.recordingDate

• Hata dokümanları artık her hata türü için HTTP yanıt kodunu belirtmektedir.

• API artık aşağıdaki hataları desteklemektedir:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest (400)	invalidCriteria	İstek, birbiriyle bağlantılı olarak kullanılamayacak filtre parametreleri belirtiyorsa channels.list yöntemi bu hatayı döndürür.
  badRequest (400)	channelTitleUpdateForbidden	Bir kanalın brandingSettings bölümünü güncellemeye ve brandingSettings.channel.title özelliğinin değerini değiştirmeye çalışırsanız channels.update yöntemi bu hatayı döndürür. (Özelliği atlarsanız API'nin hatayı döndürmeyeceğini unutmayın.)
  badRequest (400)	invalidRecentlyUploadedBy	invideoPromotion.items[].id.recentlyUploadedBy özelliği geçersiz bir kanal kimliği belirtiyorsa channels.update yöntemi bu hatayı döndürür.
  badRequest (400)	invalidTimingOffset	invideoPromotion bölümü geçersiz bir zamanlama farkı belirtiyorsa channels.update yöntemi bu hatayı döndürür.
  badRequest (400)	tooManyPromotedItems	invideoPromotion bölümü, izin verilen tanıtım öğesi sayısından daha fazla öğe belirtiyorsa channels.update yöntemi bu hatayı döndürür.
  forbidden (403)	promotedVideoNotAllowed	invideoPromotion.items[].id.videoId özelliği, bulunamayan veya tanıtılan öğe olarak kullanılamayacak bir video kimliği belirtirse channels.update yöntemi bu hatayı döndürür.
  forbidden (403)	websiteLinkNotAllowed	invideoPromotion.items[].id.websiteUrl özelliği izin verilmeyen bir URL belirtiyorsa channels.update yöntemi bu hatayı döndürür.
  required (400)	requiredTimingType	İstek, YouTube'un tanıtılan bir öğeyi ne zaman göstermesi gerektiğini belirten varsayılan zamanlama ayarlarını belirtmiyorsa channels.update yöntemi bu hatayı döndürür.
  required (400)	requiredTiming	channels.update yöntemi, tanıtılan her öğe için bir invideoPromotion.items[].timing nesnesi belirtmelidir.
  required (400)	requiredWebsiteUrl	channels.update yöntemi, tanıtılan her öğe için bir invideoPromotion.items[].id.websiteUrl özelliği belirtmelidir.
  badRequest (400)	invalidPublishAt	İstek meta verileri geçersiz bir planlanmış yayınlama zamanı belirtiyorsa videos.insert yöntemi bu hatayı döndürür.

4 Mart 2014

Bu güncelleme aşağıdaki değişiklikleri içerir:

• YouTube Data API (v3) artık YouTube API'leri Hizmet Şartları'nda açıklanan Kullanımdan Kaldırma Politikası'na tabidir. Desteği sonlandırma politikasına tabi API'lerin listelendiği sayfanın, bazı v3 API işlevlerinin politikaya tabi olmadığını özellikle hariç tuttuğunu unutmayın.

5 Aralık 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• search.list yönteminin dokümanları, arama isteği gönderirken tam olarak bir filtre parametresi için değer belirtmeniz gerekmediğini doğru bir şekilde yansıtacak şekilde güncellendi. Bunun yerine, sıfır filtre parametreleri veya tek bir filtre parametresi için bir değer ayarlayabilirsiniz.

• search.list yöntemi parametrelerine ilişkin tanımlar, aşağıdaki parametrelerden herhangi biri için de bir değer belirtirseniz type parametresinin değerini video olarak ayarlamanız gerektiğini unutmamak üzere güncellendi:

  • eventType
  • videoCaption
  • videoCategoryId
  • videoDefinition
  • videoDimension
  • videoDuration
  • videoEmbeddable
  • videoLicense
  • videoSyndicated
  • videoType

• Yüklenen kanal banner resimlerinin minimum boyutu 2.048 x 1.152 piksel olacak şekilde düşürüldü. (Daha önce minimum boyut 2120 x 1192 pikseldi.) Ayrıca channel kaynak belgelerinin, API'den sunulan tüm banner resimlerinin maksimum boyutlarını belirttiğini unutmayın. Örneğin, televizyon uygulamaları için brandingSettings.image.bannerTvImageUrl resminin maksimum boyutu 2120 x 1192 pikseldir, ancak gerçek resim 2048 x 1152 piksel olabilir. YouTube Yardım Merkezi'nde, farklı cihaz türlerinde görüntülenmek üzere kanal resmini optimize etme hakkında daha fazla bilgi bulabilirsiniz.

• channel kaynak özelliği tanımlarından bazıları, aşağıdaki bilgileri yansıtacak şekilde güncellendi:

  • brandingSettings.channel.description özelliğinin değeri en fazla 1000 karakter uzunluğunda olabilir.
  • brandingSettings.channel.featuredChannelsTitle özelliğinin maksimum uzunluğu 30 karakterdir.
  • brandingSettings.channel.featuredChannelsUrls[] mülkü artık 100'e kadar kanal listeleyebilir.
  • brandingSettings.channel.unsubscribedTrailer özellik değeri ayarlanırsa kanal sahibine ait herkese açık veya liste dışı bir videonun YouTube video kimliğini belirtmelidir.

• channels.update yöntemi artık invideoPromotion.items[].promotedByContentOwner özelliğinde yapılan güncellemeleri desteklemektedir. Bu özellik, tanıtım görüntülenirken içerik sahibinin adının gösterilip gösterilmeyeceğini belirtir. Yalnızca özellik değerini belirleyen API isteği, onBehalfOfContentOwner parametresi kullanılarak içerik sahibi adına yapılıyorsa ayarlanabilir.

• playlistItems.list ve playlistItems.insert yöntemleri artık, diğer birçok yöntem için zaten desteklenen onBehalfOfContentOwner parametresini desteklemektedir.

• contentDetails.contentRating.acbRating mülkü artık filmler için Avustralya Sınıflandırma Kurulu'ndan (ACB) ya da çocuklara yönelik televizyon programları için Avustralya İletişim ve Medya Kurumu'nun (ACMA) sağladığı derecelendirmeyi belirtebilir.

• Yeni contentDetails.contentRating.catvRating ve contentDetails.contentRating.catvfrRating özellikleri, bir videonun sırasıyla Québec'te kullanılan Kanada TV Sınıflandırma Sistemi ve Fransızca dilindeki Régie du cinéma derecelendirme sistemi kapsamında aldığı derecelendirmeleri tanımlar.

• videoCategory kaynağının yeni snippet.assignable özelliği, güncellenen veya yeni yüklenen videoların söz konusu video kategorisiyle ilişkilendirilip ilişkilendirilemeyeceğini gösterir.

• Aşağıdaki yöntemler için kod örnekleri eklendi:

  • activities.insert (Git)
  • channelBanners.insert (Python)
  • channels.update (Python)
  • playlistItems.list (Git)
  • search.list (Git)
  • thumbnails.set (Java)
  • videos.insert (Git)

24 Ekim 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• API, canlı yayın içeriğinin bulunmasına ve öne çıkarılmasına yardımcı olmak için tasarlanmış iki ek özellik içerir:

  Arama sonuçlarındaki yeni snippet.liveBroadcastContent özelliği, bir video veya kanal kaynağının canlı yayın içeriği olup olmadığını gösterir. Geçerli özellik değerleri: upcoming, active ve none.

  • video kaynağının yeni snippet.liveBroadcastContent özelliği, videonun yaklaşan veya etkin bir canlı yayın olup olmadığını gösterir. Aşağıdaki listede mülkün olası değerleri açıklanmaktadır:

    • upcoming – Video henüz başlamamış bir canlı yayındır.
    • active – Video devam eden bir canlı yayındır.
    • none – Video yaklaşan veya etkin bir canlı yayın değildir. Bu, YouTube'da hâlâ görüntülenebilir olan tamamlanmış yayınların özellik değeri olacaktır.

  • video kaynağının yeni liveStreamingDetails özelliği, canlı video yayınıyla ilgili meta verileri içeren bir nesnedir. Bu meta verileri almak için part parametre değerinin kaynak bölümleri listesine liveStreamingDetails öğesini ekleyin. Meta veriler aşağıdaki yeni özellikleri içerir:

    • liveStreamingDetails.actualStartTime: Yayının başlatıldığı zamandır. (Bu değer, yayının durumu active olduğunda görünür.)
    • liveStreamingDetails.actualEndTime: Yayının gerçekten sona erdiği zamandır. (Bu değer, yayın sona erdiğinde sunulur.)
    • liveStreamingDetails.scheduledStartTime – Yayının başlatılmasının planlandığı saat.
    • liveStreamingDetails.scheduledEndTime – Yayının sona ermesinin planlandığı saat. Özellik değeri boşsa veya özellik mevcut değilse yayın süresiz olarak devam edecek şekilde planlanır.
    • liveStreamingDetails.concurrentViewers: Canlı yayını izleyen kullanıcı sayısıdır.

    Bu meta verileri almak için videos.list, videos.insert veya videos.update yöntemini çağırırken part parametre değerine liveStreamingDetails ekleyin.

  Canlı yayın içeriğini tanımlamaya yönelik diğer iki özelliğin 1 Ekim 2013'te kullanıma sunulduğunu unutmayın: search.list yönteminin eventType parametresi ve arama sonucunun snippet.liveBroadcastContent özelliği.

• videos.insert yöntemi artık notifySubscribers parametresini desteklemektedir. Bu parametre, YouTube'un videonun kanalına abone olan kullanıcılara yeni videoyla ilgili bir bildirim gönderip göndermeyeceğini ifade eder. Parametrenin varsayılan değeri olan True, abonelere yeni yüklenen videolar hakkında bildirim gönderilir. Ancak çok sayıda video yükleyen bir kanal sahibi, kanalın abonelerine her yeni videoyla ilgili bildirim göndermemek için bu değeri False olarak ayarlamayı tercih edebilir.

• channels.update yöntemi çağrılırken değiştirilebilecek özelliklerin listesi, invideoPromotion.items[].customMessage ve invideoPromotion.items[].websiteUrl özelliklerini içerecek şekilde güncellendi. Ayrıca liste, değiştirilebilen brandingSettings özelliklerini tanımlayacak şekilde değiştirildi. Bu brandingSettings özellikleri zaten değiştirilebilir. Bu nedenle, belge değişikliği, API'nin mevcut işlevinde yapılan bir değişikliği yansıtmamaktadır.

• playlists.insert, playlists.update ve playlists.delete yöntemleri artık, diğer birçok yöntem için zaten desteklenen onBehalfOfContentOwner parametresini desteklemektedir.

• playlists.insert yöntemi artık, diğer birçok yöntem için zaten desteklenen onBehalfOfContentOwnerChannel parametresini desteklemektedir.

• video kaynağının contentDetails.contentRating.tvpgRating özelliği artık TV-14 değerine karşılık gelen pg14 değerini destekliyor.

• Arama sonuçlarının bir parçası olan snippet.liveBroadcastContent özelliğinin tanımı, live değerinin geçerli bir özellik değeri olduğunu ancak active geçerli bir özellik değeri olmadığını yansıtacak şekilde düzeltildi.

• video kaynağının contentDetails.contentRating.mibacRating mülkü artık iki ek derecelendirmeyi destekliyor:

  • mibacVap (VAP): Çocuklara bir yetişkin refakat etmelidir.
  • mibacVm6 (V.M.6): 6 yaş ve üstü ile sınırlıdır.
  • mibacVm12 (V.M.12): 12 yaş ve üstü ile sınırlıdır.

• channel kaynağının yeni invideoPromotion.items[].promotedByContentOwner özelliği, tanıtım görüntülenirken içerik sahibinin adının gösterilip gösterilmeyeceğini belirtir. Bu alan yalnızca değeri ayarlayan API isteği, içerik sahibi adına yapılıyorsa ayarlanabilir. Daha fazla bilgi için onBehalfOfContentOwner parametresine bakın.

1 Ekim 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channel kaynağının yeni auditDetails nesnesi, bir çok kanallı ağın (MCN) belirli bir kanalı kabul etmeyi veya reddetmeyi belirlerken değerlendireceği kanal verilerini içeriyor. Bu kaynak bölümünü alan API isteklerinin, https://www.googleapis.com/auth/youtubepartner-channel-audit kapsamını içeren bir yetkilendirme jetonu sağlaması gerektiğini unutmayın. Ayrıca, MCN kanalı kabul etmeye veya reddetmeye karar verdiğinde ya da jetonun verildiği tarihten itibaren iki hafta içinde bu kapsamı kullanan tüm jetonlar iptal edilmelidir.

• channel kaynağının invideoPromotion.items[].id.type özelliği artık recentUpload değerini destekliyor. Bu değer, tanıtılan öğenin belirli bir kanaldan en son yüklenen video olduğunu gösterir.

  Varsayılan olarak kanal, video içi tanıtım verilerinin ayarlandığı kanalla aynıdır. Bununla birlikte, yeni invideoPromotion.items[].id.recentlyUploadedBy özelliğinin değerini başka bir kanalın kanal kimliğine ayarlayarak, başka bir kanaldan en son yüklenen videoyu tanıtabilirsiniz.

• channel kaynağı, televizyon uygulamalarındaki kanal sayfalarında gösterilen banner resimlerinin URL'lerini belirten üç yeni özellik (brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl, brandingSettings.image.bannerTvHighImageUrl) içeriyor.

• Arama sonuçlarındaki yeni snippet.liveBroadcastContent özelliği, bir video veya kanal kaynağının canlı yayın içeriği olup olmadığını gösterir. Geçerli özellik değerleri: upcoming, active ve none.

  • Bir video kaynağı için upcoming değeri videonun henüz başlatılmamış canlı bir yayın olduğunu, active değeri ise videonun devam eden bir canlı yayın olduğunu belirtir.
  • Bir channel kaynağı için upcoming değeri, kanalda henüz başlamamış olan planlanmış bir yayının olduğunu, acive değeri ise kanalda devam eden bir canlı yayının olduğunu gösterir.

• watermark kaynağında, nesne olan targetChannelId özelliği dize olarak değiştirildi. targetChannelId özelliği, filigran resminin bağlantı verdiği kanalın YouTube kanal kimliğini belirten bir alt özellik yerine artık bu değeri kendisi belirtiyor. Bu nedenle, kaynağın targetChannelId.value özelliği kaldırıldı.

• thumbnails.set yöntemi artık, diğer birçok yöntem için zaten desteklenen onBehalfOfContentOwner parametresini desteklemektedir.

• search.list yöntemi artık aramayı yalnızca etkin, yaklaşan veya tamamlanmış yayın etkinliklerini döndürecek şekilde kısıtlayan eventType parametresini desteklemektedir.

• Yeni contentDetails.contentRating.mibacRating özelliği, bir videonun İtalya'daki Ministero dei Beni e delle Attivita Culturali e del Turismo'dan aldığı derecelendirmeyi tanımlar.

• API artık aşağıdaki hataları desteklemektedir:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest	invalidImage	Sağlanan resim içeriği geçersizse thumbnails.set yöntemi bu hatayı döndürür.
  forbidden	videoRatingDisabled	Derecelendirilen videonun sahibi, derecelendirmeleri devre dışı bırakmışsa videos.rate yöntemi bu hatayı döndürür.

27 Ağustos 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni watermark kaynağı, belirli bir kanalın videoları oynatılırken görüntülenen bir resmi tanımlar. Filigranın video oynatmaları sırasında ne zaman görüneceğini ve ne kadar süreyle görüneceğini belirleyen zamanlama ayrıntılarının yanı sıra resmin bağlanacağı hedef kanalı da belirtebilirsiniz.

  watermarks.set yöntemi, bir kanalın filigran resmini yükler ve ayarlar. watermarks.unset yöntemi, bir kanalın filigran resmini siler.

  Hata dokümanlarında, API'nin özellikle watermarks.set ve watermarks.unset yöntemleri için desteklediği hata mesajları açıklanmaktadır.

• channel kaynağının yeni statistics.hiddenSubscriberCount özelliği, kanalın abone sayısının gizlenip gizlenmediğini gösteren bir boole değeri içerir. Bu nedenle, kanalın abone sayısı herkes tarafından görülebiliyorsa mülkün değeri false olur.

• playlists.list yöntemi artık onBehalfOfContentOwner ve onBehalfOfContentOwnerChannel parametrelerini desteklemektedir. Her iki parametre de diğer birkaç yöntem için zaten desteklenmektedir.

• videos.list yöntemi artık, grafiğin alınması gereken içerik bölgesini tanımlayan regionCode parametresini desteklemektedir. Bu parametre yalnızca chart parametresiyle birlikte kullanılabilir. Parametre değeri ISO 3166-1 alfa-2 ülke kodudur.

• error documentation, birden fazla API yönteminde oluşabilecek aşağıdaki yeni ve yaygın istek hatasını açıklamaktadır:

  Hata türü	Hata ayrıntısı	Açıklama
  forbidden	insufficientPermissions	İstek için sağlanan OAuth 2.0 jetonuyla ilişkili kapsamlar, istenen verilere erişim için yeterli değil.

15 Ağustos 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channel kaynağının invideoPromotion nesnesi, aşağıdaki yeni ve güncellenmiş özelliklere sahip:

  • API artık bir web sitesini tanıtılan öğe olarak belirtme özelliğini desteklemektedir. Bunu yapmak için invideoPromotion.items[].id.type özelliğinin değerini website olarak ayarlayın ve URL'yi belirtmek için yeni invideoPromotion.items[].id.websiteUrl özelliğini kullanın. Ayrıca, promosyon için görüntülenecek özel bir mesaj tanımlamak üzere yeni invideoPromotion.items[].customMessage özelliğini kullanın.

    Bağlantılar ilişkilendirilmiş web siteleri, satıcı siteleri veya sosyal ağ siteleri olabilir. İçeriğiniz için bağlantıları etkinleştirme hakkında daha fazla bilgi edinmek istiyorsanız ilişkilendirilmiş web siteleri ve satıcı siteleri ile ilgili YouTube Yardım Merkezi talimatlarını inceleyin.

    Tanıtım bağlantıları ekleyerek bu bağlantıların yetkisiz sitelere trafik yönlendirmek için kullanılmayacağını ve bu bağlantıların YouTube'un AdWords politikaları, YouTube reklam politikaları, YouTube Topluluk Kuralları ve YouTube Hizmet Şartları'na uygun olacağını kabul etmiş olursunuz.

  • Video oynatma sırasında tanıtılan öğeleri göstermeye yönelik zamanlama ayarlarıyla ilgili özellikler yeniden yapılandırıldı:

    • invideoPromotion.timing nesnesi, invideoPromotion.items[].timing klasörüne taşındı. Bu nesne artık invideoPromotion.items[] listesindeki her bir tanıtılan öğe için zamanlama verilerini özelleştirmenize olanak tanıyor.

    • Yeni invideoPromotion.defaultTiming nesnesi, tanıtımınız için varsayılan zamanlama ayarlarını belirtir. Bu ayarlar, kanalınızdaki videolardan biri oynatılırken tanıtılan öğenin ne zaman gösterileceğini tanımlar. Tanıtılan herhangi bir öğenin varsayılan zamanlamasını invideoPromotion.items[].timing nesnesini kullanarak geçersiz kılabilirsiniz.

    • Yeni invideoPromotion.items[].timing.durationMs özelliği, tanıtımın görüntülemesi gereken süreyi milisaniye cinsinden belirtir. invideoPromotion.defaultTiming nesnesi, tanıtılan öğenin varsayılan olarak gösterileceği varsayılan süreyi belirten bir durationMs alanı da içerir.

  • Hem invideoPromotion.items[].type hem de invideoPromotion.items[].videoId özellikleri invideoPromotion.items[].id nesnesine taşındı.

• subscriptions.list yöntemi artık onBehalfOfContentOwner ve onBehalfOfContentOwnerChannel parametrelerini desteklemektedir. Her iki parametre de diğer birkaç yöntem için zaten desteklenmektedir.

• Bir thumbnails.set isteğine verilen API yanıtında, kind özelliğinin youtube#thumbnailListResponse olan değeri youtube#thumbnailSetResponse olarak değiştirildi.

• Aşağıdaki yöntemler için kod örnekleri eklendi:

  • channels.update (Java, Python)
  • playlists.insert (.NET, PHP)
  • subscriptions.insert (PHP, Python)
  • thumbnails.set (PHP, Python)
  • videos.insert (PHP)
  • videos.list (PHP)
  • videos.rate (Python)
  • videos.update (Java, PHP, Python)

  playlistItems.insert yöntemi için kullanılan Python örneğinin de gösterdiği işlev artık videos.rate yöntemiyle işlendiği için bu örneğin kaldırıldığını unutmayın.

• error documentation, mine istek parametresini destekleyen herhangi bir API yönteminde oluşabilecek aşağıdaki yeni istek bağlamı hatasını açıklar:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest	invalidMine	mine parametresi, kimliği doğrulanan kullanıcının YouTube iş ortağı olduğu isteklerde kullanılamaz. mine parametresini kaldırmanız, onBehalfOfContentOwner parametresini kaldırarak YouTube kullanıcısı olarak kimlik doğrulaması yapmanız veya çağrılan yöntem için kullanılabiliyorsa onBehalfOfContentOwnerChannel parametresini sağlayarak iş ortağının kanallarından biri gibi hareket etmeniz gerekir.

8 Ağustos 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• YouTube Data API'yi Kullanmaya Başlama rehberinin Kota Kullanımı bölümü, bir video yüklemesi için belirlenen kota maliyetinde yaklaşık 16.000 birimden yaklaşık 1600 birime yapılan değişikliği yansıtacak şekilde güncellendi.

30 Temmuz 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Bir channelBanner kaynağında, kind özelliğinin youtube#channelBannerInsertResponse olan değeri youtube#channelBannerResource olarak değişti. Bu kaynak, channelBanners.insert isteğine yanıt olarak döndürülür.

• channel kaynağının yeni brandingSettings.channel.profileColor özelliği, kanal içeriğini tamamlayan belirgin bir renk belirtir. Özellik değeri, bir pound işaretidir (#), ardından altı karakterlik onaltılık bir dize gelir (ör. #2793e6).

• API artık bir aboneliğin kanalın tüm etkinlikleri mi yoksa yalnızca yeni yüklemeler için mi olduğunu belirtme özelliğini destekliyor. subscription kaynağının yeni contentDetails.activityType özelliği, aboneye bildirim gönderilecek etkinlik türlerini tanımlar. Geçerli özellik değerleri: all ve uploads.

• videos.list yöntemi, YouTube'daki en popüler videoların grafiğini almak için yeni parametreleri destekler:

  • chart parametresi, almak istediğiniz grafiği tanımlar. Şu anda mostPopular değeri desteklenmektedir. chart parametresinin bir filtre parametresi olduğunu, dolayısıyla diğer filtre parametreleriyle (id ve myRating) aynı istekte kullanılamayacağını unutmayın.
  • videoCategoryId parametresi, grafiğin alınması gereken video kategorisini tanımlar. Bu parametre yalnızca chart parametresiyle birlikte kullanılabilir. Varsayılan olarak, grafikler belirli bir kategoriyle sınırlı değildir.

• video kaynağının yeni topicDetails.relevantTopicIds[] özelliğinde, videoyla veya içeriğiyle alakalı Freebase konu kimliklerinin listesi yer alır. Bu konuların konularından bahsedilebilir veya videoda bu konulardan bahsedilebilir.

• video kaynağının recordingDetails.location.elevation özelliği recordingDetails.location.altitude, fileDetails.recordingLocation.location.elevation özelliği ise fileDetails.recordingLocation.location.altitude olarak yeniden adlandırıldı.

• video kaynağının contentDetails.contentRating nesnesi, bir videonun MPAA derecelendirmeleri, TVPG derecelendirmeleri gibi çeşitli derecelendirme şemaları kapsamında aldığı derecelendirmeleri belirtir. API artık her derecelendirme sistemi için videonun derecelendirilmediğini belirten bir derecelendirme değerini desteklemektedir. MPAA derecelendirmeleri için "derecelendirilmemiş" Derecelendirme, filmin kesilmiş versiyonu resmi derecelendirme alan filmlerin kesilmemiş versiyonlarını tanımlamak için sıkça kullanılır.

• video kaynağının yeni contentDetails.contentRating.ytRating özelliği, yaş kısıtlaması olan içerikleri tanımlar. YouTube, videonun 18 yaşından küçük kullanıcılar için uygun olmayan içerik barındırdığını tespit ederse özellik değeri ytAgeRestricted olur. Özellik yoksa veya özellik değeri boşsa içerik, yaş kısıtlamalı olarak tanımlanmamıştır.

• channels.list yönteminin mySubscribers parametresi kullanımdan kaldırıldı. Kimliği doğrulanan kullanıcının kanalının abone listesini almak için subscriptions.list yöntemini ve mySubscribers parametresini kullanın.

• channelBanners.insert, channels.update, videos.getRating ve videos.rate yöntemlerinin tümü artık onBehalfOfContentOwner parametresini desteklemektedir. Bu parametre, kimliği doğrulanmış kullanıcının, parametre değerinde belirtilen içerik sahibi adına hareket ettiğini gösterir.

• channels.update yönteminin dokümanları, bu yöntemin channel kaynağının brandingSettings nesnesini ve alt özelliklerini güncellemek için kullanılabileceğini yansıtacak şekilde güncellendi. Dokümanlarda artık channel kaynağının invideoPromotion nesnesi için ayarlayabileceğiniz güncellenmiş özellik listesi de listelenmektedir.

• error documentation hükümlerinde aşağıdaki yeni hatalar açıklanmaktadır:

  Hata türü	Hata ayrıntısı	Açıklama
  forbidden	accountDelegationForbidden	Bu hata belirli bir API yöntemine özgü değildir. Bu uyarı, kimliği doğrulanmış kullanıcının, belirtilen Google Hesabı adına işlem yapma yetkisine sahip olmadığını gösterir.
  forbidden	authenticatedUserAccountClosed	Bu hata belirli bir API yöntemine özgü değildir. Kimliği doğrulanmış kullanıcının YouTube hesabının kapatıldığını belirtir. Kullanıcı başka bir Google Hesabı adına hareket ediyorsa bu hata diğer hesabın kapatıldığını gösterir.
  forbidden	authenticatedUserAccountSuspended	Bu hata belirli bir API yöntemine özgü değildir. Bu ileti, kimliği doğrulanmış kullanıcının YouTube hesabının askıya alındığını gösterir. Kullanıcı başka bir Google Hesabı adına hareket ediyorsa bu hata diğer hesabın askıya alındığını gösterir.
  forbidden	authenticatedUserNotChannel	Bu hata belirli bir API yöntemine özgü değildir. API sunucusunun, API isteğiyle ilişkili kanalı tanımlayamadığını gösterir. İstek yetkilendirilmişse ve onBehalfOfContentOwner parametresini kullanıyorsa onBehalfOfContentOwnerChannel parametresini de ayarlamanız gerekir.
  forbidden	cmsUserAccountNotFound	Bu hata belirli bir API yöntemine özgü değildir. İçerik yönetim sistemi kullanıcısının, belirtilen içerik sahibi adına işlem yapmasına izin verilmiyor.
  notFound	contentOwnerAccountNotFound	Bu hata belirli bir API yöntemine özgü değildir. Belirtilen içerik sahibi hesabı bulunamadı.
  badRequest	invalidPart	Bu hata belirli bir API yöntemine özgü değildir. İsteğin part parametresi aynı anda yazılamayan bölümleri belirtiyor.
  badRequest	videoChartNotFound	İstek, desteklenmeyen veya kullanılamayan bir video grafiği belirttiğinde videos.list yöntemi bu hatayı döndürür.
  notFound	videoNotFound	videos.update yöntemi, güncellemeye çalıştığınız videonun bulunamadığını belirtmek için bu hatayı döndürür. Doğru olduğundan emin olmak için istek gövdesindeki id özelliğinin değerini kontrol edin.

10 Haziran 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channels.list yönteminin yeni forUsername parametresi, YouTube kullanıcı adını belirterek kanal hakkında bilgi alabilmenizi sağlar.

• activities.list yöntemi artık regionCode parametresini destekliyor. Bu parametre, API'ye belirtilen ülkeyle ilgili sonuçlar döndürmesi için talimat veriyor. YouTube, yetkili kullanıcının YouTube'daki önceki etkinliği etkinlik feed'ini oluşturmak için yeterli bilgi sağlamadığında bu değeri kullanır.

• Oynatma listesi kaynakları artık snippet.tags özelliğini içeriyor. Mülk, yalnızca kendi oynatma listeleriyle ilgili veri alan yetkili kullanıcılara döndürülür. Yetkili kullanıcılar, playlists.insert veya playlists.update yöntemlerini çağırırken oynatma listesi etiketlerini de ayarlayabilir.

• Daha önce channels.list ve search.list yöntemleri için desteklenen onBehalfOfContentOwner parametresi, artık videos.insert, videos.update ve videos.delete yöntemleri için de desteklenmektedir. Bu parametre videos.insert yöntemine yapılan bir çağrıda kullanıldığında, isteğin videonun ekleneceği kanalı tanımlayan yeni onBehalfOfContentOwnerChannel parametresi için bir değer de belirtmesi gerektiğini unutmayın. Kanal, onBehalfOfContentOwner parametresinin belirttiği içerik sahibine bağlı olmalıdır.

  Parametre, isteğin yetkilendirme kimlik bilgilerinin parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube CMS kullanıcısını tanımladığını gösterir. Kullanıcının kimlik doğrulaması yaptığı CMS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.

  Bu parametre, birçok farklı YouTube kanalına sahip olan ve bunları yöneten içerik iş ortakları için tasarlanmıştır. Parametre, iş ortaklarının bir kez kimlik doğrulaması yapmasını ve her bir kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan tüm video ve kanal verilerine erişim elde etmesini sağlar.

  Özellikle bu sürümle ilgili olarak, parametre artık bir içerik iş ortağının sahip olduğu YouTube kanallarından video eklemesine, güncellemesine veya silmesine olanak tanıyor.

• error documentation hükümlerinde aşağıdaki yeni hatalar açıklanmaktadır:

  Hata türü	Hata ayrıntısı	Açıklama
  forbidden	insufficientCapabilities	Bu hata belirli bir API yöntemine özgü değildir. API'yi çağıran İYS kullanıcısının, istenen işlemi gerçekleştirmek için yeterli izne sahip olmadığını gösterir. Bu hata, çeşitli API yöntemleri için desteklenen onBehalfOfContentOwner parametresinin kullanımıyla ilişkilidir.
  unauthorized	authorizationRequired	activities.list yöntemi, istek home parametresini kullandığı halde düzgün şekilde yetkilendirilmediğinde bu hatayı döndürür.

• channels kaynağında, kanal kimliği zaten kaynağın id özelliği kullanılarak belirtildiği için invideoPromotion.channelId özelliği kaldırıldı.

• Yeni Kanal Kimlikleriyle Çalışma kılavuzunda, API'nin kanal kimliklerini nasıl kullandığı açıklanmaktadır. Bu rehber, API'nın önceki sürümünden geçiş yapan ve default kullanıcısı için içerik isteyen veya her YouTube kanalının benzersiz bir kullanıcı adına sahip olduğu fikrini temel alan uygulamalara sahip geliştiriciler için özellikle yararlı olabilir.

22 Mayıs 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni channelBanners.insert yöntemi, channel kaynağının yeni brandingSettings.image.bannerExternalUrl özelliğini kullanarak daha sonra kanal için banner resmi olarak ayarlanabilecek bir banner resmi yüklemenizi sağlar.

• channels.update yönteminin dokümanları, yöntem çağrılırken değiştirilebilecek özellikleri listeleyecek şekilde güncellendi.

• video kaynak dokümanlarında artık unspecified, suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[] ve suggestions.editorSuggestions[] özellikleri için geçerli bir özellik değeri olarak listelenmiyor.

• videos.list yönteminin maxResults parametresi artık 5 varsayılan değerine sahip.

• error documentation artık channelBanners.insert ve subscriptions.list yöntemleriyle ilgili hataları listeliyor. Ayrıca channels.update yöntemine ilişkin bazı yeni hataları da listeler.

14 Mayıs 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Bağımsız sayfalarda artık Java, .NET, PHP ve Ruby için kod örnekleri listelenmektedir.

• Python kod örneklerinin listelendiği sayfada artık abonelik ekleme, oynatma listesi oluşturma ve video güncelleme ile ilgili örnekler bulunuyor.

10 Mayıs 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• YouTube, deneysel API özelliklerini ve hizmetlerini artık tanımlamamaktadır. Bunun yerine artık kullanımdan kaldırma politikasına tabi YouTube API'lerinin listesini sunuyoruz.

8 Mayıs 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Kanal kaynakları artık inVideoPromotion nesnesini destekliyor. Bu nesne, kanalla ilişkili bir tanıtım kampanyasıyla ilgili bilgileri içerir. Kanallar, bir tanıtılan videonun küçük resimlerini kanaldaki videolar oynatılırken video oynatıcıda göstermek için video içi tanıtım kampanyalarını kullanabilir.

  Bir channels.list isteğindeki part parametre değerine invideoPromotion ekleyerek bu verileri alabilirsiniz.

• Yeni channels.update yöntemi, kanalın video içi tanıtım kampanyası verilerini güncellemek için kullanılabilir. Yöntemin yalnızca channel kaynağının invideoPromotion bölümünde yapılan güncellemeleri desteklediğini ve henüz söz konusu kaynağın diğer kısımlarında yapılan güncellemeleri desteklemediğini unutmayın.

2 Mayıs 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Kanal kaynakları artık status.isLinked özelliğini destekliyor. Bu özellik, kanal verilerinin bir YouTube kullanıcı adına mı yoksa Google+ hesabına mı zaten bağlı olduğunu gösteren bir kullanıcıyı tanımlıyor. Bu bağlantılardan birine sahip bir kullanıcının zaten herkese açık bir YouTube kimliği vardır. Bu, video yükleme gibi çeşitli işlemler için bir ön koşuldur.

• Abonelik kaynakları artık subscriberSnippet bölümünü destekliyor. Bu nesne, abonenin kanalı için snippet verilerini içerir.

• API artık, kimliği doğrulanmış kullanıcının bir veya daha fazla videonun yer aldığı bir listeye verdiği derecelendirmeleri alan videos.getRating yöntemini destekliyor.

• videos.list yönteminin yeni myRating parametresi, kimliği doğrulanmış kullanıcının like veya dislike derecelendirmesi ile derecelendirdiği videoların listesini almanıza olanak tanır.

  Hem myRating parametresi hem de id parametresi artık filtre parametreleri olarak kabul edilmektedir. Bu, API isteğinin parametrelerden tam olarak birini belirtmesi gerektiği anlamına gelir. (Önceden, id parametresi bu yöntem için zorunlu bir parametreydi.)

  Yöntem, video derecelendirme bilgilerini almaya çalışan ancak bunu yapmaya uygun şekilde yetkilendirilmemiş istekler için bir forbidden hatası döndürür.

• myRating parametresinin kullanıma sunulmasıyla birlikte videos.list yöntemi, sayfalara ayırmayı destekleyecek şekilde güncellenmiştir. Ancak sayfalama parametrelerinin yalnızca myRating parametresini kullanan istekler için desteklendiğini unutmayın. (id parametresini kullanan istekler için çağrı parametreleri ve bilgileri desteklenmez.)

  • maxResults parametresi, API'nin sonuç kümesinde döndürebileceği maksimum video sayısını belirtir. pageToken parametresi ise almak istediğiniz sonuç kümesindeki belirli bir sayfayı tanımlar.

  • videos.list isteğine yanıt olarak döndürülen youtube#videoListResponse kaynağı artık pageInfo nesnesini içeriyor. Bu nesnede, toplam sonuç sayısı ve mevcut sonuç kümesine dahil edilen sonuçların sayısı gibi ayrıntılar yer almaktadır. youtube#videoListResponse kaynağı, nextPageToken ve prevPageToken özelliklerini de içerebilir. Bunların her biri, sonuç kümesindeki belirli bir sayfayı almak için kullanılabilecek bir jeton sağlar.

• videos.insert yöntemi aşağıdaki yeni parametreleri destekler:

  • autoLevels – YouTube'a videonun ışıklandırmasını ve rengini otomatik olarak iyileştirmesi için bu parametre değerini true olarak ayarlayın.
  • stabilize: YouTube'a kamera hareketlerinden kaynaklanan sarsıntıları kaldırarak videoyu düzenlemesi talimatını vermek için bu parametre değerini true olarak ayarlayın.

• channelTitle özelliği, aşağıdaki kaynaklar için snippet bölümüne eklendi:

  • playlistItem – Özellik, oynatma listesi öğesini ekleyen kanalın adını belirtir.
  • playlist – Bu özellik, oynatma listesini oluşturan kanalın adını belirtir.
  • subscription - Bu özellik, abone olan kanalın adını belirtir.

• Aşağıdaki yöntemler için kod örnekleri eklendi:

  • activities.insert (Ruby)
  • playlistItems.list (.NET)
  • search.list (.NET)
  • subscriptions.insert (Java, Ruby)
  • videos.insert (.NET, Ruby)

• subscriptions.list yönteminin yeni mySubscribers parametresi, kimliği doğrulanmış geçerli kullanıcının abonelerinin listesini almanıza olanak tanır. Bu parametre yalnızca düzgün şekilde yetkilendirilmiş bir istekte kullanılabilir.

  Not: Bu işlev, şu anda channels.list yöntemi için desteklenen mySubscribers parametresinin yerini almak üzere tasarlanmıştır. Bu parametrenin desteği sonlandırılacak.

• Bir video kaynağında, unspecified özellik değeri artık aşağıdaki özelliklerin hiçbiri için olası bir değer değil:

  • fileDetails.fileType
  • fileDetails.videoStreams[].rotation
  • processingDetails.processingStatus
  • processingDetails.processingFailureReason
  • fileDetails.fileType

• Beklenmeyen bir parametre içeren API istekleri artık badRequest hatası döndürüyor ve hatanın nedeni unexpectedParameter olarak bildiriliyor.

• Oynatma listesi zaten izin verilen maksimum sayıda öğe içerdiğinde playlistItems.insert yönteminin döndürdüğü hata. Hata artık forbidden hatası olarak bildiriliyor ve hata nedeni playlistContainsMaximumNumberOfVideos olarak bildiriliyor.

19 Nisan 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni videos.rate yöntemi, kullanıcının bir video için like ya da dislike derecelendirmesini belirlemesine veya videodaki derecelendirmeyi kaldırmasına olanak tanır.

  Hata dokümanları da API'nin videos.rate yöntem çağrısına yanıt olarak döndürebileceği hataları listeleyecek şekilde güncellendi.

• Küçük resimler artık API dokümanlarında ayrı bir kaynak olarak tanımlanıyor ve yeni thumbnails.set yöntemi, YouTube'a özel video küçük resmi yükleyip video için ayarlamanıza olanak tanıyor.

  Hata dokümanları da API'nin thumbnails.set yöntem çağrısına yanıt olarak döndürebileceği hataları listeleyecek şekilde güncellendi.

  Bu değişikliğin, küçük resim resimlerini döndüren mevcut kaynakları etkilemediğini unutmayın. Küçük resim görüntüleri, bu kaynaklarda daha önce olduğu gibi döndürülür. Ancak dokümanlarda artık API'nin döndürebileceği farklı küçük resim boyutlarının adları listelenmektedir.

• channel kaynağının yeni brandingSettings bölümü, kanalın kanal sayfası ve video izleme sayfalarıyla ilgili ayarları, metinleri ve resimleri tanımlar.

• playlistItem kaynağı aşağıdaki yeni özellikleri içerir:

  • Yeni status nesnesi, oynatma listesi öğesiyle ilgili durum bilgilerini içerir ve status.privacyStatus özelliği, oynatma listesi öğesinin gizlilik durumunu tanımlar.

• video kaynağı aşağıdaki yeni özellikleri içerir:

  • status.publicStatsViewable özelliği, izleme sayfasındaki genişletilmiş video istatistiklerinin herkes tarafından görüntülenip görüntülenemeyeceğini belirtir. Varsayılan olarak bu istatistikler görüntülenebilirdir. Videonun görüntüleme sayısı ve kullanıcı oyları gibi istatistikler, bu mülkün değeri false olarak ayarlanmış olsa bile herkes tarafından görülebilir. Bu özelliğin değerini, videos.insert veya videos.update yöntemini çağırırken ayarlayabilirsiniz.

  • contentDetails.contentRating nesnesi, videonun çeşitli derecelendirme şemaları kapsamında aldığı derecelendirmeleri içerir. Aşağıdaki listede, desteklenen derecelendirme sistemleri tanımlanmaktadır ve her derecelendirme sistemiyle ilişkilendirilmiş tesislere bağlantı verilmiştir. Tesis tanımları, her bir sistem için desteklenen derecelendirme değerlerini tanımlar.

    Ülke	Derecelendirme sistemi	Özellik
    Amerika Birleşik Devletleri	Amerika Sinema Filmleri Derneği (MPAA)	contentDetails.contentRating.mpaaRating
    Amerika Birleşik Devletleri	TV Ebeveyn Yönergeleri	contentDetails.contentRating.tvpgRating
    Avustralya	Avustralya Sınıflandırma Kurulu (ACB)	contentDetails.contentRating.acbRating
    Brezilya	Departamento de Justiça, Classificação, Qualificação e Títulos	contentDetails.contentRating.djctqRating
    Kanada	Kanada Ev Videosu Derecelendirme Sistemi (CHVRS)	contentDetails.contentRating.chvrsRating
    Fransa	Centre National du cinéma et de l'image animée (Fransız Kültür Bakanlığı)	contentDetails.contentRating.fmocRating
    Almanya	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	contentDetails.contentRating.fskRating
    İngiltere	İngiliz Film Sınıflandırma Kurulu (BBFC)	contentDetails.contentRating.bbfcRating
    Hindistan	Central Board of Film Certification (CBFC)	contentDetails.contentRating.cbfcRating
    Japonya	映倫管設委設会 (EIRIN)	contentDetails.contentRating.eirinRating
    Kore	六물礣이퀄muyor denir (KMRB)	contentDetails.contentRating.kmrbRating
    Meksika	Radyo, Televizyon ve Sinematografi Genel Müdürlüğü (RTC)	contentDetails.contentRating.rtcRating
    Yeni Zelanda	Film ve Edebiyat Sınıflandırma Ofisi	contentDetails.contentRating.oflcRating
    Rusya	Rusya Federasyonu Ulusal Film Tescili	contentDetails.contentRating.russiaRating
    İspanya	Instituto de la Cinematografía y de las Artes AudioVisuales (ICAA)	contentDetails.contentRating.icaaRating

• playlistItems.update yönteminin dokümanları, istek gövdesi olarak gönderilen kaynakta snippet.resourceId özelliğinin belirtilmesi gerektiğini yansıtacak şekilde güncellendi.

• search.list yöntemi artık aşağıdaki işlevleri desteklemektedir:

  • Yeni forMine parametresi, aramayı yalnızca kimliği doğrulanmış kullanıcının videolarını alacak şekilde kısıtlar.

  • order parametresi artık sonuçları başlığa (order=title) veya video sayısına göre azalan düzende (order=videoCount) alfabetik olarak sıralama özelliğini destekliyor.

  • Yeni safeSearch parametresi, arama sonuçlarında kısıtlanmış içerik bulunup bulunmadığını gösterir.

• videos.insert yöntemi, aşağıdaki tabloda listelenen çeşitli yeni hataları destekler:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest	invalidCategoryId	snippet.categoryId özelliği geçersiz bir kategori kimliği belirtiyor. Desteklenen kategorileri almak için videoCategories.list yöntemini kullanın.
  badRequest	invalidRecordingDetails	metadata specifies invalid recording details.
  badRequest	invalidVideoGameRating	İstek meta verileri geçersiz bir video oyunu derecelendirmesi belirtiyor.
  badRequest	invalidVideoMetadata	İsteğin meta verileri geçersiz.

• onBehalfOfContentOwner parametresi, videos.update ve videos.delete yöntemleri için desteklenen parametreler listesinden kaldırıldı.

12 Mart 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• channelTitle özelliği, aşağıdaki kaynaklar için snippet bölümüne eklendi:

  • activity - Bu özellik, etkinlikten sorumlu kanalın adını belirtir.
  • search – Bu özellik, arama sonucunun tanımladığı kaynakla ilişkili kanalın adını belirtir.
  • video: Bu özellik, videoyu yükleyen kanalın adını belirtir.

• search.list yöntemi aşağıdaki yeni parametreleri destekler:

  • channelType parametresi, tüm kanalları almak veya yalnızca programları almak için kanal aramalarını kısıtlamanıza olanak tanır.

  • videoType parametresi, video aramalarını tüm videoları almak veya yalnızca filmleri ya da yalnızca program bölümlerini almak için kısıtlamanıza olanak tanır.

• video kaynağının recordingDetails bölümünün tanımı, bir video için nesnenin yalnızca videonun coğrafi konum verileri veya kayıt süresi ayarlanmışsa döndürüleceğini belirtecek şekilde güncellendi.

• playlistItems.update yöntemi artık invalidSnippet hatası döndürüyor. Bu hata, API isteği geçerli bir snippet belirtmiyorsa döndürülüyor.

• Birçok API yöntemi, yalnızca YouTube içerik iş ortaklarına yönelik yeni parametreleri destekler. YouTube içerik iş ortakları arasında film ve televizyon stüdyoları, plak şirketleri ve içeriklerini YouTube'da sunan diğer içerik üreticiler yer alır.

  • onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube CMS kullanıcısını tanımladığını gösterir. Kullanıcının kimlik doğrulaması yaptığı CMS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.

    Bu parametre, birçok farklı YouTube kanalına sahip olan ve bunları yöneten içerik iş ortakları için tasarlanmıştır. Parametre, iş ortaklarının bir kez kimlik doğrulaması yapmasını ve her bir kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan tüm video ve kanal verilerine erişim elde etmesini sağlar.

    channels.list, search.list, videos.delete, videos.list ve videos.update yöntemlerinin tümü bu parametreyi destekler.

  • channels.list yöntemi tarafından desteklenen managedByMe parametresi, API'ye onBehalfOfContentOwner parametresinin belirttiği içerik sahibinin sahip olduğu tüm kanalları döndürmesi talimatını verir.

  • search.list yöntemi tarafından desteklenen forContentOwner parametresi, API'ye arama sonuçlarını yalnızca onBehalfOfContentOwner parametresinin belirttiği içerik sahibine ait kaynakları içerecek şekilde kısıtlama talimatı verir.

25 Şubat 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• API, video kaynakları için birçok yeni bölüm ve özelliği destekler:

  • Yeni fileDetails, processingDetails ve suggestions bölümleri, video sahiplerine yükledikleri videolar hakkında bilgi sağlar. Bu veriler, video yükleme olanağı sunan uygulamalarda çok kullanışlıdır ve aşağıdakileri içerir:

    • işleme durumu ve ilerleme durumu
    • video işlenirken karşılaşılan hatalar veya diğer sorunlar
    • küçük resimlerin kullanılabilirliği
    • video veya meta veri kalitesini iyileştirmeye yönelik öneriler
    • YouTube'a yüklenen orijinal dosyayla ilgili ayrıntılar

    Bu bölümlerin tümüne yalnızca video sahibi erişebilir. Aşağıdaki listede yeni parçalar kısaca açıklanmaktadır. video kaynak dokümanlarında ise her bir bölümün içerdiği tüm özellikler tanımlanmaktadır.

    • fileDetails nesnesi, YouTube'a yüklenen video dosyasıyla ilgili dosyanın çözünürlüğü, süresi, ses ve video codec'leri, akış bit hızları ve diğer bilgileri içerir.

    • processingProgress nesnesi, YouTube'un yüklenen video dosyasını işleme süreciyle ilgili bilgiler içerir. Nesnenin özellikleri, mevcut işleme durumunu tanımlar ve YouTube'un videoyu işlemeyi tamamlaması için kalan süreyi tahmin eder. Bu bölüm, video için farklı veri veya içerik türlerinin (ör. dosya ayrıntıları ya da küçük resimler) kullanılabilir olup olmadığını da belirtir.

      Bu nesne, videoyu yükleyen kullanıcının YouTube'un yüklenen video dosyasını işleme sürecinde kaydettiği ilerlemeyi izleyebilmesi için anket yapmak üzere tasarlanmıştır.

    • suggestions nesnesi, video kalitesini veya yüklenen videonun meta verilerini iyileştirme fırsatlarını belirleyen önerileri içerir.

  • contentDetails bölümünde dört yeni özellik yer alır. Bu özellikler, kimliği doğrulanmamış isteklerle alınabilir.

    • dimension – Videonun 2D veya 3D olarak sunulup sunulmadığını gösterir.
    • definition: Videonun standart veya yüksek tanımlı olup olmadığını gösterir.
    • caption: Video için altyazı olup olmadığını gösterir.
    • licensedContent: Videoda, bir YouTube içerik iş ortağı tarafından hak talebinde bulunulan içeriklerin bulunup bulunmadığını gösterir.

  • status bölümü iki yeni mülk içerir. Video sahipleri, video eklerken veya güncellerken her iki özellik için de değer ayarlayabilir. Bu özellikler, kimliği doğrulanmamış isteklerle de alınabilir.

    • embeddable: Videonun başka bir web sitesine yerleştirilip yerleştirilemeyeceğini belirtir.
    • license – Videonun lisansını belirtir. Geçerli değerler creativeCommon ve youtube değerleridir.

• part parametresinin tanımı, yukarıda açıklanan yeni eklenen bölümlerin yanı sıra yanlışlıkla çıkarılan recordingDetails bölümünü listelemek üzere videos.list, videos.insert ve videos.update yöntemleri için güncellendi.

• channel kaynağının yeni contentDetails.googlePlusUserId özelliği, kanalla ilişkilendirilmiş Google+ profili kimliğini belirtir. Bu değer, Google+ profiline bağlantı oluşturmak için kullanılabilir.

• Artık her bir küçük resim nesnesi, resmin genişliğini ve yüksekliğini belirtir. Küçük resimler şu anda activity, channel, playlist, playlistItem, search result, subscription ve video kaynaklarda döndürülüyor.

• playlistItems.list artık yalnızca belirtilen videoyu temsil eden oynatma listesi öğesini almak için playlistId parametresiyle birlikte kullanılabilen videoId parametresini desteklemektedir.

  Parametrenin tanımladığı video oynatma listesinde bulunamazsa API, notFound hatası döndürür.

• Hata dokümanlarında yeni bir forbidden hatası açıklanmaktadır. Bu hata, isteğin istenen işlem için düzgün şekilde yetkilendirilmediğini gösterir.

• channel kaynağının snippet.channelId özelliği kaldırıldı. Kaynağın id özelliği aynı değeri sağlıyor.

30 Ocak 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Yeni hata sayfasında, API'nin döndürebileceği hatalar listelenir. Sayfada, birden çok farklı API yönteminde oluşabilecek genel hataların yanı sıra yönteme özel hatalar da bulunmaktadır.

16 Ocak 2013

Bu güncelleme aşağıdaki değişiklikleri içerir:

• Aşağıdaki listede gösterilen yöntemler ve diller için artık kod örnekleri kullanılabilir:

  • activities.insert - Java
  • playlistItems.insert - Python
  • playlistItems.list - Java, JavaScript, PHP, Python, Ruby
  • playlists.insert - Java, JavaScript, Python
  • search.list - Java, JavaScript, Python, Ruby
  • videos.insert - Java

• activity kaynağı artık YouTube tarafından otomatik olarak oluşturulan YouTube kanalına video eklediğinde gerçekleşen channelItem işlemini bildirebilir. (YouTube, YouTube web sitesinde önemli bir yeri olan konuları algoritmik olarak tespit eder ve bu konular için otomatik olarak kanallar oluşturur.)

• Aşağıdaki search.list parametre güncellendi:

  • q parametresi artık filtre olarak atanmış değil. Yani ....
  • relatedToVideo parametresi, relatedToVideoId olarak yeniden adlandırıldı.
  • published parametresi, aşağıda açıklanan publishedAfter ve publishedBefore adlı iki yeni parametreyle değiştirilmiştir.

• search.list yöntemi aşağıdaki yeni parametreleri destekler:

  Parametre adı	Değer	Açıklama
  channelId	string	Belirtilen kanal tarafından oluşturulan kaynakları döndürür.
  publishedAfter	datetime	Belirtilen süreden sonra oluşturulan kaynakları döndürür.
  publishedBefore	datetime	Belirtilen zamandan önce oluşturulan kaynakları döndürür.
  regionCode	string	Belirtilen ülkeyle ilgili kaynakları döndürün.
  videoCategoryId	string	Video arama sonuçlarını, yalnızca belirtilen video kategorisiyle ilişkili videoları içerecek şekilde filtreleyin.
  videoEmbeddable	string	Video arama sonuçlarını, yalnızca web sayfasındaki yerleşik oynatıcıda oynatılabilecek videoları içerecek şekilde filtreleyin. Yalnızca yerleştirilebilir videoları almak için parametre değerini true olarak ayarlayın.
  videoSyndicated	string	Video arama sonuçlarını, yalnızca YouTube.com dışında oynatılabilen videoları içerecek şekilde filtreleyin. Yalnızca ortak kullanılan videoları almak için parametre değerini true olarak ayarlayın.

• Birçok API kaynağı yeni özellikleri destekler. Aşağıdaki tabloda kaynaklar ve yeni özellikleri açıklanmaktadır:

  Kaynak	Mülk adı	Değer	Açıklama
  activity	contentDetails.playlistItem.playlistItemId	string	YouTube'un oynatma listesindeki öğeyi benzersiz şekilde tanımlamak için atadığı oynatma listesi öğe kimliği.
  activity	contentDetails.channelItem	object	Bir kanala eklenmiş kaynak hakkında bilgileri içeren nesne. Bu özellik yalnızca snippet.type, channelItem ise mevcuttur.
  activity	contentDetails.channelItem.resourceId	object	Kanala eklenen kaynağı tanımlayan bir nesne. Diğer resourceId özelliklerinde olduğu gibi, video veya oynatma listesi gibi kaynak türünü belirten bir kind özelliği içerir. Ayrıca, kaynağı benzersiz şekilde tanımlayan kimliği belirten çeşitli özelliklerden birini (videoId, playlistId vb.) de içerir.
  channel	status	object	Bu nesne, kanalın gizlilik durumuyla ilgili bilgileri içerir.
  channel	status.privacyStatus	string	Kanalın gizlilik durumu. Geçerli değerler private ve public değerleridir.
  playlist	contentDetails	object	Bu nesne, oynatma listesinin içeriğiyle ilgili meta veriler içeriyor.
  playlist	contentDetails.itemCount	unsigned integer	Oynatma listesindeki videoların sayısı.
  playlist	player	object	Bu nesne, oynatma listesini yerleşik bir oynatıcıda oynatmak için kullanacağınız bilgileri içerir.
  playlist	player.embedHtml	string	Oynatma listesini oynatan bir video oynatıcıyı yerleştiren <iframe> etiketi.
  video	recordingDetails	object	Bu nesne, videonun kaydedildiği yeri ve zamanı tanımlayan veya açıklayan bilgileri içerir.
  video	recordingDetails.location	object	Bu nesne, videoyla ilişkilendirilen coğrafi konum bilgilerini içerir.
  video	recordingDetails.location.latitude	double	Derece cinsinden enlem.
  video	recordingDetails.location.longitude	double	Derece cinsinden boylam.
  video	recordingDetails.location.elevation	double	Yeryüzünden metre cinsinden yükseklik.
  video	recordingDetails.locationDescription	string	Videonun kaydedildiği konumun metin açıklaması.
  video	recordingDetails.recordingDate	datetime	Videonun kaydedildiği tarih ve saat. Değer, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir.

• Birçok API yönteminin dokümanlarında artık istek gövdesinde belirtilmesi gereken veya istek gövdesindeki değerlere göre güncellenen özellikler tanımlanmaktadır. Aşağıdaki tabloda bu yöntemler ve gerekli veya değiştirilebilir özellikler listelenmiştir.

  Not: Diğer yöntemlere ilişkin belgelerde, gerekli ve değiştirilebilir özellikler listeleniyor olabilir.

  Yöntem	Özellikler
  activities.insert	Zorunlu özellikler: snippet.description Değiştirilebilir özellikler: snippet.description contentDetails.bulletin.resourceId
  playlists.update	Zorunlu özellikler: id
  playlistItems.update	Zorunlu özellikler: id
  videos.update	Zorunlu özellikler: id

• API artık aynı kanalda bulunan bir oynatma listesiyle aynı başlığa sahip bir oynatma listesini oluşturmaya veya güncellemeye çalışırsanız playlistAlreadyExists hatası bildirmez.

• Birçok API yöntemi yeni hata türlerini destekler. Aşağıdaki tabloda yöntem ve yeni desteklenen hatalar tanımlanmaktadır:

  Yöntem	Hata türü	Hata ayrıntısı	Açıklama
  guideCategories.list	notFound	notFound	id parametresiyle tanımlanan rehber kategorisi bulunamıyor. Geçerli değerlerin bir listesini almak için guideCategories.list yöntemini kullanın.
  playlistItems.delete	forbidden	playlistItemsNotAccessible	İstek, belirtilen oynatma listesi öğesini silmek için gerektiği gibi yetkilendirilmemiş.
  videoCategories.list	notFound	videoCategoryNotFound	id parametresiyle tanımlanan video kategorisi bulunamıyor. Geçerli değerlerin bir listesini almak için videoCategories.list yöntemini kullanın.