Düzeltme Geçmişi

Bu sayfada, YouTube Data API (v3) değişiklikleri ve doküman güncellemeleri listelenmiştir. Bu değişiklik kaydına abone olun.

30 Ekim 2024

API artık gerçekçi Değiştirilmiş veya Yapay (D/Y) içerik barındıran videoları tanımlama özelliğini destekliyor. A/S içeriğiyle ilgili YouTube politikaları hakkında daha fazla bilgi edinin.

A/S içeriğine örnek olarak aşağıdakiler verilebilir:

• Gerçek bir insanı, söylemediği veya yapmadığı bir şeyi söylemiş ya da yapmış gibi gösterme
• Gerçek bir olayın veya yerin kamera görüntülerini değiştirme
• Gerçekte meydana gelmese de gerçekçi görünen bir sahne oluşturma

Bir videonun A/S içeriği içerip içermediğini belirtmek için status.containsSyntheticMedia özelliğini ayarlayın. Bu özellik, videos.insert veya videos.update yöntemleri çağrılırken ayarlanabilir. Ayarlanırsa özellik video kaynağında döndürülür.

30 Nisan 2024

Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

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

API artık kanal tartışmaları ekleme veya alma özelliğini desteklemiyor. Bu değişiklik, YouTube web sitesinde desteklenen işlevle tutarlıdır. YouTube web sitesinde kanallara yorum gönderilmesi desteklenmez.

13 Mart 2024

Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

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

captions.insert ve captions.update yöntemleri için sync parametresinin desteği sonlandırıldı. YouTube, 12 Nisan 2024'ten itibaren bu parametreyi desteklemeyecek.

Bu değişiklik nedeniyle geliştiricilerin altyazı parçaları eklerken veya güncellerken zamanlama bilgilerini eklemesi gerekir. Aksi takdirde yükleme başarısız olur.

12 Mart 2024

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

captions kaynağının dokümanları, snippet.name alanının izin verilen maksimum uzunluğunun 150 karakter olduğunu belirtecek şekilde güncellendi. Parça adı bundan uzunsa API nameTooLong hatası döndürür.

7 Mart 2024

Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

channel kaynak mülkünün brandingSettings.channel.moderateComments desteği sonlandırıldı. YouTube, parametreyi 7 Mart 2024'ten itibaren desteklemeyecek.

31 Ocak 2024

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

channels.list yönteminin yeni forHandle parametresi, bir kanalın YouTube herkese açık kullanıcı adını belirterek kanalla ilgili bilgileri almanızı sağlar.

9 Kasım 2023

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

12 Eylül 2023

Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

comments.markAsSpam yöntemi birkaç yıldır kullanımdan kaldırılmıştır. Bu yöntem YouTube'da zaten desteklenmiyor ve API üzerinden de artık desteklenmiyor.

comments.markAsSpam yöntemine atıfta bulunan tüm belgelere desteğin sonlandırılmasıyla ilgili bir bildirim eklendi.

22 Ağustos 2023

search.list yöntemi artık videoPaidProductPlacement parametresini destekliyor. Bu parametre, arama sonuçlarını yalnızca içerik üreticinin ücretli tanıtım içerdiğini belirttiği videoları içerecek şekilde filtrelemenize olanak tanır.

18 Ağustos 2023

video kaynağının liveStreamingDetails.concurrentViewers tanımı, YouTube Data API'nin döndürdüğü eşzamanlı izleyici sayılarının, YouTube Analytics üzerinden kullanılabilen işlenmiş ve spam'den arındırılmış eşzamanlı izleyici sayılarından farklı olabileceğini belirtecek şekilde güncellendi. Canlı yayın metrikleri hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.

7 Ağustos 2023

12 Haziran 2023'te duyurulduğu üzere, search.list yönteminin relatedToVideoId parametresinin desteği sonlandırıldı. Bu parametre artık desteklenmiyor ve parametreye yapılan referanslar API belgelerinden kaldırıldı.

28 Haziran 2023

thumbnails.set yöntemi artık uploadRateLimitExceeded hatasını destekliyor. Bu hata, kanalın son 24 saat içinde çok fazla küçük resim yüklediğini ve daha sonra tekrar denemesi gerektiğini gösterir.

12 Haziran 2023

Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

search.list yönteminin relatedToVideoId parametresi kullanımdan kaldırıldı. YouTube, 7 Ağustos 2023'ten itibaren parametresini desteklemeyecektir.

Şu anda search.list yönteminin dokümanına desteğin sonlandırılmasıyla ilgili bir bildirim eklendi. Bu parametre, 7 Ağustos 2023'te veya sonrasında search.list dokümanlarından tamamen kaldırılacaktır.

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

22 Ağustos 2022

video.statistics alanları için tür ek açıklamaları, imzalanmamış uzun değerden dize olarak düzeltildi.

5 Ağustos 2022

YouTube, altyazı kimliklerinin oluşturulma şeklini değiştirdi ve bu değişiklik kapsamında tüm altyazı kanallarına yeni altyazı kimlikleri atadı. Bu değişiklik, caption_id değerleri depolayan uygulamalar için geriye dönük uyumlu olmayan bir değişiklik olabilir ancak caption_id değerleri depolamayan uygulamaları etkilemez.

Şu andan 1 Aralık 2022'ye kadar captions.list, captions.update, captions.download ve captions.delete yöntemleri hem eski hem de yeni altyazı parçası kimliklerini destekleyecektir. Ancak YouTube, 1 Aralık 2022'de veya sonrasında eski altyazı parçası kimliklerini desteklemeyi durduracak. Bu tarihten itibaren, bu API yöntemlerinden herhangi birinin eski bir altyazı parçası kimliğiyle çağrılması captionNotFound hatasıyla sonuçlanacaktır.

Bu değişikliğe hazırlanmak için şu andan 1 Aralık 2022'ye kadar saklanan tüm altyazı parçası verilerini tamamen değiştirmeyi planlamanız gerekir. Bu, altyazı parçası verilerini depoladığınız tüm videolarda, şu anda depolanan verileri silmeniz gerektiği anlamına gelir. Ardından, videonun mevcut altyazı parçası grubunu almak için captions.list yöntemini çağırmanız ve verileri normalde yaptığınız gibi API yanıtında depolamanız gerekir.

12 Temmuz 2022

YouTube API Hizmetleri Hizmet Şartları güncellendi. Daha fazla bilgi için lütfen YouTube API Hizmetleri Hizmet Şartları - Düzeltme Geçmişi'ne bakın.

27 Nisan 2022

videos.insert yöntemi açıklaması, yüklenen videoların maksimum dosya boyutunun 128 GB'tan 256 GB'a yükseldiğ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 değil dokümanda yapılan bir düzeltmeyi temsil eder.

15 Aralık 2021

18 Kasım 2021'de duyurduğumuz üzere, YouTube platformunun tamamında video beğenmeme sayılarını gizli hale getiren değişiklikler ile birlikte video kaynağının statistics.dislikeCount mülkü artık gizlidir.

Bu değişiklik hakkında daha fazla bilgiyi YouTube'un resmi blogunda bulabilirsiniz.

18 Kasım 2021

YouTube platformunun tamamında videoların beğenmeme sayılarını gizli hale getirmeyle ilgili değişiklikler kapsamında, video kaynağının statistics.dislikeCount mülkü 13 Aralık 2021 itibarıyla gizli hale getirilecek. Bu, mülkün yalnızca API isteği video sahibi tarafından kimliği doğrulanmışsa videos.list uç noktasından gelen bir API yanıtına dahil edileceği anlamına gelir.

videos.rate uç noktası bu değişiklikten etkilenmez.

Beğenmeme sayılarını herkese açık olarak göstermeyen ancak API istemcileri için beğenmeme sayısına ihtiyaç duyan geliştiriciler, istisna kapsamında izin verilenler listesine eklenmek için başvuruda bulunabilir. Muafiyet başvurusunda bulunmak için bu başvuru formunu doldurmanız gerekir.

Bu değişiklik hakkında daha fazla bilgiyi YouTube'un resmi blogunda bulabilirsiniz.

2 Temmuz 2021

Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

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

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

1 Temmuz 2021

YouTube'un API Hizmetleri'ni kullanan tüm geliştiricilerin,10.000 birimlik varsayılan kota tahsisinden daha fazla kota alabilmeleri için bir API Uygunluk Denetimi tamamlamaları gerekir. Bugüne kadar hem uygunluk denetimi süreci hem de ek kota birimi tahsisi istekleri, geliştiriciler tarafından YouTube API Hizmetleri - Denetim ve Kota Artırma Formu'nu doldurup göndererek gerçekleştiriliyordu.

Bu süreçleri netleştirmek ve API Hizmetleri'mizi 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 denetiminden geçmiş geliştiriciler, ayrılan kotanın uzatılmasını istemek için bu kısa formu doldurup gönderebilir.
• İtiraz Formu: API projeleri uyumluluk denetiminden geçemeyen (veya kota birimi artışı reddedilen) geliştiriciler bu formu doldurup gönderebilir.
• Yönetim Değişikliği Formu: API projesiyle ilişkili bir yönetim değişikliği (ör. hisse alımı veya satışı, birleşme veya diğer kurumsal işlemler aracılığıyla) yaşayan geliştiriciler ya da geliştirici adına API istemcisi işleten taraflar bu formu doldurup göndermelidir. Bu sayede YouTube'un API ekibi, kayıtlarımızı güncelleyebilir, yeni API projesinin kullanım alanı uygunluğunu denetleyebilir ve geliştiricinin mevcut kota tahsisini doğrulayabilir.

Her yeni form, YouTube API'sini kullanma amacınız hakkında bilgi verir ve size daha iyi yardımcı olmamızı sağlar.

Daha fazla bilgiyi yeni API Uyumluluk Denetlemeleri kılavuzumuzda bulabilirsiniz.

12 Mayıs 2021

Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

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ı. 28 Nisan 2016 tarihli düzeltme geçmişi girişinde belirtildiği gibi, favori videolar işlevi birkaç yıldır kullanımdan kaldırılmıştır.

  Bu güncellemeden önce, API istemcisi var olmayan bir favoriler oynatma listesine video eklemeye çalıştıysa API yine de yeni bir oynatma listesi oluşturuyordu. Bundan sonra, bu durumda oynatma listesi oluşturulmaz ve API bir hata döndürür. Önceki duyurulara göre, öğe ekleyerek, değiştirerek veya silerek favoriler oynatma listelerini değiştirmeye yönelik tüm girişimler de kullanımdan kaldırıldı ve herhangi bir zamanda hata döndürmeye başlayabilir.

• Aşağıdaki channel kaynak özelliklerinin desteği sonlandırıldı. Bu mülkler YouTube Studio kullanıcı arayüzünde ve YouTube'da zaten desteklenmiyor. Bu nedenle, bu API'ler artık API üzerinden de desteklenmiyor.

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

  Tüm mülkler channel kaynak temsilinden, tanımları ise kaynağın mülk listesinden kaldırıldı. Ayrıca, bu özelliklerle ilişkili hatalar yönteme özel dokümanlardan kaldırıldı.

• Aşağıdaki channelSection kaynak özelliklerinin desteği sonlandırıldı. Bu mülkler YouTube Studio kullanıcı arayüzünde ve YouTube'da zaten desteklenmiyor. Bu nedenle, bu API'ler artık API üzerinden de desteklenmiyor.

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

  Bu değişiklikle birlikte, desteklediği özellikler desteklenmediğinden channelSection.list yönteminin hl parametresinin desteği de sonlandırıldı.

  Tüm mülkler channelSection kaynak temsilinden, tanımları ise kaynağın mülk listesinden kaldırıldı. Ayrıca, bu özelliklerle ilişkili hatalar yönteme özel dokümanlardan kaldırıldı.

• channelSection kaynağının snippet.type özelliği için aşağıdaki değerlerin desteği sonlandırıldı. Bu değerler YouTube kanal sayfalarında zaten desteklenmiyor ve bu nedenle API üzerinden de artık desteklenmiyor.

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

• playlist kaynağının snippet.tags[] özelliğinin desteği sonlandırıldı. Bu mülk YouTube'da zaten desteklenmiyor ve bu nedenle API üzerinden de desteklenmiyor.

9 Şubat 2021

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

• snippet.videoOwnerChannelId mülkünde, oynatma listesi videosunu yükleyen kanalın kimliği bulunur.
• snippet.videoOwnerChannelTitle mülkiyeti, 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öntemlerinin tümü yeni bir playlistOperationUnsupported hatasını destekler. Hata, bir istek belirli bir oynatma listesi için izin verilmeyen bir işlem gerçekleştirmeye çalıştığında ortaya çıkar. Örneğin, kullanıcılar yüklenen videolar oynatma listesinden videoları veya oynatma listesini silemez.

  Bu hata her durumda 400 HTTP yanıt kodu (Hatalı İstek) döndürür.

• playlistItems.list yönteminin watchHistoryNotAccessible ve watchLaterNotAccessible hataları dokümandan kaldırıldı. Kullanıcıların izleme geçmişine ve daha sonra izleme listelerine API üzerinden erişilememesine rağmen, API bu hataları döndürmez.

15 Ekim 2020

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

• Yeni Bölüm III.E.4.i, YouTube yerleşik oynatıcısı aracılığıyla toplanan ve gönderilen veriler hakkında ek bilgi sağlar. Kullanıcı oynatma niyetini belirtmek için oynatıcıyla etkileşime geçmeden önce YouTube yerleşik oynatıcısı aracılığıyla bize gönderdiğiniz tüm kullanıcı verilerinden siz sorumlusunuz. Otomatik oynatmayı false olarak ayarlayarak kullanıcı oynatıcıyla etkileşime geçmeden önce YouTube ile paylaşılan verileri sınırlayabilirsiniz.
• Yeni III.E.4.j Bölümü, içeriğin Çocuklara Özel (ÇÖ) durumunu sitelerinize ve uygulamalarınıza yerleştirmeden önce kontrol etmeyi kapsar. API istemcinize yerleştirdiğiniz videoların çocuklar için olup olmadığını bilmek ve yerleştirilmiş oynatıcıdan toplanan verileri buna göre işlemek sizin sorumluluğunuzdadır. Bu nedenle, YouTube yerleşik oynatıcıları aracılığıyla API istemcinize yerleştirmeden önce içeriğin durumunu YouTube Data API Hizmeti'ni kullanarak kontrol etmeniz gerekir.

Yeni Bir videonun "çocuklara yönelik" durumunu bulma kılavuzunda, YouTube Data API Hizmeti'ni kullanarak bir videonun "çocuklara yönelik" durumunu nasıl arayacağınız açıklanmaktadır.

Bu değişikliklerle birlikte, Yerleşik Oynatıcı Parametresi dokümanına, otomatik oynatmayı etkinleştirirseniz oynatma işleminin oynatıcıyla herhangi bir kullanıcı etkileşimi olmadan gerçekleşeceğini ve bu nedenle oynatma verilerinin toplanması ve paylaşılmasının sayfa yüklendiğinde gerçekleşeceğini açıklayan bir hatırlatma eklendi.

8 Ekim 2020

Bu güncelleme, channel kaynağıyla ilgili üç küçük değişikliği kapsar:

• Bir kanalın küçük resimlerini tanımlayan snippet.thumbnails nesnesi, yeni oluşturulan kanallarda boş olabilir ve doldurulması bir gün kadar sürebilir.
• statistics.videoCount özelliği, kanalın herkese açık videolarının sayısını gösterir. Bu davranış, YouTube web sitesinde gösterilen sayılarla tutarlıdır.
• brandingSettings.channel.keywords mülkünde tanımlanan kanal anahtar kelimeleri, izin verilen maksimum 500 karakter uzunluğunu aşarsa veya kaçırılmamış tırnak işaretleri (") içeriyorsa kısaltılabilir. 500 karakter sınırının anahtar kelime başına bir sınır değil, tüm anahtar kelimelerin toplam uzunluğuyla ilgili bir sınır olduğunu unutmayın. Bu davranış, YouTube web sitesindekiyle tutarlıdır.

9 Eylül 2020

Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

Bu güncelleme aşağıdaki API değişikliklerini kapsar. Tüm değişiklikler, bu duyurunun yapıldığı tarih olan 9 Eylül 2020'de veya bu tarihten sonra yürürlüğe girecektir. Bu nedenle, geliştiriciler artık aşağıda listelenen API özelliklerinden hiçbirine güvenmemelidir.

• Aşağıdaki API kaynakları, yöntemleri, parametreleri ve kaynak özellikleri için desteğin hemen sonlandırılması ve bu duyurunun tarihinden itibaren çalışmayı durdurması kararlaştırılmıştır:
  • Aşağıdaki channel kaynak özellikleri:
    • statistics.commentCount mülkü
    • brandingSettings.image nesnesi ve tüm alt mülkleri
    • brandingSettings.hints listesi ve tüm alt mülkleri
  • channels.list yönteminin categoryId filtre parametresi
  • guideCategories kaynağı ve guideCategories.list yöntemi
• API isteği managedByMe parametresini true olarak ayarlarsa channels.list yöntemine yönelik API yanıtları artık prevPageToken özelliğini içermez. Bu değişiklik, diğer channels.list istekleri için prevPageToken mülkünü ve hiçbir istek için nextPageToken mülkünü etkilemez.
• channel kaynağının contentDetails.relatedPlaylists.watchLater ve contentDetails.relatedPlaylists.watchHistory özelliklerinin desteğinin 11 Ağustos 2016'da sonlandırıldığı duyuruldu. Bu oynatma listeleri için playlistItems.insert yönteminin ve playlistItems.delete yönteminin desteği de artık tamamen sonlandırıldı ve bu iki özellik dokümanlarımdan kaldırıldı.
• 30 Temmuz 2013'te desteğinin sonlandırıldığı duyurulan channels.list yönteminin mySubscribers parametresi dokümandan kaldırıldı. Kimliği doğrulanmış kullanıcının kanalına abone olan kullanıcıların listesini almak için subscriptions.list yöntemini ve mySubscribers parametresini kullanın.
• channel kaynağının invideoPromotion nesnesi ve 27 Kasım 2017'de desteğinin sonlandırıldığı duyurulan tüm alt mülkleri dokümandan kaldırıldı.

29 Temmuz 2020

part parametresiyle ilişkili ek maliyeti kaldırarak API istekleri için kota ücretlendirme sürecimizi basitleştirdik. Anında geçerli olmak üzere, yalnızca çağrılan yöntemin taban maliyeti alınacak. Basitleştirilmiş kota hakkında daha fazla bilgiyi burada bulabilirsiniz.

Bu değişikliğin etkisi, çoğu API çağrısının kota maliyetinin biraz daha düşük olması, bazı API çağrılarının ise aynı maliyete sahip olmaya devam etmesidir. Bu değişiklik, API çağrılarının maliyetini artırmaz. Genel olarak, olası etki, Google Cloud Console'da görülebilen ayrılan kotanızın biraz daha uzatılması olacaktır.

Tüm geliştiricilerin, YouTube API Hizmetleri'ne erişmeye devam edebilmeleri için projeleriyle ilgili bir uyumluluk denetimi tamamlamalarını önemle tavsiye ederiz.

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

28 Temmuz 2020

28 Temmuz 2020'den sonra oluşturulan doğrulanmamış API projelerinden videos.insertuç noktası üzerinden yüklenen tüm videolar gizli izleme moduyla sınırlandırılacak. Bu kısıtlamanın kaldırılması için her projenin, Hizmet Şartları'na uygunluğunu doğrulamak amacıyla denetime tabi tutulması gerekir.

Video yüklemek için doğrulanmamış bir API istemcisi kullanan içerik üreticilere, videolarının gizli olarak kilitlendiğini ve resmi veya denetlenmiş bir istemci kullanarak bu kısıtlamadan kurtulabileceklerini açıklayan bir e-posta gönderilir.

28 Temmuz 2020'den önce oluşturulan API projeleri şu anda bu değişiklikten etkilenmiyor. Ancak tüm geliştiricilerin, YouTube API Hizmetleri'ne erişmeye devam edebilmeleri için projelerinde uyumluluk denetimi tamamlamalarını önemle tavsiye ederiz.

21 Temmuz 2020

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

Dün, kota ücreti alma sürecimizle 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. Bu nedenle, doğruluk için dokümanlar geri döndürüldü. Kafa karışıklığını önlemek için değişikliği açıklayan düzeltme geçmişi girişi kaldırıldı ve yakın gelecekte yeniden yayınlanacak.

7 Temmuz 2020

Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

videos.insert yönteminin autoLevels ve stabilize parametreleri artık desteklenmiyor ve her iki parametre de dokümandan kaldırıldı. Bu değerlerin değeri yoksayılır ve yeni yüklenen videoların işlenmesini etkilemez.

15 Haziran 2020

Yeni YouTube Geliştirici Politikaları'na Uygunluk kılavuzu, API istemcilerinizin YouTube API Hizmetleri Hükümleri ve Politikaları'nın (API Hizmet Şartları) belirli bölümlerine uymasını sağlamanıza yardımcı olacak yol gösterici bilgiler ve örnekler sunar.

Bu kılavuz, YouTube'un API Hükümler ve Koşulları'nın belirli yönlerini nasıl uyguladığı hakkında bilgi verir ancak mevcut dokümanların yerini almaz. Kılavuzda, geliştiricilerin API uygunluk denetimleri sırasında sorduğu en yaygın sorulardan bazıları ele alınmaktadır. Bu makalenin, politikalarımızı nasıl yorumladığımızı ve uyguladığımızı anlamanıza yardımcı olarak özellik geliştirme sürecinizi basitleştireceğini umuyoruz.

4 Haziran 2020

Not: Bu, desteği sonlandırılan bir özellikle ilgili önceki duyurunun güncellenmiş halidir.

Kanal bülteni özelliği artık tamamen kullanımdan kaldırıldı. İlk olarak 17 Nisan 2020'de duyurulan bu değişiklik artık geçerlidir. Bu nedenle, activities.insert yöntemi artık desteklenmiyor ve activities.list yöntemi artık kanal bültenlerini döndürmez. Daha fazla bilgi için lütfen YouTube Yardım Merkezi'ne göz atın.

17 Nisan 2020

Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

YouTube, kanal bülteni özelliğini kullanımdan kaldırıyor. Bu nedenle, activities.insert yöntemi kullanımdan kaldırılacak ve activities.list yöntemi kanal bültenleri döndürmeyi durduracak. Bu değişiklikler, 18 Mayıs 2020'de veya sonrasında API'de geçerli olacaktır. Daha fazla bilgi için lütfen YouTube Yardım Merkezi'ne göz atın.

31 Mart 2020

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

• Yeni kaynaklar ve yöntemler

  • Yeni member kaynağı, bir YouTube kanalının kanal üyesini temsil eder. Üyeler, içerik üreticilere düzenli olarak parasal destek sağlayarak özel avantajlardan yararlanabilir. Örneğin, içerik üretici bir sohbet için üyelere özel modu etkinleştirdiğinde üyeler sohbet edebilir.

    Bu kaynak, YouTube Live Streaming API kapsamında belgelenen sponsor kaynağının yerini alır. sponsor kaynağının desteği sonlandırıldı ve API istemcileri, sponsors.list yöntemine yapılan çağrıları members.list yöntemini kullanmak üzere güncellemelidir.

  • Yeni membershipsLevel kaynağı, API isteğine yetki veren içerik üretici tarafından yönetilen 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 "çocuklara özel" olarak adlandırdığı çocuklara yönelik içerikleri tanımlama özelliğini destekliyor. YouTube Yardım Merkezi'nde "çocuklara özel" içerikler hakkında daha fazla bilgi edinin.

channel ve video kaynakları, içerik üreticilerin ve izleyicilerin çocuklara özel içerikleri tespit etmesine olanak tanımak için iki yeni özelliği destekler:

• selfDeclaredMadeForKids mülkü, içerik üreticilerin bir kanalın veya videonun çocuklara özel olup olmadığını belirtmesine olanak tanır.
  
  Kanallar için bu özellik, channels.update yöntemi çağrılırken ayarlanabilir. Videolarda bu özellik, videos.insert veya videos.update yöntemleri çağrılırken ayarlanabilir.
  
  Bu özelliğin yalnızca kanal sahibi API isteğine yetki verdiyse channel veya video kaynaklarını içeren API yanıtlarına dahil edildiğini unutmayın.
• madeForKids mülkü, tüm kullanıcıların bir kanalın veya videonun "çocuklara özel" durumunu almasını sağlar. Örneğin, durum selfDeclaredMadeForKids özelliğinin değerine göre belirlenebilir. Kanalınızın, videolarınızın veya yayınlarınızın kitlesini ayarlama hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın.

YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları'nı da güncelledik. Daha fazla bilgi için lütfen YouTube API Hizmetleri Hizmet Şartları - Düzeltme Geçmişi'ne bakın. YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları'nda yapılan değişiklikler 10 Ocak 2020 Pasifik Saati'nde yürürlüğe girecektir.

10 Eylül 2019

API referans dokümanları, abone sayılarının YouTube'da ve dolayısıyla API yanıtlarında raporlanma şeklindeki değişikliği yansıtacak şekilde güncellendi. Bu değişiklik sonucunda, YouTube Data API Hizmeti tarafından döndürülen abone sayıları 1.000'den fazla aboneye sahip hesaplar için üç basamaklı sayıya yuvarlanır. Bu değişiklik, channel kaynağının statistics.subscriberCount özelliğini etkiler.

Not: Bu değişiklik, bir kullanıcının kendi kanalı hakkında yetkili bir veri isteği gönderdiği durumlarda bile bu mülk değerini etkiler. Kanal sahipleri, abone sayılarını YouTube Studio'da görmeye devam edebilir.

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

Ö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 dokümanları, her yöntemin yaygın kullanım alanlarını daha iyi açıklamak ve API Gezgini widget'ı aracılığıyla dinamik, yüksek kaliteli kod örnekleri sağlamak için güncellendi. Örnek için channels.list yönteminin belgelerine bakın. API yöntemlerini açıklayan sayfalarda artık iki yeni öğe vardır:

  • API Gezgini widget'ı, yetkilendirme kapsamlarını seçmenize, örnek parametre ve özellik değerleri girmenize, ardından gerçek API isteklerini göndermenize ve gerçek API yanıtlarını görmenize olanak tanır. Widget, girdiğiniz kapsamları ve değerleri kullanmak için dinamik olarak güncellenen tam kod örneklerini gösteren tam ekran bir görünüm de sunar.

  • 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 veya mevcut kullanıcının kanalıyla ilgili verileri almak için channels.list yöntemini çağırabilirsiniz.

    Bu bölümdeki bağlantıları kullanarak API Gezgini'ni kullanım alanınız için örnek değerlerle doldurabilir veya tam ekran API Gezgini'ni bu değerlerle doldurulmuş şekilde açabilirsiniz. Bu değişiklikler, kendi uygulamanızda uygulamaya çalıştığınız kullanım alanı için doğrudan geçerli olan kod örneklerini görmenizi kolaylaştırmayı amaçlamaktadır.

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

• Kod örnekleri aracı da yukarıda açıklanan tüm özellikleri 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 hızlı başlangıç kılavuzları güncellendi. Düzeltilen kılavuzlarda, API Gezgini'ndeki kod örnekleri kullanılarak bir API anahtarıyla bir örneğin, OAuth 2.0 istemci kimliğiyle de 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 mülkünün tanımı, uygulamanızda küçük resimler gösterilirken kodunuzun resim URL'lerini tam olarak API yanıtlarında döndürüldüğü şekilde kullanması gerektiğini belirtecek şekilde güncellendi. Örneğin, uygulamanız bir API yanıtında döndürülen URL'de https alanı yerine http alanı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österilir. Bu tarihten sonra, uygulamanız http alanından YouTube resimleri yüklemeye çalışırsa uygulamanızda bozuk resimler görebilirsiniz.

• Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

  video kaynağının recordingDetails.location.altitude özelliğinin desteği sonlandırıldı. Videoların bu mülk için değer döndüreceği garanti edilmez. Benzer şekilde, API istekleri söz konusu mülk için bir değer ayarlamaya çalışsa bile gelen verilerin depolanmayabilir.

22 Haziran 2018

Daha önce Uygulama ve Taşıma Kılavuzu olarak bilinen Uygulama Kılavuzu, v2 API'den v3 API'ye geçiş talimatlarının kaldırılması için güncellendi. Ayrıca, v3 API'de desteği sonlandırılan özelliklerle (ör. favori videolar) ilgili talimatlar da kaldırıldı.

27 Kasım 2017

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

• Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

  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 mülkleri de dahil olmak üzere bu nesnenin desteği sonlandırılıyor.

  14 Aralık 2017'ye kadar invideoPromotion verilerini alıp ayarlamaya devam edebilirsiniz. Bu tarihten sonra:

  • channels.list çağrılırken invideoPromotion bölümünü alma denemeleri boş bir invideoPromotion döndürür veya hiç invideoPromotion verisi döndürmez.
  • channels.update çağrısı yapılırken invideoPromotion verilerini güncelleme girişimleri en az 27 Mayıs 2018'e kadar başarılı bir yanıt döndürecek ancak işlem yapılmamış olarak değerlendirilecek. Yani aslında bir güncelleme gerçekleştirilmeyecek.

  27 Mayıs 2018'den sonra bu istekler, örneğin invalidPromotion'ün geçersiz bir bölüm olduğunu belirten 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 belgelerinde de görülebilir.

  Özelleştirilebilir örnekler, Node.js uygulaması için kullanım alanına özel bir başlangıç noktası sunmak üzere tasarlanmıştır. İşlev, 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 istek parametrelerine karşılık gelen bir anahtar/değer çiftleri listesi alır ve değeri olmayan parametreleri kaldırır.
  • createResource işlevi, bir API kaynağındaki özelliklere karşılık gelen anahtar/değer çiftlerinin listesini alır. Ardından, özellikleri insert ve update işlemlerinde kullanılabilecek bir JSON nesnesine dönüştürür. Aşağıdaki örnekte, bir dizi mülk adı ve değeri 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ü yerel olarak indirilip çalıştırılmak üzere tasarlanmıştır. Daha fazla bilgi için kod snippet'i aracı talimatlarında tam kod örneklerini yerel olarak çalıştırma ile ilgili ön koşullara bakın.

25 Ekim 2017

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

• Etkileşimli kod snippet'i aracındaki Python kod örnekleri, desteği sonlandı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, yüklü Python uygulamaları ve Python web sunucusu uygulamaları için biraz farklı yetkilendirme akışları kullanan tam kod örnekleri sağlıyor. Sana Özel içeriklerinin 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. Sana Özel bölümündeki bir snippet'i tam örnekle değiştirmek 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 konu açıklanmakta ve bir web sunucusu uygulaması örneğine bağlantı verilmektedir.
  5. Web sunucusu örneğine geçmek için bağlantıyı tıklayın. Bu örnekte Flask web uygulama çerçevesi ve farklı bir yetkilendirme akışı kullanılmaktadır.

  Bu örneklerin tümü yerel olarak indirilip çalıştırılmak üzere tasarlanmıştır. Örnekleri çalıştırmak istiyorsanız 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ı, bu parametre true olarak ayarlanırsa 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ı açıkça belirtecek şekilde güncellendi.
• YouTube, marka logolarını ve simgelerini güncelledi. Yeni "YouTube ile geliştirildi" logolarını markalama kuralları sayfasından indirebilirsiniz. Bu sayfada diğer yeni YouTube logoları ve simgeleri de gösterilir. Bu logoları ve simgeleri YouTube marka sitesinden indirebilirsiniz.

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. Kılavuzda, YouTube Data API'nin Objective-C veya Swift ile yazılmış basit bir iOS uygulamasında nasıl kullanılacağı açıklanmaktadır.
• YouTube Data API'nin etkileşimli kod snippet'i aracı artık aracın bazı özelliklerini açıklayan dokümanlar içeriyor:
  • API isteklerini yürütme
  • Kod snippet'leri ile tam kod örnekleri arasında geçiş yapma
  • Standart işlevleri kullanma
  • Mevcut kaynakları yükleme (güncelleme yöntemleri için)

  Not: Bu araç, API yöntemlerinin 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, desteği sonlandırılan bir özellikle ilgili duyurudur.

  Aşağıdaki video kaynak özelliklerinin desteği sonlandırılıyor. Mülkler 1 Aralık 2017'ye kadar desteklenecek olsa da videoların bu tarihe kadar bu mülkler için değer döndürmeye devam edeceği garanti edilmez. Benzer şekilde, bu özellik değerlerini ayarlayan videos.insert ve videos.update istekleri bu tarihten önce hata oluşturmaz ancak gelen verilerin 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 dokümanları, kod snippet'lerini daha yaygın ve etkileşimli hale getirmek için 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ülemenize ve özelleştirmenize olanak tanıyan etkileşimli bir araç bulunuyor.

  Araç, belirli bir yöntem için bir veya daha fazla kullanım alanına ait kod snippet'leri gösterir. Her kullanım alanı, söz konusu yöntemin yaygın bir şekilde çağrılma şeklini açıklar. Örneğin, belirli bir kanal veya mevcut kullanıcının kanalı hakkında veri almak için channels.list yöntemini çağırabilirsiniz.

  Kod örnekleriyle de etkileşim kurabilirsiniz:

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

  • Kod snippet'leri ile tam örnekler arasında geçiş yapın. Kod snippet'i, kodun API yöntemini çağıran kısmını gösterir. Tam örnek, bu snippet'in yanı sıra yetkilendirme ve istek göndermeyle ilgili standart kod içerir. Tam örnekler kopyalanıp komut satırından veya yerel bir web sunucusundan çalıştırılabilir.

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

  Bu aracın, kullanılabildiği sayfalarda API Gezgini'nin yerini aldığını unutmayın. (Her sayfada bir bağlantı gösterilir. Böylece üzerinde çalıştığınız isteği API Gezgini'ne yükleme seçeneğiniz de olur.)

• Veri API'si Kod Snippet'leri aracı da yukarıda açıklanan tüm özellikleri sunan yeni bir kullanıcı arayüzüyle güncellendi. Bu sayfada sunulan 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ı şablon 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 istekleri gönderen 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[] mülkü, kanalın içeriğini açıklayan Wikipedia URL'lerinin listesini içerir. URL'ler, kaynağın topicDetails.topicIds[] mülkünde döndürülen konu kimliklerine karşılık gelir.
• playlistItem kaynağının yeni contentDetails.videoPublishedAt mülkü, videonun YouTube'da yayınlandığı zamanı tanımlar. Kaynak, öğenin çalma listesine eklenme zamanını tanımlayan snippet.publishedAt mülkünü zaten içerir.
• channel kaynağı gibi video kaynağı da artık videonun içeriğini açıklayan Wikipedia URL'lerinin listesini içeren topicDetails.topicCategories[] özelliğini döndürüyor. video kaynakları için URL'ler, kaynağın topicDetails.relevantTopicIds[] mülkünde döndürülen konu kimliklerine karşılık gelir.
• video kaynağının yeni contentDetails.contentRating.mpaatRating mülkü, Motion Picture Association of America'nın bir film fragmanına veya önizlemesine verdiği derecelendirmeyi tanımlar.

27 Şubat 2017

11 Ağustos 2016'da duyurduğumuz gibi, YouTube desteklenen konu kimlikleri listesini özel bir listeye geçirdi. Desteklenen konu kimliklerinin tam listesi, channel ve video kaynakları için topicDetails özelliklerinin yanı sıra search.list yönteminin topicId parametresine dahildir.

Seçili listede birkaç değişiklik olduğunu unutmayın:

• Aşağıdaki konular Society'ün 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'un alt konusu olan Animated cartoon konusu kaldırıldı.
• Daha önce Music'un alt konusu olan Children's music konusu kaldırıldı.

Bu değişiklik sonucunda, videoyla ilgili konular artık her zaman video kaynağının topicDetails.relevantTopicIds[] mülk değerinde döndürülür.

29 Kasım 2016

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

• 10 Şubat 2017'den itibaren desteklenecek konu kimlikleri listesinde üç küçük değişiklik yapıldı:

  • Daha önce Sports kategorisinin alt kategorisi olan Professional wrestling kategorisi artık Entertainment kategorisinin alt kategorisi oldu.
  • Entertainment'un alt kategorisi olan TV shows kategorisi yenidir.
  • Daha önce Lifestyle'un alt kategorisi olan Health kategorisi kaldırıldı.

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

10 Kasım 2016

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

• İlk olarak 11 Ağustos 2016'da duyurulduğu gibi, Freebase ve Freebase API'nin desteğinin sonlandırılması, konu kimlikleriyle ilgili çeşitli değişiklikler yapılmasını gerektiriyor. 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.

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

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

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

• Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

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

  • channel kaynağının topicDetails.topicIds[] mülkü. Bu özellik 10 Kasım 2017'ye kadar desteklenecek.
  • video kaynağının topicDetails.relevantTopicIds[] mülkü. Bu özellik 10 Kasım 2017'ye kadar desteklenecek.
  • video kaynağının topicDetails.topicIds[] mülkü. Bu özellik, 10 Şubat 2017'den sonraki değerleri içermeyecek. (Bu tarihten sonra topicDetails.relevantTopicIds[] mülk değeri, bir videoyla ilişkili tüm konuları tanımlayacaktır.)

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

  Ayrıca, konu kimlikleriyle ilgili çeşitli kod örnekleri 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çerir:

    • player.embedHtml mülkü, videoyu oynatan bir oynatıcı yerleştirmek için kullanabileceğiniz bir <iframe> etiketi içerir. Yeni player.embedHeight ve player.embedWidth özellikleri, yerleştirilmiş 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 ayrıntılı olarak açıklanmaktadır.

    • Yeni hasCustomThumbnail mülkü, videoyu yükleyen kullanıcının video için özel bir küçük resim sağlayıp sağlamadığını belirtir. Bu özelliğin yalnızca videoyu yükleyen kullanıcı tarafından görülebileceğini unutmayın.

    • Yeni fpbRatingReasons[], videonun FPB (Güney Afrika) derecelendirmesini almasının nedenlerini belirtir.

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

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

    Varsayılan olarak, player.embedHtml mülkünde döndürülen <iframe> öğesinin yüksekliği 360 pikseldir. Genişlik, videonun en boy oranına uyacak şekilde ayarlanır. Böylece, yerleştirilmiş oynatıcıda videoyu çevreleyen 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, yerleşik kodun varsayılan boyutlar yerine uygulama düzeninize uygun bir yükseklik ve/veya genişlik kullanmasını belirtebilirsiniz. API sunucusu, yerleştirilmiş oynatıcıda videonun etrafında siyah çubuklar olmaması 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. Bu nedenle, her iki parametre de belirtilmişse bir boyut, söz konusu boyut için izin verilen maksimum tutardan daha 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ırsa ve maxWidth parametresi ayarlanmazsa API 1280x720 boyutunda bir oynatıcı döndürür.
    • maxWidth parametresi 960 olarak ayarlanırsa ve maxHeight parametresi ayarlanmazsa API 960x540 boyutunda bir oynatıcı döndürür.
    • maxWidth parametresi 960, maxHeight parametresi ise 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 ayarlama olmadan en fazla 10 raf, hedefleme verileri ayarlayarak ise en fazla 100 raf oluşturabileceğini belirtecek şekilde güncellendi.

    Ayrıca, channelSection kaynağının targeting mülkü, 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 mülkünün tanımı, değerin i18nLanguage.list yönteminin hl parametresi tarafından belirtilen dilde yazıldığı şekliyle bir dilin adını temsil ettiğini yansıtacak şekilde düzeltildi.

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

  • playlistItem kaynağının contentDetails.startAt ve contentDetails.endAt özelliklerinin desteği sonlandı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 bazı yöntemlerde zaten desteklenen onBehalfOfContentOwner parametresini desteklemektedir. Bu yöntemin kullanıldığı isteklerin, https://www.googleapis.com/auth/youtubepartner kapsamına erişim sağlayan bir jetonla da yetkilendirilmesi gerekir.

  • search.list yönteminin publishedBefore ve publishedAfter parametreleri, parametre değerlerinin dahil edici olduğunu belirtecek şekilde güncellendi. Örneğin, publishedBefore parametresi ayarlanırsa API, belirtilen zamandan önce oluşturulan kaynakları döndürür.

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

  • videos.insert yöntemi açıklaması, yüklenen videoların maksimum dosya boyutunun 64 GB'tan 128 GB'a yükseldiğ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 etkinlik verilerinin bu API üzerinden kullanılamadığını belirtmek için bu hatayı döndürür. Bu hata, yetkisiz bir istekte home parametresini true olarak ayarlarsanız 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 nedenlerinden biri, contentDetails.note alanının 280 karakterden uzun olmasıdır.
    forbidden (403)	watchHistoryNotAccessible	playlistItems.list yöntemi, isteğin "izleme geçmişi" oynatma listesi öğelerini almaya çalıştığını ancak bunların API kullanılarak alınamadığını belirtmek için bu hatayı döndürür.
    forbidden (403)	watchLaterNotAccessible	playlistItems.list yöntemi, isteğin "sonra izle" oynatma listesi öğelerini almaya çalıştığını ancak bunların API kullanılarak alınamadığını belirtmek için bu hatayı döndürür.
    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şim ayarı belirlemeye çalıştığını belirtmek üzere bu hatayı döndürür. Bazı kanalların canlı yayınlarda yerleştirilmiş oynatıcı sunma izni olmayabilir. Daha fazla bilgi için YouTube Yardım Merkezi'ni ziyaret edin.

  • Oynatma listesine yinelenen bir video eklerseniz playlistItems.insert yöntemi artık hata döndürmez. Bu hata, daha önce favori videolar gibi yinelenen öğelere izin vermeyen ancak artık desteklenmeyen bazı oynatma listelerinde ortaya çıkıyordu. Genel olarak oynatma listelerine yinelenen videolar eklenebilir.

• Diğer güncellemeler

  • 15 Eylül 2016 tarihli düzeltme geçmişi girişi, channel kaynağının contentDetails.relatedPlaylists.watchHistory ve contentDetails.relatedPlaylists.watchLater mülklerinin bir yanıta dahil edildiğinde her zaman sırasıyla HL ve WL değerlerini içerdiğini açıklığa kavuşturmak için güncellendi. Ayrıca bu mülkler yalnızca yetkili bir kullanıcı kendi kanalıyla ilgili verileri 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'den itibaren değişeceği de dahil olmak üzere konu kimlikleriyle ilgili çeşitli değişiklikler ele alınmıştı. Desteklenecek konuların listesi 10 Kasım 2016'ya kadar yayınlanacaktır.

• Aşağıdaki değişiklikler şu anda geçerlidir. Bu değişikliklerle ilgili bildirim, 11 Ağustos 2016'daki düzeltme geçmişi güncellemesinde yapılmıştır:

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

    Bu, 11 Ağustos 2016'daki düzeltme geçmişi güncellemesinde açıklanan davranıştan daha iyi bir kullanıcı deneyimi sunmayı amaçlayan küçük bir değişikliktir. Bu güncellemede, home parametresini kullanan isteklerin boş bir liste döndüreceği belirtilmişti.

  • 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.

    Bu mülkler yalnızca kendi kanalıyla ilgili verileri alan yetkili kullanıcılar tarafından görülebilir. Özellikler, kullanıcının kendi kanalıyla ilgili verileri alan yetkili bir kullanıcı için bile her zaman HL ve WL değerlerini içerir. Bu nedenle, izleme geçmişi ve daha sonra izle oynatma listesi kimlikleri API üzerinden alınamaz.

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

• video kaynağının fileDetails.recordingLocation nesnesi ve alt mülkleri artık döndürülmemektedir. Daha önce bu veriler (üst fileDetails nesnesi gibi) yalnızca videonun 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 zengin bir güncelleme grubu sunar. Bu güncelleme, 10 Şubat 2017'den itibaren geçerli olacak Güncellenen Şartlar'a ek olarak, geliştiricilerin uyması gereken politikaları açıklamaya yardımcı olacak çeşitli destekleyici dokümanlar 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 bu düzeltme geçmişinde açıklanacaktır. İlgili dokümandaki bir bağlantıdan, düzeltme geçmişindeki değişiklikleri listeleyen bir RSS özet akışına abone olabilirsiniz.

• Freebase ve Freebase API'nin desteğinin sonlandı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 kısmı, kanalla ilişkili konuları tanımlar.
  • video kaynağının topicDetails kısmı, 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:

  • YouTube, 10 Şubat 2017'den itibaren, bugüne kadar döndürülen çok daha ayrıntılı kimlik grubu yerine küçük bir konu kimliği grubu döndürmeye başlayacak. Desteklenen bu konu grubu, Spor veya Basketbol gibi üst düzey kategorileri tanımlar ancak örneğin belirli takımları veya oyuncuları tanımlamaz. Uygulamanızı bu değişikliğe hazırlamanız için desteklenen konu grubunu duyuracağız.

  • Daha önce aldığınız Freebase konu kimlikleri, 10 Şubat 2017'ye kadar içerik aramak için kullanılabilir. Ancak bu tarihten 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 bulunmayan bir konu kimliği kullanarak sonuç aramaya çalışırsanız API boş bir sonuç grubu döndürür.

• 12 Eylül 2016'dan itibaren bazı API alanları ve parametrelerinin desteği sonlandırılacak:

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

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

    Bir 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ş bir liste döndürür. Bu oynatma listelerinden birinde oynatma listesi öğelerini (playlistItems.list) alma istekleri de bu sürenin ardından boş bir liste döndürür. Bu durum, HL ve WL gibi yeni değerler için olduğu kadar API istemcinizin daha önce depolamış olabileceği 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 hiçbiri 12 Eylül 2016'dan sonra döndürülmeyecektir. Üst fileDetails nesnesi yalnızca video sahibi tarafından alınabildiğinden bu veriler yalnızca videonun 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ğinin desteği sonlandırıldı. Daha önce bu özellik yalnızca kanal bir Google+ profiliyle ilişkilendirilmişse mevcuttu. Desteği sonlandırılan mülkler artık hiçbir channel kaynağına dahil edilmeyecektir.

• comment kaynağının snippet.authorGoogleplusProfileUrl özelliğinin desteği sonlandırıldı. Daha önce bu özellik yalnızca kanal bir Google+ profiliyle ilişkilendirilmişse mevcuttu. Desteği sonlandırılan mülkler artık hiçbir comment kaynağına dahil edilmeyecektir.

Destek sonlandırıldıktan sonra bu özelliklerin hiçbiri döndürülmeyeceğinden, her iki özellik de ilgili kaynak dokümanlarından kaldırıldı.

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ına abone olan kullanıcıların listesini, kanala abone oldukları zamana göre ters kronolojik sırayla alır.

  Yeni parametrenin yalnızca kimliği doğrulanmış kullanıcının kanalına abone olan son 1.000 kullanıcının 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) mülkünün tanımı, bazı videolar için ek küçük resim boyutlarının kullanılabileceğini belirtmek üzere activity, playlistItem, playlist, search result, thumbnail ve video kaynakları için güncellendi.

  • standard resmi 640 piksel genişliğinde ve 480 piksel yüksekliğindedir.
  • maxres resmi 1.280 piksel genişliğinde ve 720 piksel yüksekliğindedir.

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

• videos.list yöntemi artık, yetkisiz bir istek video kaynağının fileDetails, processingDetails veya suggestions bölümlerini almaya çalıştığında forbidden (403) hatası döndürüyor. Bu bölümlere yalnızca videonun sahibi erişebilir.

17 Mayıs 2016

Yeni Veri API'si Kod Snippet'leri aracı, yaygın YouTube Data API 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 okuma API yöntemleri için kullanılabilir.

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

• Videoları anahtar kelimeye göre listeleme
• Videoları konuma göre listeleme
• Canlı etkinlikleri listeleme
• Kimliği doğrulanmış kullanıcının videolarını arama
• İlgili videoları listeleme

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 istek için API yanıtını gösterir. İstek parametrelerini değiştirdiyseniz API yanıtı, sağladığınız parametre değerlerine göre belirlenir. API yanıtlarının gösterilmesi için aracın sizin adınıza istek göndermesi için 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 mülkü, videonun projeksiyon biçimini belirtir. Geçerli özellik değerleri 360 ve rectangular'dir.

• video kaynağının recordingDetails.location ve fileDetails.recordingLocation özellikleri, iki özellik arasındaki farkı açıklamak için güncellendi:

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

• channel kaynağının contentDetails.relatedPlaylists.favorites özelliğinin tanımı, özellik değerinin boş bir oynatma listesini belirten 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 desteği sonlandırma politikasına tabi olmadığını unutmayın.

• comments.insert, comments.update, commentThreads.insert veya commentThreads.update yöntemi tarafından döndürülebilen ineligibleAccount hatasının tanımı, API isteği için yetkilendirme yapmak üzere kullanılan YouTube hesabı kullanıcının Google Hesabı ile birleştirilmediğinde hatanın oluştuğunu 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 değerinin 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 kotanızı ve kota kullanımınızı görebileceğiniz Google Developer Console'a bağlantı verecek şekilde güncellendi.

16 Mart 2016

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

• Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

  • channelBanner kaynak dokümanları, yüklenen kanal banner'ı resmi için önerilen boyutun 2560 piksel x 1440 piksel olduğunu belirtecek ş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'si 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 mülkleri için destek sonlandırıldı.

  • search.list isteğine verilen API yanıtı artık bir regionCode mülkü içeriyor. Bu özellik, arama sorgusu için kullanılan bölge kodunu tanımlar. Bölge kodu, API'ye belirtilen ülkeyle ilgili arama sonuçlarını döndürmesini söyler.

    Mülk değeri, bölgeyi tanımlayan iki harfli bir ISO ülke kodudur. i18nRegions.list yöntemi, desteklenen bölgelerin listesini döndürür. Varsayılan değer: US. Desteklenmeyen bir bölge belirtilse bile 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ı, özelliklerin kötüye kullanım raporu nedenleri için 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'tür.

  • video kaynağının yeni contentDetails.contentRating.ecbmctRating mülkü, videonun Türkiye Kültür ve Turizm Bakanlığı Değerlendirme ve Sınıflandırma Kurulu tarafından verilen derecelendirmesini tanımlar.

    Ayrıca, diğer derecelendirme sistemlerinin API özellikleri 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şkili etkin canlı sohbetin kimliğini içerir. Mülk değeri yalnızca video canlı sohbetin etkin olduğu bir canlı yayınsa mevcuttur. Yayın sona erdikten ve canlı sohbet sona erdikten sonra mülk, video için artık döndürülmez.

  • video kaynağının status.rejectionReason mülkü, yeni mülk değeri legal'yi 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şturulamadığını, güncellenemediğini veya silinemediğ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 mülkü 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 mülkü 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ıyla işleyemediğini belirtmek için bu hatayı döndürür. Bu geçici bir hata olabilir ancak genellikle isteğin girişinin geçersiz olduğunu gösterir. Geçerli olduğundan emin olmak için istek gövdesinde commentThread kaynağının yapısını kontrol edin.
  forbidden (403)	commentsDisabled	commentThreads.list yöntemi, videoId parametresi tarafından 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 mülkünde ç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. Seri oynatma listeleri hakkında daha fazla bilgi için YouTube Yardım Merkezi'ni ziyaret edin.
  badRequest (400)	subscriptionForbidden	subscriptions.insert yöntemi, maksimum abonelik sayınıza ulaştığınızı veya çok fazla abonelik oluşturduğunuzu belirtmek için bu hatayı döndürür. İkinci durumda, isteği birkaç saat sonra tekrar deneyebilirsiniz.
  badRequest (400)	invalidCategoryId	videos.update yöntemi, yüklenen video kaynağındaki snippet.categoryId mülkünün 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 mülkünün geçersiz bir planlanmış 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ı 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 mülkünün 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ünceller ancak hem snippet.title hem de snippet.categoryId özellikleri için bir değer ayarlamazsa ortaya çıkar.

18 Aralık 2015

Avrupa Birliği (AB) yasaları, AB'deki son kullanıcılara belirli bilgilerin verilmesini ve bu kullanıcılardan izin alınmasını zorunlu kılar. Bu nedenle, Avrupa Birliği'ndeki son kullanıcılar için AB Kullanıcı Rızası Politikası'na uymanız gerekir. YouTube API Hizmet Şartlarımız'a bu şartla ilgili bir bildirim ekledik.

19 Kasım 2015

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

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

  Bir kaynak için insert veya update yöntemini çağırırken kaynak için yerelleştirilmiş değerler ayarlayabilirsiniz. Bir kaynak için yerelleştirilmiş değerler ayarlamak üzere 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, İngilizce başlığı ve açıklaması olan bir video yüklerseniz snippet.defaultLanguage mülkünü en olarak ayarlarsınız.

    channel kaynaklarını güncellemeyle ilgili not: Bir channel kaynağı için snippet.defaultLanguage özelliğini ayarlamak istiyorsanız aslında 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'te kaynağın varsayılan dili İngilizce olarak ayarlanmıştır. Ayrıca, videoya Almanca ve İspanyolca yerelleştirilmiş başlıklar ve 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 örnekteki videoya Portekizce veriler eklemek için daha sonra bir istek gönderirseniz isteğin Almanca, İspanyolca ve Portekizce için yerelleştirilmiş verileri içermesi gerekir.

• Yerelleştirilmiş değerleri 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 için yerelleştirilmiş veriler almak üzere channels.list, channelSections.list, playlists.list veya videos.list isteğinize hl parametresini ekleyin. Yerelleştirilmiş kaynak ayrıntıları bu dilde mevcutsa 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 dilinde kaynak ayrıntılarını içerir.

    Örneğin, bir videos.list isteği yukarıda açıklanan videonun verilerini yerelleştirilmiş Almanca ve İspanyolca verilerle aldığını varsayalım. hl parametresi de olarak ayarlanmışsa 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"
        }
        ...
      }
    }

    Ancak hl parametresi fr olarak ayarlanmışsa snippet.localized nesnesi İngilizce başlığı ve açıklamayı içerir. Bunun nedeni, kaynağın varsayılan dilinin İngilizce olması ve yerelleştirilmiş Fransızca ayrıntıların kullanılamamasıdır.

    Önemli: hl parametresi yalnızca YouTube web sitesinin desteklediği uygulama dillerini tanımlayan değerleri destekler. Yerelleştirilmiş metnin diğer diller için kullanılıp kullanılamadığını belirlemek istiyorsanız kaynağın localizations bölümünü almanız ve yerelleştirilmiş metnin mevcut olup olmadığını belirlemek için filtre uygulamanız gerekir.
    
    Örneğin, yerelleştirilmiş metnin Appalachian İngilizcesinde kullanılıp kullanılamadığını belirlemek için yerelleştirmelerin tam listesini almanız gerekir.
    
    

  • Bir kaynağı alırken, ilgili kaynağın yerelleştirilmiş tüm ayrıntılarını almak için part parametre değerine localizations ekleyin. Mevcut bir YouTube uygulaması dili olmayan bir dil için yerelleştirilmiş verileri alıyorsanız tüm yerelleştirmeleri almak için bu yaklaşımı kullanmanız ve ardından istediğiniz yerelleştirilmiş verilerin mevcut olup olmadığını belirlemek için filtre uygulamanı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 bir isteğin, söz konusu kaynak için snippet.defaultLanguage mülkünün ayarlanmaması nedeniyle başarısız olduğunu gösterir. 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, bir kaynağın localizations nesnesindeki değerlerden birinin doğrulanmadığı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 kaynaklar ve yöntemlerle ilgili güncellemeler

  • search.list yönteminin order parametresi, canlı yayınları viewCount'ye göre sıralarsanız API sonuçlarının, yayın devam ederken yayınların eşzamanlı izleyici sayısına göre sıralandığını belirtecek şekilde güncellendi.

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

  • video kaynağının snippet.publishedAt mülkünün tanımı, videonun yayınlanma tarihini ve saatini belirten mülk değerinin, videonun yüklenme zamanından farklı olabileceğini belirtecek şekilde güncellendi. Örneğin, bir video gizli olarak yüklenir ve daha sonra herkese açık hale getirilirse mülk değeri, videonun herkese açık hale getirildiği zamanı belirtir. Güncellenen tanım, gizli ve liste dışı videolar için değerin nasıl doldurulduğunu da açıklar.

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

  • video kaynağının status.publishAt özelliğinin tanımı, aşağıdaki notu içerecek şekilde güncellendi:

    • videos.update yöntemini çağırırken bu özelliğin değerini ayarlarsanız video zaten gizli olsa bile status.privacyStatus özelliğinin değerini private olarak da ayarlamanız gerekir.
    • İstekte videonun geçmişte yayınlanması planlanmışsa video hemen yayınlanır. Bu nedenle, status.publishAt mülkünün geçmiş bir tarih ve saate ayarlanmasının etkisi, videonun privacyStatus değerinin private yerine public olarak değiştirilmesiyle aynıdır.

  • video kaynağının contentDetails.contentRating.cncRating mülkü, videonun Fransa'daki Commission de classification cinematographique tarafından verilen derecelendirmesini belirtir. Bu özellik, desteği sonlandırılmış olan contentDetails.contentRating.fmocRating özelliğinin yerini almıştır.

  • channel kaynağının brandingSettings.channel.keywords tanımı, daha önce belirtildiği gibi mülk 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 yapılan bir değişikliğe işaret etmez.

  • thumbnails.set yöntemine ait dokümanlar, isteğin gövdesinde yüklediğiniz ve bir videoyla ilişkilendirdiğiniz küçük resmin yer aldığını doğru şekilde yansıtacak şekilde güncellendi. İstek metni bir thumbnail kaynağı içermiyor. Daha önce dokümanda, bu yöntemi çağırırken istek gövdesi sağlamamanız gerektiği belirtiliyordu. Bu güncelleme, API davranışında yapılan 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 mülkü, 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 Eklenmekte veya güncellenmekte olan comment kaynağı, snippet.topLevelComment.snippet.textOriginal mülkünde çok fazla karakter içeriyor.
    playlistItems.insert playlistItems.update	HTTP Yanıt Kodu forbidden (403) Neden playlistItemsNotAccessible Açıklama İstek, belirtilen oynatma listesi öğesini eklemek, güncellemek veya silmek için uygun yetkiye sahip değil.
    playlists.delete playlists.insert playlists.update	HTTP Yanıt Kodu badRequest (400) Neden playlistForbidden Açıklama Bu işlem yasaktır veya istek uygun ş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 parametresi yanlış biçimlendirilmiş.
    subscriptions.insert	HTTP Yanıt Kodu badRequest (400) Neden subscriptionForbidden Açıklama Bu hata aşağıdaki durumlardan herhangi biri geçerli olduğunda ortaya çıkar: Oluşturmaya çalıştığınız abonelik zaten mevcut Maksimum abonelik sayınıza ulaştınız Kendi kanalınıza abone olmaya çalışıyorsunuz. Bu işlem desteklenmez. Kısa süre önce çok fazla abonelik oluşturduğunuz için 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ı ayarlamaya çalışıyor.

28 Ağustos 2015

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

• Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

  • video kaynağının statistics.favoriteCount özelliğinin desteği sonlandırıldı.

    Destek sonlandırma politikamız uyarınca, bu mülk bu duyurudan en az bir yıl sonra video kaynaklarına dahil edilmeye devam edecektir. Ancak mülk değeri artık her zaman 0 olarak ayarlanır.

7 Ağustos 2015

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

• Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

  • video kaynağının snippet.tags[] mülkünün tanımı, API sunucusunun mülkün 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şiklik olmadığını unutmayın.

    Daha açık belirtmek gerekirse, tanım artık bir etiket boşluk içeriyorsa API sunucusunun etiket değerini tırnak içine alınmış gibi işlediğini ve tırnak işaretlerinin karakter sınırlamasına dahil edildiğini açıklıyor. Bu nedenle, karakter sınırı açısından Foo-Baz etiketi yedi karakter, Foo Baz etiketi ise dokuz karakter içerir.

  • commentThreads.insert yöntemi artık shareOnGooglePlus parametresini desteklemiyor. Bu parametre daha önce bir yorumun ve bu yoruma verilen yanıtların, yorumu yazan kullanıcının Google+ profiline de gönderilip gönderilmeyeceğini belirtiyordu. Bir istek parametreyi gönderirse API sunucusu parametreyi yoksayar ancak aksi takdirde isteği işler.

18 Haziran 2015

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

• Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

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

  • video kaynağının yeni snippet.defaultAudioLanguage mülkü, 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ı bir kanala yüklenmesi ve ardından bu iş ortağı tarafından hak talebinde bulunulması gerektiğini açıkça belirtecek şekilde güncellendi. Bu durum, gerçek API davranışında bir değişikliğe işaret etmez.

  • captions.delete, captions.download, captions.insert, captions.list ve captions.update yöntemleri artık diğer çeşitli yöntemlerde zaten desteklenen onBehalfOfContentOwner parametresini destekliyor. Bu yöntemin kullanıldığı isteklerin, https://www.googleapis.com/auth/youtubepartner kapsamına erişim sağlayan bir jetonla da 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ı, videoyu derecelendirmeden önce e-posta adresini doğrulamalıdır.
    videos.rate	HTTP Yanıt Kodu badRequest (400) Neden videoPurchaseRequired Açıklama Kiralık videolar yalnızca kiralayan kullanıcılar tarafından puanlanabilir.

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

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çerir. videoAbuseReportReasons.list yöntemi, videoların işaretlenme nedenlerinin tümünün listesini almanızı sağlar.

  • Yeni videos.reportAbuse yöntemi, taciz amaçlı içerik barındıran videoları işaretlemenin bir yolunu sunar. İsteğin gövdesinde, işaretlenen videoyu ve videonun kötüye kullanım amaçlı içerik barındırdığına dair gerekçeyi belirten bir JSON nesnesi bulunur. Geçerli nedenler, yukarıda açıklanan videoAbuseReportReason.list yönteminden elde edilebilir.

    Taşıma kılavuzu da kötüye kullanım amaçlı videoları bildirme örneğiyle güncellendi. Bu değişiklikle birlikte v3 API, destekleneceği planlanan tüm v2 API özelliklerini desteklemeye başladı. Bu özelliklerin tümü taşıma rehberinde de açıklanmıştır.

• Mevcut kaynaklar ve yöntemlerle ilgili güncellemeler

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

    Bu özellikte, yüklenen her video, geliştiricinin Google Developers Console'daki uygulamasıyla ilişkili proje numarasıyla otomatik olarak etiketlenir.

    Bir arama isteği daha sonra forDeveloper parametresini true olarak ayarlarsa API sunucusu, geliştiriciyi tanımlamak için isteğin yetkilendirme kimlik bilgilerini kullanır. Bu nedenle, geliştiriciler sonuçları kendi uygulamaları veya web siteleri üzerinden yüklenen videolarla sınırlayabilir ancak diğer uygulamalar veya siteler üzerinden yüklenen videolarla sınırlayamaz.

    Yeni özellik, v2 API'nin desteklediği geliştirici etiketleri işlevine benzer ancak aynı olmayan bir işlev sunar.

  • channel kaynağının yeni snippet.country mülkü, kanal sahiplerinin kanallarını belirli bir ülkeyle ilişkilendirmesine olanak tanır.

    Not: Bir channel kaynağı için snippet.country özelliğini ayarlamak istiyorsanız aslında 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ıtlamanın bir yolunu sunar.

    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ü, bu bölgelerden birini seçen kullanıcıların yanı sıra bu bölgelerden biri otomatik olarak seçilen kullanıcılara gösterilir.

    • targeting.countries[]: Kanal bölümünün gösterildiği ülkelerin listesi. Listedeki her değer bir ISO 3166-1 alfa-2 ülke kodudur.

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

  • channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete ve videos.delete yöntemlerinin dokümanları, başarılı olduklarında bu yöntemlerin hepsinin bir HTTP 204 yanıt kodu (No Content) döndürdüğünü 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[] mülkü 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[] mülkü 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[] mülkü 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 mülkü tarafından tanımlanan üst düzey yoruma yanıt olarak yorum ekleyemezse comments.insert yöntemi bu hatayı döndürür. commentThread kaynağındaki snippet.canReply mülkü, mevcut izleyicinin ileti dizisini yanıtlayıp yanıtlayamayacağını belirtir.
    badRequest (400)	invalidChannelId	İstekteki channelId parametresi geçersiz bir kanal kimliği belirttiyse search.list yöntemi bu hatayı döndürür.
    badRequest (400)	subscriptionForbidden	API kullanıcısı 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ı desteklemiyor.

16 Nisan 2015

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

• Taşıma rehberi, hâlâ v2 API'deki yorum işlevini kullanan uygulamaların nasıl taşınacağını açıklamak için güncellendi.

  Kılavuzda, 2. sürüm API'nin desteklemediği ancak 3. sürüm API'de desteklenen çeşitli yorum özellikleri de belirtilmiştir. Bunlardan bazıları:

  • Bir kanalla ilgili yorumları alma
  • Bir kanalla ilgili tüm yorum dizilerini alma. Bu, API yanıtının kanal veya videolarıyla ilgili yorumlar içerebileceği anlamına gelir.
  • Bir yorumun metnini güncelleme
  • Yorumları spam olarak işaretleme
  • Yorumların denetleme durumunu ayarlama

• Push bildirimlerine abone olma kılavuzu, bildirimlerin daha önce belirtildiği gibi Superfeedr hub'ına değil, yalnızca Google PubSubHubBub hub'ına gönderildiği gerçeğini 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 denetlemenize olanak tanır.

  • commentThread kaynağı, bir YouTube yorum mesaj dizisi hakkında bilgi içerir. Bu mesaj dizisi, üst düzey bir yorum ve varsa bu yoruma verilen yanıtlardan oluşur. commentThread kaynağı, bir video veya kanalla ilgili 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çermediğini ve belirli bir yoruma verilen tüm yanıtları almak istiyorsanız comments.list yöntemini kullanmanız gerektiğini unutmayın. Ayrıca bazı yorumlarda yanıt yoktur.

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

    • commentThreads.list: Yorum ileti dizilerinin listesini alır. 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şturun. (Mevcut bir yorumu yanıtlamak için comments.insert yöntemini kullanın.)
    • commentThreads.update – Üst düzey bir yorumu değiştirme.

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

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

    • comments.list: Yorum listesini alır. 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 moderasyon durumunu ayarlayın. Örneğin, bir yorumu herkese açık olarak göstermek için temizleyebilir veya bir yorumu görüntülemeye uygun olmadığı için reddedebilirsiniz. API isteği, yorumlarla ilişkili kanalın veya videonun sahibi tarafından yetkilendirilmelidir.
    • comments.delete: Yorumu silebilirsiniz.

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

• Yeni Push bildirimlerine abone olma kılavuzunda, API'nin web'e erişilebilen kaynaklar için sunucudan sunucuya yayınlama/abone olma protokolü olan PubSubHubBub aracılığıyla push bildirimleri için sunduğu yeni destek açıklanmaktadır. PubSubHubBub geri çağırma sunucunuz, bir kanal aşağıdaki etkinliklerden herhangi birini yaptığında Atom feed'i bildirimleri alabilir:

  • Video yüklediğinde
  • Video başlığını günceller
  • Videonun açıklamasını günceller

• Taşıma kılavuzu da push bildirimleri için yeni desteği belirtecek şekilde güncellendi. Ancak v2 API, v3 API'de desteklenmeyen çok sayıda başka push bildirimi türünü desteklediğinden, PubSubHubBub desteğiyle ilgili bilgiler bu kılavuzun Desteği sonlandırılmış bölümünde yer almaya 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 geçerli bir kapsamdır.

• 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 artık subscriptionLimitExceeded hatasını desteklemiyor. Bu hata daha önce, istekle tanımlanan abonenin abonelik ücreti sınırını aştığını belirtiyordu.

2 Nisan 2015

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

• Yeni captions kaynağı, YouTube altyazı parçasını temsil eder. Altyazı parçaları 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'de altyazı işlevini kullanmaya devam eden uygulamaların nasıl taşınacağını açıklamak için 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. YouTube API sunucusu yalnızca HTTPS uç noktası üzerinden kullanılabildiğinden bu iki kapsam işlevsel olarak aynıdır. Sonuç olarak, https://www.googleapis.com/auth/youtube kapsamı SSL bağlantısı gerektirmese de API isteği göndermenin 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 rehberinde, v3 API'nin desteklediği ve v2 API'nin desteklemediği özellikleri listeleyen v3 API'de yeni adlı yeni bir sekme yer alır. Aynı özellikler daha önce kılavuzun diğer sekmelerinde listeleniyordu ve hâlâ 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 de Kanallar (profiller) sekmesinde listelenir.

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

  • Videoları işaretleme

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

  • Video önerilerini alma: v3 API, yalnızca mevcut API kullanıcısı için önerilen videoları içeren bir liste almaz. Ancak, activities.list yöntemini çağırıp home parametre değerini true olarak ayarlayarak önerilen videoları bulmak için v3 API'yi kullanabilirsiniz.

    API yanıtında, snippet.type mülkünün değeri recommendation ise bir kaynak, önerilen bir videoya karşılık gelir. Bu durumda contentDetails.recommendation.reason ve contentDetails.recommendation.seedResourceId özellikleri, videonun neden önerilmesiyle ilgili bilgileri içerir. Yanıtın belirli sayıda önerilen video içereceğinin garanti edilmediğini 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. Ancak, activities.list yöntemini çağırıp home parametresi değerini true olarak ayarlayarak yeni abonelik videolarını bulmak için v3 API'yi kullanabilirsiniz.

    API yanıtında, snippet.type mülkünün değeri upload ise bir kaynak yeni bir abonelik videosuna karşılık gelir. Yanıtın belirli sayıda yeni abonelik videosu içereceği garanti edilmez.

  • RSS özet akışı desteği

  • Feed güncellemeleri için push bildirimleri: v2 API, YouTube kullanıcılarının kullanıcı etkinliği feed'lerini izlemek için Basit Güncelleme Protokolü (SUP) veya PubSubHubbub'u kullanarak push bildirimleri destekler. Yeni kanal abonelikleri ve videoların puanlanması, paylaşılması, favorilere eklenmesi, yorumlanması veya yüklenmesi gibi durumlarda bildirim gönderiliyordu.

    V3 API, PubSubHubbub protokolünü kullanan push bildirimleri destekler ancak bildirimler yalnızca video yüklemelerini ve video başlıklarında ya da video açıklamalarında yapılan güncellemeleri kapsar.

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

  • Geliştirici etiketleri ayarlama veya alma: v2 API, video yüklenirken videoyla anahtar kelimeleri veya geliştirici etiketlerini ilişkilendirme özelliğini destekler. 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 sunacaktır. Geliştiriciler, kendi uygulamaları tarafından yüklenen videoları arayabilir. Bu özellikte, yüklenen her video, geliştiricinin Google Developers Console'daki uygulamasıyla ilişkili proje numarasıyla otomatik olarak etiketlenir. Geliştirici daha sonra 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: 2. sürüm API'de orderby parametresi, oynatma listesindeki videoları konuma, süreye, yayınlanma tarihine, başlığa ve diğer çeşitli değerlere göre sıralamanıza olanak tanır. v3 API'de oynatma listesi öğeleri genellikle konuma göre artan düzende sıralanır ve diğer sıralama seçenekleri kullanılamaz.

    Bununla birlikte, birkaç istisna vardır. Aşağıdaki oynatma listesi türlerinde yeni yüklenen, favori, beğendiğiniz veya son izlenen videolar otomatik olarak ilk öğe (snippet.position=0) olarak eklenir. Bu nedenle, bu listelerin her biri, öğelerin listeye eklenme zamanlarına göre en yeniden en eskiye doğru etkili bir şekilde sıralanır.

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

    Ancak "Sonra izle" oynatma listesine eklenen yeni öğelerin, listenin sonuna eklendiğini unutmayın. Bu nedenle, liste en eskiden en yeniye 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'nin channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list ve videos.list yöntemlerinin tümü, virgülle ayrılmış bir kimlik listesi (video kimlikleri, kanal kimlikleri vb.) belirtmek için kullanılabilen bir id parametresini destekler. Bu yöntemleri kullanarak tek bir istekle birden fazla kaynağın listesini alabilirsiniz.

  Bu değişikliklerle birlikte kılavuzda artık eski API'de (v2) desteklenen ve mevcut API sürümünde (v3) desteği sonlandırılacak tüm işlevler belirtilmektedir.

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 bazı yöntemlerde zaten desteklenen onBehalfOfContentOwner parametresini desteklemektedir.

• Aşağıdaki mülklerin ve alt mülklerinin desteği sonlandırıldı:

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

  Not: Bu mülklerin hiçbiri API Desteği Sonlandırma Politikası'na tabi değildi.

• video kaynağının yeni contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons mülkü, videonun DJCQT (Brezilya) derecelendirmesini almasının nedenlerini 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ışır ancak oynatma listesi manuel sıralama kullanmıyorsa 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üzenleyebilirsiniz.
  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 uygun ş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 belirtiyorsa videos.list yöntemi bu hatayı döndürür.
  badRequest (400)	invalidRating	İstek, rating parametresi için beklenmeyen bir değer içeriyorsa 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 destekliyor.

  YouTube Data API (v3) taşıma rehberi de bu yeni parametrenin nasıl kullanılacağını açıklamak için güncellendi. Parametre, mevcut API sürümü (v3) ile desteği sonlandırılmış önceki sürüm (v2) arasında daha önce var olan bir özellik boşluğunu ele alır.

• YouTube Data API (v3) taşıma kılavuzu da filmler, fragmanlar, televizyon programları, televizyon sezonları ve televizyon bölümlerini tanımlamak için v2 API'nin sağladığı özel feed'lerin ve meta veri alanlarının kullanımdan kaldırıldığı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 kılavuzu, JavaScript kullanarak video yüklemek için v3 API'nin nasıl kullanılacağını açıklamak üzere 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ıya dayalı yükleme işleviyle benzerdir. Taşıma rehberinde yapılan bu değişikliğin, gerçek bir API değişikliğini değil, istemci tarafı JavaScript ile video yüklemek için yeni örnek kodun kullanıma sunulduğunu yansıttığını unutmayın.

  JavaScript istemci kitaplığı ve CORS ile video yükleme desteğinin sunulması nedeniyle, taşıma rehberinde artık tarayıcı tabanlı yükleme, v3 API'de desteği sonlandırılabilecek bir özellik olarak listelenmiyor.

• videos.insert yönteminin 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ştirildi.

  Önemli: Birçok 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ı bulmak için aşağıdaki iki yöntemden yararlanabilirsiniz.

  • Kota maliyeti: 100 birim

    search.list yöntemini çağırın ve GoogleDevelopers için arama yapın.

  • Kota maliyeti: 6 birim

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

    Ardından playlistItems.list yöntemini çağırın ve playlistId parametresini yakalanan kimliğe, 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 özellik içerir:

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

    • allowed: Kanal 15 dakikadan uzun videolar yükleyebilir.
    • eligible: Kanal, 15 dakikadan uzun videolar yüklemeye uygundur ancak önce 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. Bu özellik hakkında daha ayrıntılı bilgi için YouTube Yardım Merkezi'ni de ziyaret edebilirsiniz.

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

• video kaynağının snippet.title ve snippet.categoryId özelliklerinin tanımları, API'nin videos.update yöntemine yönelik ç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 her iki özellik için de bir değer ayarlamanız gerekir.

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

• Yeni Zelanda Film ve Edebiyat Sınıflandırma Kurumu'nun video derecelendirmesini tanımlayan video kaynağının contentDetails.contentRating.oflcRating mülkü artık iki yeni derecelendirmeyi (oflcRp13 ve oflcRp16) destekliyor. Bunlar sırasıyla RP13 ve RP16 derecelendirmelerine karşılık gelir.

• channelBanners.insert yöntemi artık aşağıdaki 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 gidip albümler sayfasına giderek bu albümdeki bazı resimleri kaldırmalıdır.

12 Eylül 2014

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

• search.list yönteminin çağrısı için kota maliyeti, belirtilen kaynak bölümlerinin maliyetine ek olarak 1 birimden 2 birime yükseltildi.

13 Ağustos 2014

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

• subscriptions.insert yöntemi artık aşağıdaki hatayı desteklemektedir:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest	subscriptionLimitExceeded	İstekte belirtilen abone, abonelik oranı sınırını aştı. Birkaç saat içinde daha fazla abonelik denemesi yapılabilir.

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 bir kılavuzda, YouTube Data API'de (v2) bulunan işlevleri gerçekleştirmek için YouTube Data API'nin (v3) nasıl kullanılacağı açıklanmaktadır. Eski API, 4 Mart 2014 itibarıyla resmi olarak kullanımdan kaldırılmıştır. Bu kılavuzun amacı, hâlâ v2 API'yi kullanan 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 aşağıdaki hatayı desteklemektedir:

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest	maxPlaylistExceeded	Bu hata, kanalda izin verilen maksimum oynatma listesi sayısına ulaşıldığı için oynatma listesi oluşturulamadığında ortaya çıkar.

18 Haziran 2014

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

• Her API yönteminin açıklaması, söz konusu yönteme yapılan bir çağrının neden olduğu kota maliyetini içerecek şekilde güncellendi. Benzer şekilde, part parametrelerinin tanımları, bir API çağrısında alınabilecek her bir parçanı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ümden (snippet, contentDetails ve subscriberSnippet) oluşur ve bunların her birinin maliyeti iki birimdir.

  Kota maliyetlerinin önceden haber verilmeden 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 destekliyor. Yeni desteklenen derecelendirme sistemleri şunlardır: Arjantin, Avusturya, Belçika, Bulgaristan, Şili (televizyon), Şili (film), Çekya, Kolombiya, Danimarka, Mısır, Estonya, Finlandiya, Fransa, Yunanistan, Hong Kong, İzlanda, Endonezya, İrlanda, İsrail, İtalya, Kenya, Letonya, Lüksemburg, Malezya, Maldivler, Malta, Hollanda, Nijerya, Norveç, Peru, Filipinler, Portekiz, Romanya, Singapur, Slovakya, Güney Afrika, İsveç, İsviçre, Tayvan, Tayland ve Venezuela.

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şkili videoları aramanıza olanak tanıyan location ve locationRadius parametrelerini destekliyor. Sonuçları konuma göre almak için istekte her iki parametre için de bir değer belirtilmelidir. Bir istek iki parametreden yalnızca birini içeriyorsa API hata döndürür.

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

  • locationRadius parametresi, bir videonun arama sonuçlarına dahil edilebilmesi için videoyla ilişkili konumun alanın merkezinden ne kadar uzak olabileceğini belirtir.

13 Mayıs 2014

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

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

• channelSection kaynağı artık birkaç yeni öne çıkan içerik türü hakkında bilgi içerebilir. channelSection kaynağının snippet.type mülkü artık aşağıdaki değerleri desteklemektedir:

  • postedPlaylists: Kanal sahibinin kanalın etkinlik özet akışında yayınladığı oynatma listeleri
  • postedVideos: Kanal sahibinin kanalın etkinlik akışına yayınladığı videolar
  • subscriptions: Kanal sahibinin abone olduğu kanallar

• video kaynağının yeni contentDetails.contentRating.ifcoRating mülkü, bir videonun İrlanda Film Sınıflandırma Kurumu'ndan aldığı derecelendirmeyi tanımlar.

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

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

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

• watermarks.set ve watermarks.unset yöntemleri, API'nin bu yöntemlere yapılan 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 uygulama dili, Google Hesabı ayarlarına, tarayıcı diline veya IP konumuna göre otomatik olarak seçilebilir. Kullanıcılar, YouTube sitesinin altbilgisinden istedikleri kullanıcı arayüzü dilini manuel olarak da seçebilir.

  API, desteklenen uygulama dillerini listelemeyi destekler. videoCategories.list ve guideCategories.list gibi API yöntemleri çağrılırken desteklenen diller 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 coğrafi bir alanı tanımlar. İçerik bölgesi, içerik yerel dili olarak da adlandırılabilir. YouTube web sitesi için içerik bölgesi, YouTube alanı veya kullanıcının IP konumu gibi sezgisel kurallara göre otomatik olarak seçilebilir. Kullanıcılar, YouTube site altbilgisinden istedikleri içerik bölgesini manuel olarak da seçebilir.

  API, desteklenen içerik bölgelerinin listelenmesini destekler. Desteklenen bölge kodları, search.list, videos.list, activities.list ve videoCategories.list gibi API yöntemleri çağrılı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 çıkarmak için seçtiği videolarla ilgili bilgileri içerir. Örneğin, bir bölümde kanalın en yeni yüklemeleri, en popüler yüklemeleri veya bir veya daha fazla oynatma listesindeki videolar yer alabilir.

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

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

• video kaynağının fileDetails nesnesi, yalnızca videonun processingDetails.fileDetailsAvailability özelliğinin değeri available ise bu nesnenin döndürüleceğini açıklayacak şekilde güncellendi.

  Benzer şekilde, video kaynağının suggestions nesnesi, yalnızca videonun processingDetails.tagSuggestionsAvailability veya processingDetails.editorSuggestionsAvailability özelliğinin değeri available ise bu nesnenin döndürüleceğini açıklayacak şekilde güncellendi.

• videos.insert ve videos.update yöntemlerinin 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 nesnesi, nesnenin yalnızca kanalın sahibi tarafından alınabileceğini açıklayacak şekilde güncellendi.

• videos.rate yönteminin parametre listesi, bu yöntemin aslında onBehalfOfContentOwner parametresini desteklemediğini yansıtacak şekilde güncellendi. Bu parametreyi ayarlayan videos.rate istekleri 500 hatası döndürdüğü için bu bir doküman hatasıydı.

31 Mart 2014

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

• video kaynağının yeni status.publishAt mülkü, gizli bir videonun yayınlanması planlanan tarihi ve saati belirtmenize olanak tanır. 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ü destekliyor. Yeni bölümde, kanala bağlı YouTube iş ortaklarıyla alakalı kanal verileri yer alır. Bu veriler arasında kanala bağlı içerik sahibinin kimliği ve içerik sahibi ile kanalın bağlandığı tarih ve saat bulunur. Bu yeni bölümün destek sonlandırma politikasına tabi olmadığını unutmayın.

• Artık dokümanda aşağıdaki mülkler için desteklenen maksimum karakter uzunluğu listelenmektedir:

  Kaynak	Mülk	Maksimum uzunluk
  channel	invideoPromotion.items[].customMessage	40 karakter
  video	snippet.title	100 karakter
  video	snippet.description	5.000 bayt
  video	snippet.tags	500 karakter. Mülk 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ğinin desteği sonlandırıldı. Değerini ayarlamaya çalışırsanız API bir hata döndürür.

• Aşağıdaki video kaynak özellikleri, video eklenirken veya güncellenirken ayarlanabilecek değerler listesine eklendi:

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

• Hata dokümanlarında artık her hata türünün HTTP yanıt kodu belirtilmektedir.

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

  Hata türü	Hata ayrıntısı	Açıklama
  badRequest (400)	invalidCriteria	İstek, birbiriyle birlikte kullanılamayan 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 mülkünün değerini değiştirmeye çalışırsanız channels.update yöntemi bu hatayı döndürür. (Mülkü atlarsanız API'nin hatayı döndürmediğini unutmayın.)
  badRequest (400)	invalidRecentlyUploadedBy	invideoPromotion.items[].id.recentlyUploadedBy mülkü geçersiz bir kanal kimliği belirtirse channels.update yöntemi bu hatayı döndürür.
  badRequest (400)	invalidTimingOffset	invideoPromotion kısmı geçersiz bir zamanlama ofseti belirtirse channels.update yöntemi bu hatayı döndürür.
  badRequest (400)	tooManyPromotedItems	invideoPromotion kısmı, izin verilenden daha fazla tanıtılan öğe belirtiyorsa channels.update yöntemi bu hatayı döndürür.
  forbidden (403)	promotedVideoNotAllowed	invideoPromotion.items[].id.videoId mülkü, bulunamayan veya tanıtılan öğe olarak kullanılamayan bir video kimliği belirtiyorsa channels.update yöntemi bu hatayı döndürür.
  forbidden (403)	websiteLinkNotAllowed	invideoPromotion.items[].id.websiteUrl mülkü izin verilmeyen bir URL belirtiyorsa channels.update yöntemi bu hatayı döndürür.
  required (400)	requiredTimingType	Bir istek, YouTube'un tanıtılan bir öğeyi ne zaman göstermesi gerektiğine dair varsayılan zamanlama ayarlarını belirtmezse 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, her tanıtılan öğ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, YouTube API'leri Hizmet Şartları'nda açıklanan Desteği Sonlandırılan API Politikası'na tabidir. Desteği sonlandırılan API'leri listeleyen sayfanın, bazı v3 API işlevlerini politika kapsamından ö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 şekilde yansıtacak şekilde güncellendi. Bunun yerine, sıfır filtre parametresi veya bir filtre parametresi için bir değer ayarlayabilirsiniz.

• search.list yönteminin parametrelerinin tanımları, aşağıdaki parametrelerden herhangi biri için de değer belirtirseniz type parametresinin değerini video olarak ayarlamanız gerektiğini belirtecek şekilde güncellendi:

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

• Yüklenen kanal banner resimlerinin minimum boyutu 2048 piksel x 1152 piksel olarak düşürüldü. (Önceki minimum boyut 2.120 piksel x 1.192 piksel idi.) Ayrıca, channel kaynak dokümanlarında API'den sunulan tüm banner resimlerinin maksimum boyutlarının belirtildiğini unutmayın. Örneğin, televizyon uygulamaları için brandingSettings.image.bannerTvImageUrl resminin maksimum boyutu 2.120 piksel x 1.192 pikseldir ancak gerçek resim 2.048 piksel x 1.152 piksel olabilir. Kanal resmini farklı cihaz türlerinde gösterilecek şekilde optimize etmeyle ilgili daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.

• Birkaç channel kaynak özelliği tanımı, aşağıdaki bilgileri yansıtacak şekilde güncellendi:

  • brandingSettings.channel.description mülkünün değeri en fazla 1.000 karakter uzunluğunda olabilir.
  • brandingSettings.channel.featuredChannelsTitle mülkü en fazla 30 karakter uzunluğunda olabilir.
  • brandingSettings.channel.featuredChannelsUrls[] mülkü artık en fazla 100 kanal listeleyebilir.
  • brandingSettings.channel.unsubscribedTrailer mülk değeri (ayarlanmışsa) 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 mülkünde güncellemeleri desteklemektedir. Bu özellik, promosyon gösterilirken içerik sahibinin adının gösterilip gösterilmeyeceğini belirtir. Yalnızca mülk değerini ayarlayan 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 bazı yöntemlerde zaten desteklenen onBehalfOfContentOwner parametresini desteklemektedir.

• contentDetails.contentRating.acbRating mülkü artık filmler için Avustralya Sınıflandırma Kurulu (ACB) veya çocuk televizyon programları için Avustralya İletişim ve Medya Kurumu (ACMA) tarafından verilen bir derecelendirmeyi belirtebilir.

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

• videoCategory kaynağının yeni snippet.assignable mülkü, güncellenen veya yeni yüklenen videoların bu video kategorisiyle ilişkilendirilip ilişkilendirilemeyeceğini belirtir.

• 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ğini bulmanıza ve öne çıkarmanıza yardımcı olmak için tasarlanmış iki ek özellik içerir:

  Arama sonuçlarındaki yeni snippet.liveBroadcastContent mülkü, bir videonun veya kanal kaynağının canlı yayın içeriği olup olmadığını belirtir. Geçerli özellik değerleri upcoming, active ve none'dir.

  • video kaynağının yeni snippet.liveBroadcastContent mülkü, videonun yaklaşan bir canlı yayın mı yoksa etkin bir canlı yayın mı olduğunu belirtir. 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 için mülk değeridir.

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

    • liveStreamingDetails.actualStartTime: Yayının gerçekte başladığı saat. (Bu değer, yayının durumu active olduğunda gösterilir.)
    • liveStreamingDetails.actualEndTime: Yayının gerçekte sona erdiği zaman. (Bu değer, yayın sona erdiğinde gösterilir.)
    • liveStreamingDetails.scheduledStartTime: Yayının başlamasının planlandığı zaman.
    • liveStreamingDetails.scheduledEndTime: Yayının sona ermesinin planlandığı zaman. Mülk değeri boşsa veya mülk mevcut değilse yayının süresiz olarak devam etmesi planlanır.
    • liveStreamingDetails.concurrentViewers: Canlı yayını izleyen kullanıcıların sayısı.

    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ımlamak için 1 Ekim 2013'te kullanıma sunulan diğer iki özelliği (search.list yönteminin eventType parametresi ve arama sonucunun snippet.liveBroadcastContent mülkü) unutmayın.

• videos.insert yöntemi artık YouTube'un yeni videonun kanalına abone olan kullanıcılara yeni videoyla ilgili bildirim gönderip göndermeyeceğini belirten notifySubscribers parametresini destekliyor. Parametrenin varsayılan değeri True'tür. Bu değer, abonelerin yeni yüklenen videolardan haberdar edileceğini gösterir. Ancak çok sayıda video yükleyen bir kanal sahibi, kanalın abonelerine her yeni videoyla ilgili bildirim göndermemek için değeri False olarak ayarlayabilir.

• 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ştirilebilir brandingSettings özelliklerini tanımlayacak şekilde değiştirildi. Bu brandingSettings mülkleri zaten değiştirilebilir durumdaydı. Dolayısıyla dokümanda yapılan değişiklik, API'nin mevcut işlevinde bir değişikliğe işaret etmiyor.

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

• playlists.insert yöntemi artık diğer bazı yöntemlerde zaten desteklenen onBehalfOfContentOwnerChannel parametresini desteklemektedir.

• video kaynağının contentDetails.contentRating.tvpgRating mülkü artık TV-14 derecelendirmesine karşılık gelen pg14 değerini desteklemektedir.

• Arama sonuçlarının bir parçası olan snippet.liveBroadcastContent mülkünün tanımı, live'un geçerli bir mülk değeri olduğunu ancak active'in geçerli bir mülk değeri olmadığını yansıtacak şekilde düzeltildi.

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

  • mibacVap (VAP) – Çocuklara yetişkin eşlik 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 mülkü, promosyon gösterilirken 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 gönderiliyorsa 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, çok kanallı bir ağın (MCN) belirli bir kanalı kabul edip etmeyeceği konusunda değerlendirme yapacağı kanal verilerini içerir. Bu kaynak bölümünü alan tüm 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, bu kapsamı kullanan tüm jetonlar, MCN kanalı kabul etmeye veya reddetmeye karar verdiğinde ya da jetonun verildiği tarihten itibaren iki hafta içinde iptal edilmelidir.

• channel kaynağının invideoPromotion.items[].id.type mülkü artık recentUpload değerini destekliyor. Bu değer, tanıtılan öğenin belirtilen 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. Ancak yeni invideoPromotion.items[].id.recentlyUploadedBy mülkünün değerini ilgili 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çerir.

• Arama sonuçlarındaki yeni snippet.liveBroadcastContent mülkü, bir videonun veya kanal kaynağının canlı yayın içeriği olup olmadığını belirtir. Geçerli özellik değerleri upcoming, active ve none'dir.

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

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

• thumbnails.set yöntemi artık diğer bazı yöntemlerde zaten desteklenen onBehalfOfContentOwner parametresini desteklemektedir.

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

• Yeni contentDetails.contentRating.mibacRating mülkü, bir videonun İtalya'nın Ministero dei Beni e delle Attivita Culturali e del Turismo kurumu tarafından 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	Puanlanan videonun sahibi videonun puanlarını devre dışı bıraktıysa 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ğı, belirtilen bir kanalın videolarının oynatılması sırasında gösterilen resmi tanımlar. Ayrıca, resmin bağlantı vereceği hedef kanalı ve video oynatıldığında filigranın ne zaman ve ne kadar süreyle görüneceğini belirleyen zamanlama ayrıntılarını da belirtebilirsiniz.

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

  Hata dokümanı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 belirten bir boole değeri içerir. Bu nedenle, kanalın abone sayısı herkese açık olarak görünüyorsa mülkün değeri false olur.

• playlists.list yöntemi artık onBehalfOfContentOwner ve onBehalfOfContentOwnerChannel parametrelerini destekliyor. Her iki parametre de diğer çeşitli yöntemler için zaten desteklenmektedir.

• videos.list yöntemi artık bir grafiğin alınması gereken içerik bölgesini tanımlayan regionCode parametresini destekliyor. 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 ortaya çıkabilecek aşağıdaki yeni ve yaygın istek hatasını açıklar:

  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şmek 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 sahiptir:

  • API artık bir web sitesini tanıtılan öğe olarak belirtme özelliğini destekliyor. Bunu yapmak için invideoPromotion.items[].id.type mülk değerini website olarak ayarlayın ve URL'yi belirtmek için yeni invideoPromotion.items[].id.websiteUrl mülkünü kullanın. Promosyon için gösterilecek özel bir mesaj tanımlamak üzere yeni invideoPromotion.items[].customMessage mülkünü de kullanın.

    Bağlantılar ilişkili web sitelerine, satıcı sitelerine veya sosyal ağ sitelerine yönlendirebilir. İçeriğinizin bağlantılarını etkinleştirme hakkında daha fazla bilgi için ilişkili web siteleri ve satıcı siteleri ile ilgili YouTube Yardım Merkezi talimatlarına bakın.

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

  • Video oynatma sırasında tanıtılan öğelerin gösterilmesiyle ilgili 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 tanıtılan öğenin zamanlama verilerini özelleştirmenize olanak tanır.

    • Yeni invideoPromotion.defaultTiming nesnesi, promosyonunuz için varsayılan zamanlama ayarlarını belirtir. Bu ayarlar, tanıtılan bir öğenin kanalınızın videolarından birinin oynatılması sırasında ne zaman gösterileceğini belirler. invideoPromotion.items[].timing nesnesini kullanarak, tanıtılan herhangi bir öğenin varsayılan zamanlamasını geçersiz kılabilirsiniz.

    • Yeni invideoPromotion.items[].timing.durationMs mülkü, promosyonun milisaniye cinsinden ne kadar süreyle gösterileceğini belirtir. invideoPromotion.defaultTiming nesnesi, tanıtılan öğenin varsayılan olarak gösterileceği 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 destekliyor. Her iki parametre de diğer çeşitli yöntemler için zaten desteklenmektedir.

• thumbnails.set isteğine verilen API yanıtında kind mülk değeri youtube#thumbnailListResponse yerine 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önteminin gösterdiği işlev artık videos.rate yöntemi tarafından ele alındığından playlistItems.insert yöntemine ait Python örneğinin de kaldırıldığını unutmayın.

• error documentation, mine istek parametresini destekleyen herhangi bir API yönteminde ortaya çıkabilecek 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ğrulanmış 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ğrulamanız veya çağrılan yöntem için uygunsa onBehalfOfContentOwnerChannel parametresini sağlayarak iş ortağının kanallarından biri gibi davranmanız gerekir.

8 Ağustos 2013

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

• YouTube Data API'yi Kullanmaya Başlama kılavuzunun Kota Kullanımı bölümü, video yükleme kota maliyetinin yaklaşık 16.000 birimden yaklaşık 1.600 birime düşürülmesini yansıtacak şekilde güncellendi.

30 Temmuz 2013

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

• Bir channelBanner kaynağında, kind mülkünün değeri youtube#channelBannerInsertResponse yerine youtube#channelBannerResource olarak değiştirildi. Bu kaynak, channelBanners.insert isteğine yanıt olarak döndürülür.

• channel kaynağının yeni brandingSettings.channel.profileColor mülkü, kanalın içeriğini tamamlayan belirgin bir renk belirtir. Özellik değeri, pound işareti (#) ve ardından altı karakterli bir onaltılık dize (#2793e6 gibi) şeklindedir.

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

• 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 yalnızca mostPopular değeri desteklenmektedir. chart parametresinin bir filtre parametresi olduğunu unutmayın. Diğer filtre parametreleriyle (id ve myRating) aynı istekte kullanılamaz.
  • videoCategoryId parametresi, grafiğin alınması gereken video kategorisini tanımlar. Bu parametre yalnızca chart parametresiyle birlikte kullanılabilir. Grafikler varsayılan olarak belirli bir kategoriyle sınırlı değildir.

• video kaynağının yeni topicDetails.relevantTopicIds[] mülkü, video veya içeriğiyle alakalı Freebase konu kimliklerinin listesini sağlar. Bu konuların özetleri videoda yer alabilir veya videoda bu konularla ilgili bahsedilebilir.

• video kaynağının recordingDetails.location.elevation özelliği recordingDetails.location.altitude olarak, 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 vb. gibi çeşitli derecelendirme sistemleri kapsamında aldığı derecelendirmeleri belirtir. API artık her derecelendirme sistemi için videonun derecelendirilmediğini belirten bir derecelendirme değeri desteklemektedir. MPAA derecelendirmeleri için, filmin sansürsüz versiyonunun resmi bir derecelendirme aldığını belirtmek üzere sıklıkla "derecelendirilmemiş" derecelendirmesinin kullanıldığını unutmayın.

• video kaynağının yeni contentDetails.contentRating.ytRating mülkü, yaş kısıtlaması olan içeriği tanımlar. YouTube, videonun 18 yaşından küçük kullanıcılar için uygunsuz içerik barındırdığını belirlerse mülkün değeri ytAgeRestricted olur. Mülk yoksa veya mülk 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ğrulanmış kullanıcının kanalına abone olan kullanıcıların listesini almak için subscriptions.list yöntemini ve mySubscribers parametresini kullanın.

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

• 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ümanda artık channel kaynağının invideoPromotion nesnesi için ayarlayabileceğiniz güncellenmiş özellik listesi de yer alıyor.

• error documentation, aşağıdaki yeni hataları açıklar:

  Hata türü	Hata ayrıntısı	Açıklama
  forbidden	accountDelegationForbidden	Bu hata belirli bir API yöntemine özgü değildir. Kimliği doğrulanmış kullanıcının, belirtilen Google Hesabı adına işlem yapma yetkisinin olmadığını gösterir.
  forbidden	authenticatedUserAccountClosed	Bu hata belirli bir API yöntemine özgü değildir. Kimlik doğrulaması yapılan kullanıcının YouTube hesabının kapalı olduğunu gösterir. Kullanıcı başka bir Google Hesabı adına hareket ediyorsa bu hata, söz konusu hesabın kapatıldığını gösterir.
  forbidden	authenticatedUserAccountSuspended	Bu hata belirli bir API yöntemine özgü değildir. Kimlik doğrulaması yapılan 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, söz konusu 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 yetkiliyse 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 parçaları belirtir.
  badRequest	videoChartNotFound	videos.list yöntemi, istek desteklenmeyen veya kullanılamayan bir video grafiği belirttiğinde 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ğruluğundan emin olmak için istek gövdesinde id mülkünün 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 bir kanalla ilgili bilgileri almanızı sağlar.

• activities.list yöntemi artık API'ye belirtilen ülkeyle alakalı sonuçlar döndürmesini bildiren regionCode parametresini desteklemektedir. 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 mülkünü içeriyor. Mülk yalnızca kendi oynatma listeleriyle ilgili verileri 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 etiketleri 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önteminin çağrısında kullanıldığında, istekte videonun ekleneceği kanalı tanımlayan yeni onBehalfOfContentOwnerChannel parametresi için bir değer de belirtilmesi 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 içerik yönetim sistemi kullanıcısını tanımladığını belirtir. Kullanıcının kimlik doğrulaması yaptığı İYS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.

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

  Özellikle bu sürümde, parametre artık içerik iş ortaklarının sahip olduğu YouTube kanallarından herhangi birine video eklemesine, güncellemesine veya silmesine olanak tanır.

• error documentation, aşağıdaki yeni hataları açıklar:

  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 içerik yönetim sistemi 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ığında ancak düzgün şekilde yetkilendirilmediğinde bu hatayı döndürür.

• Kanal kimliği, kaynağın id özelliği kullanılarak zaten belirtildiği için channels kaynağında 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 kılavuz, API'nin önceki sürümünden geçiş yapan ve default kullanıcısı için içerik isteyen veya artık geçerli olmayan her YouTube kanalının benzersiz bir kullanıcı adı olduğu fikrine dayanan uygulamaları olan 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 mülkü kullanılarak bir kanalın banner resmi olarak ayarlanabilecek bir banner resmi yüklemenize olanak tanır.

• 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 unspecified artık 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 parametresinin varsayılan değeri artık 5.

• error documentation artık channelBanners.insert ve subscriptions.list yöntemleriyle ilgili hataları listeliyor. Ayrıca channels.update yöntemi için birkaç yeni hata da listelenir.

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 listeleniyor.

• Python kod örneklerini listeleyen sayfada artık abonelik ekleme, oynatma listesi oluşturma ve video güncelleme örnekleri de yer alıyor.

10 Mayıs 2013

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

• YouTube artık deneysel API özelliklerini ve hizmetlerini tanımlamıyor. Bunun yerine, destek sonlandırma politikasına tabi olan YouTube API'lerinin listesini sunuyoruz.

8 Mayıs 2013

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

• Kanal kaynakları artık kanalla ilişkili tanıtım kampanyasıyla ilgili bilgileri kapsayan inVideoPromotion nesnesini destekliyor. Kanallar, video içi tanıtım kampanyaları kullanarak kanaldaki videoların oynatılması sırasında video oynatıcıda tanıtılan videoların küçük resimlerini gösterebilir.

  Bu verileri, channels.list isteğinde part parametre değerine invideoPromotion ekleyerek alabilirsiniz.

• Yeni channels.update yöntemi, bir 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ündeki güncellemeleri desteklediğini ve henüz bu kaynağın diğer bölümlerindeki 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 mülkünü destekliyor. Bu mülk, kanal verilerinin halihazırda bir YouTube kullanıcı adına veya Google+ hesabına bağlı bir kullanıcıyı tanımlayıp tanımlamadığını belirtir. Bu bağlantılardan birine sahip olan kullanıcıların herkese açık bir YouTube kimliği vardır. Bu kimlik, video yükleme gibi çeşitli işlemler için ön koşuldur.

• Abonelik kaynakları artık subscriberSnippet bölümünü destekliyor. Bu nesne, abonenin kanalına ait snippet verilerini kapsar.

• API artık kimliği doğrulanmış kullanıcının bir veya daha fazla video listesine verdiği puanları alan videos.getRating yöntemini destekliyor.

• videos.list yönteminin yeni myRating parametresi, kimliği doğrulanmış kullanıcının like veya dislike puanı verdiği videoların listesini almanızı sağlar.

  myRating parametresi ve id parametresi artık filtre parametreleri olarak kabul edilir. Bu, bir API isteğinde bu parametrelerden tam olarak birinin belirtilmesi gerektiği anlamına gelir. (Daha önce id parametresi bu yöntem için zorunlu bir parametreydi.)

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

• myRating parametresinin kullanıma sunulmasıyla birlikte videos.list yöntemi de sayfalandırmayı desteklemek için güncellendi. Ancak sayfalandırma parametrelerinin yalnızca myRating parametresinin kullanıldığı istekler için desteklendiğini unutmayın. (id parametresini kullanan istekler için sayfalama parametreleri ve bilgileri desteklenmez.)

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

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

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

  • autoLevels: YouTube'a videonun ışıklandırmasını ve rengini otomatik olarak iyileştirmesini talimat vermek için bu parametre değerini true olarak ayarlayın.
  • stabilize: YouTube'a, kamera hareketlerinden kaynaklanan titremeyi gidererek videoyu ayarlaması için bu parametre değerini true olarak ayarlayın.

• channelTitle özelliği, aşağıdaki kaynaklar için snippet'a eklendi:

  • playlistItem: Bu ö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 olunan kanalın adını belirtir.

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

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

• subscriptions.list yönteminin yeni mySubscribers parametresi, kimliği doğrulanan kullanıcının abonelerinin listesini almanızı sağlar. Bu parametre yalnızca uygun şekilde yetkilendirilmiş bir isteğinde kullanılabilir.

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

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

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

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

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

19 Nisan 2013

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

• Yeni videos.rate yöntemi, kullanıcıların videolara like veya dislike derecelendirmesi eklemesine ya da mevcut derecelendirmeleri kaldırmasına olanak tanır.

  Hata dokümanları da API'nin bir 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ımlanmaktadır. Yeni thumbnails.set yöntemi, YouTube'a özel bir video küçük resmi yüklemenizi ve bu küçük resmi bir video için ayarlamanızı sağlar.

  Hata dokümanları da API'nin bir 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 döndüren mevcut kaynakları etkilemediğini unutmayın. Küçük resimler, bu kaynaklarda daha önce olduğu gibi döndürülür. Ancak dokümanda 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ı için ayarları, metinleri ve resimleri tanımlar.

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

  • Yeni status nesnesi, oynatma listesi öğesiyle ilgili durum bilgilerini kapsar ve status.privacyStatus mülkü, oynatma listesi öğesinin gizlilik durumunu tanımlar.

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

  • status.publicStatsViewable mülkü, izleme sayfasındaki genişletilmiş video istatistiklerinin herkese açık olarak görüntülenebilir olup olmadığını belirtir. Bu istatistikler varsayılan olarak görüntülenebilir. Bu mülkün değeri false olarak ayarlanmış olsa bile videonun görüntüleme sayısı ve puanları gibi istatistikler herkese açık olarak görünmeye devam eder. videos.insert veya videos.update yöntemini çağırırken bu özelliğin değerini ayarlayabilirsiniz.

  • contentDetails.contentRating nesnesi, videonun çeşitli derecelendirme sistemleri kapsamında aldığı derecelendirmeleri kapsar. Aşağıdaki listede desteklenen derecelendirme sistemleri tanımlanmakta ve her derecelendirme sistemiyle ilişkili tesisin bağlantısı sağlanmaktadır. Mülk tanımları, her sistem için desteklenen derecelendirme değerlerini tanımlar.

    Ülke	Derecelendirme sistemi	Mülk
    Amerika Birleşik Devletleri	Motion Picture Association of America (MPAA)	contentDetails.contentRating.mpaaRating
    Amerika Birleşik Devletleri	TV Ebeveyn Yönergeleri	contentDetails.contentRating.tvpgRating
    Avustralya	Australian Classification Board (ACB)	contentDetails.contentRating.acbRating
    Brezilya	Departamento de Justiça, Classificação, Qualificação e Títulos	contentDetails.contentRating.djctqRating
    Kanada	Kanada Ev Videoları Derecelendirme Sistemi (CHVRS)	contentDetails.contentRating.chvrsRating
    Fransa	Centre national du cinéma et de l'image animée (Fransa Kültür Bakanlığı)	contentDetails.contentRating.fmocRating
    Almanya	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	contentDetails.contentRating.fskRating
    İngiltere	British Board of Film Classification (BBFC)	contentDetails.contentRating.bbfcRating
    Hindistan	Central Board of Film Certification (CBFC)	contentDetails.contentRating.cbfcRating
    Japonya	映倫管理委員会 (EIRIN)	contentDetails.contentRating.eirinRating
    Kore	영상물등급위원회 (KMRB)	contentDetails.contentRating.kmrbRating
    Meksika	Radyo, Televizyon ve Sinema 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 Kayıtları	contentDetails.contentRating.russiaRating
    İspanya	Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA)	contentDetails.contentRating.icaaRating

• playlistItems.update yönteminin dokümanları, snippet.resourceId mülkünün istek gövdesi olarak gönderilen kaynakta 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 göre alfabetik olarak (order=title) veya video sayısına göre azalan düzende (order=videoCount) sıralama özelliğini destekliyor.

  • Yeni safeSearch parametresi, arama sonuçlarının kısıtlanmış içerik içermesi gerekip gerekmediğini belirtir.

• 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 mülkü 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	İstek 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'a 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, kanal aramasını tüm kanalları veya yalnızca programları alacak şekilde kısıtlamanıza olanak tanır.

  • videoType parametresi, video aramasını tüm videoları, yalnızca filmleri veya yalnızca program bölümlerinin döndürülmesini sağlayacak şekilde kısıtlamanıza olanak tanır.

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

• playlistItems.update yöntemi artık API isteği geçerli bir snippet belirtmezse döndürülen invalidSnippet hatası döndürüyor.

• Çeşitli API yöntemleri, 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 yayınlayan 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 İYS kullanıcısını tanımladığını belirtir. Kullanıcının kimlik doğrulaması yaptığı İYS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.

    Bu parametre, birçok farklı YouTube kanalına sahip olan ve bu kanalları yöneten içerik iş ortakları için tasarlanmıştır. Bu parametre, iş ortaklarının her kanal için kimlik doğrulama kimlik bilgilerini sağlamak zorunda kalmadan bir kez kimlik doğrulaması yapmasını ve tüm video ve kanal verilerine erişmesini 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 içerik sahibine ait ve onBehalfOfContentOwner parametresinin belirttiği tüm kanalları döndürme talimatı 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ıtlamasını söyler.

25 Şubat 2013

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

• API, video kaynakları için çeşitli yeni parçaları ve özellikleri destekler:

  • Yeni fileDetails, processingDetails ve suggestions bölümleri, video sahiplerine yükledikleri videolar hakkında bilgi sağlar. Video yükleme özelliğini etkinleştiren uygulamalarda çok faydalı olan bu veriler şunları içerir:

    • işleme durumu ve ilerleme
    • 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 parçaların tümü yalnızca videonun sahibi tarafından alınabilir. Aşağıdaki listede yeni parçalar kısaca açıklanmaktadır. video kaynak dokümanlarında ise her parçanın içerdiği tüm özellikler tanımlanmaktadır.

    • fileDetails nesnesi, YouTube'a yüklenen video dosyasıyla ilgili bilgileri içerir. Dosyanın çözünürlüğü, süresi, ses ve video codec'leri, yayın bit hızları ve daha fazlası bu bilgiler arasındadır.

    • processingProgress nesnesi, YouTube'un yüklenen video dosyasını işlemedeki ilerleme durumuyla ilgili bilgileri içerir. Nesnenin özellikleri, mevcut işleme durumunu tanımlar ve YouTube'un videoyu işlemesi için kalan süreyi tahmin eder. Bu bölümde, dosya ayrıntıları veya küçük resimler gibi farklı veri veya içerik türlerinin video için kullanılıp kullanılamayacağını da görebilirsiniz.

      Bu nesne, videoyu yükleyen kullanıcının YouTube'un yüklenen video dosyasını işlemedeki ilerleme durumunu takip edebilmesi için ankete tabi tutulacak şekilde tasarlanmıştır.

    • suggestions nesnesi, video kalitesini veya yüklenmiş videonun meta verilerini iyileştirme fırsatlarını tanımlayan öneriler içerir.

  • contentDetails kısmı dört yeni özellik içerir. Bu özellikler, kimliği doğrulanmamış isteklerle alınabilir.

    • dimension: Videonun 2D mi yoksa 3D mi olduğunu belirtir.
    • definition: Videonun standart veya yüksek çözünürlükte olup olmadığını belirtir.
    • caption: Videoda altyazı olup olmadığını belirtir.
    • licensedContent: Videoda YouTube içerik iş ortağı tarafından hak talebinde bulunulan içerik olup olmadığını belirtir.

  • status kısmı iki yeni özellik içerir. Video sahipleri, video eklerken veya güncellerken her iki mülk için de değerler belirleyebilir. Bu özellikler, kimliği doğrulanmamış istekler kullanılarak da 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'dir.

• part parametresinin tanımı, videos.list, videos.insert ve videos.update yöntemleri için güncellendi. Bu güncellemeyle, yukarıda açıklanan yeni eklenen bölümlerin yanı sıra yanlışlıkla atlanmış olan recordingDetails bölümü de listelenecek.

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

• Artık her 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 kaynaklarında döndürülüyor.

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

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

• Hata dokümanlarında, istenen işlem için isteklerin düzgün şekilde yetkilendirilmediğini belirten yeni bir forbidden hatası açıklanmaktadır.

• channel kaynağının snippet.channelId özelliği kaldırıldı. Kaynağın id mülkü aynı değeri sağlar.

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 fazla farklı API yönteminde ortaya çıkabilecek genel hatalar ve yönteme özgü hatalar yer alı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 mevcuttur:

  • 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 kaynakları artık YouTube'un otomatik olarak oluşturulmuş bir YouTube kanalına video eklemesi durumunda gerçekleşen channelItem işlemlerini bildirebilir. (YouTube, YouTube web sitesinde önemli bir yere sahip olan konuları algoritmik olarak tanımlar ve bu konular için otomatik olarak kanallar oluşturur.)

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

  • q parametresi artık filtre olarak tanımlanmıyor. Bu, ....
  • relatedToVideo parametresi relatedToVideoId olarak yeniden adlandırıldı.
  • published parametresi, aşağıda açıklanan iki yeni parametreyle (publishedAfter ve publishedBefore) değiştirildi.

• 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ürme.
  publishedAfter	datetime	Belirtilen zamandan sonra oluşturulan kaynakları döndürme.
  publishedBefore	datetime	Belirtilen zamandan önce oluşturulan kaynakları döndürme.
  regionCode	string	Belirtilen ülkeye ait kaynakları döndürme.
  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 bir oynatıcıda oynatılabilen 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 sendikasyonlu videoları almak için parametre değerini true olarak ayarlayın.

• Yeni mülkleri destekleyen çeşitli API kaynakları vardır. Aşağıdaki tabloda kaynaklar ve yeni özellikleri tanımlanmaktadı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 eklenen kaynakla ilgili 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 özellikleri gibi, kaynak türünü (ör. video veya oynatma listesi) belirten bir kind özelliği içerir. Ayrıca, kaynağı benzersiz şekilde tanımlayan kimliği belirten birkaç özellikten (videoId, playlistId vb.) tam olarak birini içerir.
  channel	status	object	Bu nesne, kanalın gizlilik durumuyla ilgili bilgileri kapsar.
  channel	status.privacyStatus	string	Kanalın gizlilik durumu. Geçerli değerler private ve public'dir.
  playlist	contentDetails	object	Bu nesne, oynatma listesinin içeriğiyle ilgili meta verileri içerir.
  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 kapsar.
  video	recordingDetails.location	object	Bu nesne, videoyla ilişkili coğrafi konum bilgilerini içerir.
  video	recordingDetails.location.latitude	double	Derece cinsinden enlem.
  video	recordingDetails.location.longitude	double	Boylam (derece cinsinden).
  video	recordingDetails.location.elevation	double	Dünya'nın üzerindeki yükseklik (metre cinsinden).
  video	recordingDetails.locationDescription	string	Videonun çekildiğ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.

• Çeşitli API yöntemlerinin 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öntemlerin yanı sıra zorunlu veya değiştirilebilir özellikler listelenmiştir.

  Not: Diğer yöntemlerin dokümanlarında zorunlu ve değiştirilebilir mülkler zaten listelenmiş 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, aynı kanalda zaten mevcut olan bir şarkı listesiyle aynı başlığa sahip bir şarkı listesi create veya güncellemeyi denediğinizde artık playlistAlreadyExists hatası bildirmiyor.

• Bazı API yöntemleri yeni hata türlerini destekler. Aşağıdaki tabloda yöntem ve yeni desteklenen hatalar tanımlanmıştır:

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